rss-skill-cli 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# @rss-skill/cli
+
+RSS skill pack for AI coding assistants (Claude Code, Cursor, Cline, etc.)
+
+## Installation
+
+```bash
+npm install -g @rss-skill/cli
+```
+
+## Usage
+
+Initialize skills in your project directory:
+
+```bash
+# Interactive selection
+rss-skill init
+
+# Specify vendor directly
+rss-skill init --vendor claude-code
+rss-skill init --vendor cursor
+rss-skill init --vendor cline
+rss-skill init --vendor kimi-cli
+rss-skill init --vendor generic
+```
+
+This will create a `.claude/skills/` directory (or `.cursor/skills/`, etc. depending on vendor) with:
+
+- `rss-find/SKILL.md` + `scripts/rss-find.exe` - Search RSSHub routes
+- `rss-feed/SKILL.md` + `scripts/rss-feed.exe` - Manage RSS subscriptions  
+- `rss-gh/SKILL.md` + `scripts/rss-gh.exe` - Generate GitHub RSS feeds
+
+## Supported Vendors
+
+| Vendor | Directory |
+|--------|-----------|
+| claude-code | `.claude/` |
+| kimi-cli | `.kimi/` |
+| cursor | `.cursor/` |
+| cline | `.cline/` |
+| generic | `.skills/` |
+
+## License
+
+MIT

package/bin/rss-skill.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const init = require('../src/init');
+const path = require('path');
+
+const pkg = require('../package.json');
+
+program
+  .name('rss-skill')
+  .description('RSS skill pack for AI coding assistants')
+  .version(pkg.version);
+
+program
+  .command('init')
+  .description('Initialize skill files in current directory')
+  .option('-v, --vendor <vendor>', 'Vendor to use (claude-code, kimi-cli, cursor, cline, generic)')
+  .action(async (options) => {
+    await init(options.vendor);
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "rss-skill-cli",
+  "version": "0.1.0",
+  "description": "RSS skill pack for AI coding assistants (Claude Code, Cursor, Cline, etc.)",
+  "keywords": [
+    "rss",
+    "claude",
+    "claude-code",
+    "cursor",
+    "cline",
+    "ai",
+    "llm",
+    "skills"
+  ],
+  "author": "rss-skill",
+  "license": "MIT",
+  "bin": {
+    "rss-skill": "./bin/rss-skill.js"
+  },
+  "main": "./src/index.js",
+  "files": [
+    "bin",
+    "src",
+    "binaries"
+  ],
+  "scripts": {
+    "test": "node bin/rss-skill.js --help"
+  },
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rss-skill/rss-skill"
+  },
+  "bugs": {
+    "url": "https://github.com/rss-skill/rss-skill/issues"
+  },
+  "homepage": "https://github.com/rss-skill/rss-skill#readme"
+}

package/src/index.js

@@ -0,0 +1,7 @@
+const init = require('./init');
+const templates = require('./templates');
+
+module.exports = {
+  init,
+  templates
+};

package/src/init.js

