RSS
Applications defined as Markdown specifications, executed by agentic coding harnesses. No compiled binary. Text is the code.
npx -y skills add IamCatoBot/text-is-code --skill RSSAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
An RSS client that executes commands using Markdown-defined state/action rules.
SKILL.md
3.0 KB, as published. Nobody here has run it
RSS Skill
Overview
Use this package to execute rss operations through markdown-defined parsing and state transitions. The command language is CLI-like, but execution is happening exclusively through markdown-native primitives (store/network/output actions).
Preserve defined behavior in strict mode, including:
- command tree and aliases
- flag and positional parsing rules
- env/config/flag precedence
- side effects (filesystem/network/env)
- output contracts and exit codes
Trigger
Run this skill when the user asks to read or manage RSS feeds and provide a command string, for example:
--json feed lsread --limit 20 --unreadexport json --output out.json
The provided command string is parsed as CLI-like syntax. It is an input contract, not a shell command to execute directly. The runtime will interpret it according to the defined grammar and execute the corresponding actions.
Alternatively the command can be provided as natural language text, for example:
- "Show me my unread feeds."
- "Add this RSS feed: <url> with the name 'Tech News'."
- "Export all my feeds to a JSON file named 'feeds.json'." in which case the runtime will attempt to parse it into a valid command.
The runtime must:
- Parse using
RUNTIME/COMMAND_GRAMMAR.md. - Execute transitions in
RUNTIME/STATE_MACHINE.md. - Execute primitive actions from
RUNTIME/EXECUTION_PRIMITIVES.md. - Maintain runtime data in
RUNTIME/RUNTIME_CONTEXT.md. - Emit errors from
RUNTIME/ERRORS.mdand exit viaRUNTIME/EXIT_CODES.md.
First-run behavior: missing config and missing store are valid. The runtime must continue with defaults, bootstrap the store path, and initialize empty store state.
When is_first_run=true, the runtime should offer optional onboarding. If the user accepts, guide these 3 starter commands in order:
config showfeed add <url> [-n name]read --unread --limit 20
Execution Workflow
- Normalize aliases and parse argv.
- Resolve effective configuration and environment values.
- Dispatch to the canonical command family.
- Execute primitive actions and record side effects.
- Format output according to output-mode precedence.
- Exit with mapped code.
Hard Rules
- Preserve command semantics from the baseline behavior (
strictmode). - Do not silently skip failure branches.
- Log every mutating side effect in
side_effect_log. - Treat missing dependencies (network, local analysis capability, permissions) as guarded failure transitions.
- Do not claim behavior not covered in the documented runtime contracts and examples.
- Do not invoke another RSS command binary to execute RSS commands.
- Do not use "wrap original binary" fallback for in-scope commands.
- If a primitive dependency is unavailable, transition to explicit failure state (
manual handoffonly for out-of-scope conditions).