rss-skill-cli 0.1.3 → 0.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rss-skill-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "RSS skill pack for AI coding assistants (Claude Code, Cursor, Cline, etc.)",
   "keywords": [
     "rss",

package/src/templates.js

@@ -56,11 +56,13 @@ scripts/rss-find sync
 name: rss-feed
 description: Manage RSS subscriptions and articles for AI agent workflows. Subscribe to feeds, list unread articles, and read/archive content. Use when managing RSS subscriptions or processing feed content.
 license: MIT
+storage: filesystem (YAML + markdown, no database required)
 ---
 
 # rss-feed
 
 Manage RSS subscriptions and articles. Designed for AI agent workflows.
+All data is stored in the filesystem: \`feeds.yaml\` for configuration, markdown files for articles.
 
 ## Available scripts
 
@@ -68,13 +70,22 @@ Manage RSS subscriptions and articles. Designed for AI agent workflows.
 
 ## Commands
 
-### init
-Initialize feeds.yaml with default configuration.
+### init (REQUIRED FIRST)
+Initialize feeds.yaml with sync configuration. **MUST specify --interval and --concurrency**.
 
 \`\`\`bash
 scripts/rss-feed init --interval 30m --concurrency 5
+scripts/rss-feed init --interval 1h --concurrency 10 --on-startup=true
 \`\`\`
 
+**Required flags:**
+- \`--interval\`: Sync interval (e.g., '15m', '30m', '1h', '2h30m')
+- \`--concurrency\`: Number of parallel feed fetchers (1-20)
+
+**Optional flags:**
+- \`--on-startup\`: Sync feeds when daemon starts (default: true)
+- \`--jitter\`: Random delay in seconds to avoid thundering herd (default: 0)
+
 ### add
 Add a new RSS feed subscription.
 
@@ -157,26 +168,46 @@ Show content storage paths.
 scripts/rss-feed path
 \`\`\`
 
-## Agent Workflow
+## Initial Setup Workflow
+
+**When first using rss-feed, follow this workflow:**
+
+1. **Check if already initialized:**
+\`\`\`bash
+scripts/rss-feed status
+\`\`\`
+
+2. **If not initialized (status shows error or no feeds.yaml):**
+\`\`\`bash
+scripts/rss-feed init --interval 30m --concurrency 5
+\`\`\`
+
+3. **Add feeds and sync:**
+\`\`\`bash
+scripts/rss-feed add "Feed Name" "https://example.com/rss.xml" --category news
+scripts/rss-feed sync
+\`\`\`
+
+## Daily Usage Workflow
 
-1. Get unread articles:
+1. **Check for unread articles:**
 \`\`\`bash
-   scripts/rss-feed articles
+scripts/rss-feed articles
 \`\`\`
 
-2. Read an article:
+2. **Read an article:**
 \`\`\`bash
-   scripts/rss-feed read 1
+scripts/rss-feed read 1
 \`\`\`
 
-3. Archive when done:
+3. **Archive when done:**
 \`\`\`bash
-   scripts/rss-feed archive --all
+scripts/rss-feed archive --all
 \`\`\`
 
 ## Daemon Mode
 
-Configure automatic sync in feeds.yaml:
+Configure automatic sync in feeds.yaml (created by init):
 \`\`\`yaml
 sync:
   enabled: true
@@ -190,6 +221,15 @@ Start background daemon:
 \`\`\`bash
 scripts/rss-feed up -d
 \`\`\`
+
+## Storage
+
+All data is stored in the filesystem:
+- \`~/.rss-skill/feeds.yaml\` - Feed subscriptions and sync config
+- \`~/.rss-skill/content/<category>/<feed>/<article>.md\` - Article content
+- \`~/.rss-skill/archive/<category>/<feed>/<article>.md\` - Archived articles
+
+No database required - simple markdown files for portability.
 `,
 
   'rss-gh': `---