@@ -0,0 +1,173 @@
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const templates = require('./templates');
+
+// Vendor directory mapping
+const vendorDirs = {
+  'claude': '.claude',
+  'claude-code': '.claude',
+  'kimi-cli': '.kimi',
+  'cursor': '.cursor',
+  'cline': '.cline',
+  'generic': '.skills'
+};
+
+const vendors = ['claude-code', 'kimi-cli', 'cursor', 'cline', 'generic'];
+
+// Tool descriptions
+const toolDescriptions = {
+  'rss-find': 'Search RSS sources from RSSHub',
+  'rss-feed': 'Manage RSS subscriptions',
+  'rss-gh': 'Generate GitHub RSS feeds'
+};
+
+/**
+ * Get binary filename based on platform
+ */
+function getBinaryName(tool) {
+  return process.platform === 'win32' ? `${tool}.exe` : tool;
+}
+
+/**
+ * Get binaries directory based on platform
+ */
+function getBinariesDir() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  // Map platform/arch to directory name
+  const platformMap = {
+    'win32': 'win',
+    'darwin': 'darwin',
+    'linux': 'linux'
+  };
+
+  const archMap = {
+    'x64': 'x64',
+    'arm64': 'arm64'
+  };
+
+  const platformName = platformMap[platform] || platform;
+  const archName = archMap[arch] || arch;
+
+  return path.join(__dirname, '..', 'binaries', `${platformName}-${archName}`);
+}
+
+/**
+ * Prompt user to select a vendor
+ */
+async function selectVendor() {
+  return new Promise((resolve, reject) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    console.log('\nSelect your AI coding tool:\n');
+    vendors.forEach((v, i) => {
+      console.log(`  ${i + 1}. ${v}`);
+    });
+    console.log('');
+
+    rl.question('Enter number (1-5): ', (answer) => {
+      rl.close();
+      const num = parseInt(answer);
+      if (num >= 1 && num <= vendors.length) {
+        resolve(vendors[num - 1]);
+      } else {
+        reject(new Error('Invalid selection'));
+      }
+    });
+  });
+}
+
+/**
+ * Get vendor directory
+ */
+function getVendorDir(vendor) {
+  const dir = vendorDirs[vendor];
+  if (!dir) {
+    throw new Error(`Unknown vendor: ${vendor}`);
+  }
+  return path.join(process.cwd(), dir);
+}
+
+/**
+ * Initialize skills for a vendor
+ */
+async function init(vendor) {
+  // If no vendor specified, prompt for selection
+  if (!vendor) {
+    try {
+      vendor = await selectVendor();
+    } catch (err) {
+      console.error('\x1b[31m✗\x1b[0m No vendor selected');
+      process.exit(1);
+    }
+  }
+
+  // Validate vendor
+  if (!vendorDirs[vendor]) {
+    console.error(`\x1b[31m✗\x1b[0m Unknown vendor: ${vendor}`);
+    console.error(`  Supported: ${Object.keys(vendorDirs).join(', ')}`);
+    process.exit(1);
+  }
+
+  const vendorDir = getVendorDir(vendor);
+  const skillDir = path.join(vendorDir, 'skills');
+
+  // Create skills directory
+  fs.mkdirSync(skillDir, { recursive: true });
+
+  const tools = ['rss-find', 'rss-feed', 'rss-gh'];
+  const binariesDir = getBinariesDir();
+
+  // Check if binaries exist
+  if (!fs.existsSync(binariesDir)) {
+    console.error(`\x1b[31m✗\x1b[0m Binaries not found for platform: ${binariesDir}`);
+    process.exit(1);
+  }
+
+  for (const tool of tools) {
+    const toolDir = path.join(skillDir, tool);
+    fs.mkdirSync(toolDir, { recursive: true });
+
+    // Create SKILL.md
+    const skillContent = templates[tool];
+    fs.writeFileSync(path.join(toolDir, 'SKILL.md'), skillContent);
+
+    // Create scripts directory
+    const scriptsDir = path.join(toolDir, 'scripts');
+    fs.mkdirSync(scriptsDir, { recursive: true });
+
+    // Copy binary to scripts directory
+    const binaryName = getBinaryName(tool);
+    const srcBinary = path.join(binariesDir, binaryName);
+    const destBinary = path.join(scriptsDir, binaryName);
+
+    if (fs.existsSync(srcBinary)) {
+      fs.copyFileSync(srcBinary, destBinary);
+      // Set executable permission (not needed on Windows, but doesn't hurt)
+      try {
+        fs.chmodSync(destBinary, 0o755);
+      } catch (e) {
+        // Ignore chmod errors on Windows
+      }
+    } else {
+      console.error(`\x1b[33m⚠\x1b[0m Binary not found: ${binaryName}`);
+    }
+  }
+
+  console.log(`\x1b[32m✓\x1b[0m Initialized skills for \x1b[36m${vendor}\x1b[0m in ${skillDir}`);
+  console.log('\nGenerated skills:');
+  tools.forEach(tool => {
+    console.log(`  - ${tool}: ${toolDescriptions[tool]}`);
+  });
+
+  if (process.platform !== 'win32') {
+    console.log('\nNote: Make sure the tools in scripts/ have execute permission.');
+  }
+}
+
+module.exports = init;

package/src/templates.js

@@ -0,0 +1,220 @@
+const templates = {
+  'rss-find': `---
+name: rss-find
+description: Search and discover RSS sources from RSSHub's extensive route collection. Use when looking for RSS feeds, subscribing to content sources, or when user mentions RSSHub, feeds, or content aggregation.
+license: MIT
+compatibility: Requires internet access to RSSHub
+---
+
+# rss-find
+
+Search and discover RSS sources from RSSHub's extensive route collection.
+
+## Available scripts
+
+- **\`scripts/rss-find\`** — Self-contained binary for searching RSS sources
+
+## Commands
+
+### search
+Search RSS sources by keyword.
+
+\`\`\`bash
+scripts/rss-find search "bilibili"
+\`\`\`
+
+### info
+Get detailed information about a specific route.
+
+\`\`\`bash
+scripts/rss-find info /bilibili/user/dynamic
+\`\`\`
+
+### sync
+Sync RSSHub routes manually to get latest available sources.
+
+\`\`\`bash
+scripts/rss-find sync
+\`\`\`
+
+## Workflow
+
+1. Search for feeds:
+\`\`\`bash
+   scripts/rss-find search "youtube"
+\`\`\`
+
+2. Get route details:
+\`\`\`bash
+   scripts/rss-find info /youtube/channel/UCxxxx
+\`\`\`
+
+3. Use the RSS URL with rss-feed to subscribe.
+`,
+
+  'rss-feed': `---
+name: rss-feed
+description: Manage RSS subscriptions and articles for AI agent workflows. Subscribe to feeds, list unread articles with filters, and mark articles as read. Use when managing RSS subscriptions or processing feed content.
+license: MIT
+---
+
+# rss-feed
+
+Manage RSS subscriptions and articles. Designed for AI agent workflows.
+
+## Available scripts
+
+- **\`scripts/rss-feed\`** — Self-contained binary for managing RSS feeds
+
+## Commands
+
+### add
+Add a new RSS feed subscription.
+
+\`\`\`bash
+scripts/rss-feed add <url> --name "My Feed" --category tech
+\`\`\`
+
+### feeds
+List all feed subscriptions (JSON output).
+
+\`\`\`bash
+scripts/rss-feed feeds
+\`\`\`
+
+### list
+List articles with filters (JSON output).
+
+\`\`\`bash
+scripts/rss-feed list --unread --today
+scripts/rss-feed list --category tech
+\`\`\`
+
+### mark-read
+Mark articles as read.
+
+\`\`\`bash
+scripts/rss-feed mark-read --all
+scripts/rss-feed mark-read --feed <feed-id>
+\`\`\`
+
+### sync
+Sync feed content.
+
+\`\`\`bash
+scripts/rss-feed sync
+scripts/rss-feed sync -n "Feed Name"
+\`\`\`
+
+### up
+Start sync daemon for automatic feed updates.
+
+\`\`\`bash
+scripts/rss-feed up -d
+\`\`\`
+
+### down
+Stop sync daemon.
+
+\`\`\`bash
+scripts/rss-feed down
+\`\`\`
+
+### status
+Check daemon status.
+
+\`\`\`bash
+scripts/rss-feed status
+\`\`\`
+
+## Agent Workflow
+
+1. Get unread articles (structured JSON output):
+\`\`\`bash
+   scripts/rss-feed list --unread --today
+\`\`\`
+
+2. Process content with AI
+
+3. Mark as read:
+\`\`\`bash
+   scripts/rss-feed mark-read --all
+\`\`\`
+
+## Daemon Mode
+
+Configure automatic sync in feeds.yaml:
+\`\`\`yaml
+sync:
+  enabled: true
+  interval: "30m"
+  jitter: 0
+  on_startup: true
+  concurrency: 5  # Number of parallel fetchers
+\`\`\`
+
+Start background daemon:
+\`\`\`bash
+scripts/rss-feed up -d
+\`\`\`
+`,
+
+  'rss-gh': `---
+name: rss-gh
+description: Generate RSS feeds for GitHub repositories including releases and commits. Search repositories and subscribe to their activity feeds. Use when tracking GitHub project updates or releases.
+license: MIT
+compatibility: Requires internet access to GitHub API
+---
+
+# rss-gh
+
+Generate RSS feeds for GitHub repositories (releases, commits).
+
+## Available scripts
+
+- **\`scripts/rss-gh\`** — Self-contained binary for GitHub RSS generation
+
+## Commands
+
+### search
+Search GitHub repositories (JSON output).
+
+\`\`\`bash
+scripts/rss-gh search "golang rss"
+\`\`\`
+
+### rss
+Generate RSS URL for a repository.
+
+\`\`\`bash
+scripts/rss-gh rss owner/repo --releases
+scripts/rss-gh rss owner/repo --commits
+\`\`\`
+
+### subscribe
+Subscribe to repository RSS feed directly.
+
+\`\`\`bash
+scripts/rss-gh subscribe owner/repo --releases
+\`\`\`
+
+## Workflow
+
+1. Search for a project:
+\`\`\`bash
+   scripts/rss-gh search "react"
+\`\`\`
+
+2. Get the RSS URL:
+\`\`\`bash
+   scripts/rss-gh rss facebook/react --releases
+\`\`\`
+
+3. Subscribe using rss-feed:
+\`\`\`bash
+   scripts/rss-feed add <rss-url> --name "React Releases"
+\`\`\`
+`
+};
+
+module.exports = templates;