agent-skills-cli 1.0.5 → 1.0.7

package/README.md

@@ -1,11 +1,11 @@
 # Agent Skills CLI 🚀
 
-> **One CLI. 50,000+ skills. All AI agents.**
+> **One CLI. 100,000+ skills. 29 AI agents.**
 
 [![npm version](https://img.shields.io/npm/v/agent-skills-cli)](https://www.npmjs.com/package/agent-skills-cli)
 [![license](https://img.shields.io/npm/l/agent-skills-cli)](LICENSE)
 
-Install skills from the world's largest marketplace and sync them to **Cursor**, **Claude Code**, **GitHub Copilot**, **OpenAI Codex**, **Antigravity**, **OpenCode**, **Amp**, **Kilo Code**, **Roo Code**, and **Goose** — all with a single command.
+Install skills from the world's largest marketplace and sync them to **29 AI agents** including Cursor, Claude Code, GitHub Copilot, Windsurf, Cline, Gemini CLI, and more — all with a single command.
 
 🌐 **Website:** [agentskills.in](https://agentskills.in)
 
@@ -18,13 +18,14 @@ skills install @anthropic/xlsx
 
 ## ✨ Features
 
-- **50,000+ Skills** — Access the largest collection of AI agent skills
-- **10 AI Agents** — Cursor, Claude, Copilot, Codex, Antigravity, OpenCode, Amp, Kilo, Roo, Goose
+- **100,000+ Skills** — Access the largest collection of AI agent skills
+- **Interactive Search** — Search and install in one command: `skills search python`
+- **29 AI Agents** — Cursor, Claude, Copilot, Windsurf, Cline, Gemini CLI, and 23 more
 - **Global Install** — Install globally with `-g` or to project with default
-- **Git URL Support** — Install from any Git repo with `skills add owner/repo`
+- **Git URL Support** — Install from GitHub, GitLab, or local paths
 - **Platform Targeting** — Install to specific platforms with `-t claude,cursor`
-- **Auto-Detection** — Automatically detects installed AI agents
-- **Modern UI** — Beautiful prompts with @clack/prompts
+- **Update Tracking** — Check installed skills with `skills check`
+- **Privacy-First Telemetry** — Anonymous usage tracking with opt-out
 
 ---
 
@@ -59,8 +60,11 @@ skills add vercel-labs/agent-skills
 # List skills in a repo
 skills add owner/repo --list
 
-# Search the marketplace
-skills search "machine learning"
+# Search and install skills interactively
+skills search python
+
+# Search with JSON output (non-interactive)
+skills search react --json
 ```
 
 ---
@@ -73,9 +77,9 @@ skills search "machine learning"
 |---------|-------------|
 | `skills install <name>` | Install a skill from marketplace |
 | `skills add <source>` | Install from Git repo (owner/repo or URL) |
-| `skills list` | List installed skills |
-| `skills search <query>` | Search the marketplace |
-| `skills show <name>` | Show skill details |
+| `skills search <query>` | Search and install skills interactively |
+| `skills check` | Check installed skills across all agents |
+| `skills update` | Update installed skills to latest versions |
 | `skills doctor` | Diagnose issues |
 
 ### Install Options
@@ -112,20 +116,37 @@ skills info               # Show installation status
 
 ---
 
-## 🤖 Supported Platforms (10 Agents)
-
-| Platform | Project Dir | Global Dir | Flag |
-|----------|-------------|------------|------|
-| **Cursor** | `.cursor/skills/` | `~/.cursor/skills/` | `-t cursor` |
-| **Claude Code** | `.claude/skills/` | `~/.claude/skills/` | `-t claude` |
-| **GitHub Copilot** | `.github/skills/` | `~/.github/skills/` | `-t copilot` |
-| **OpenAI Codex** | `.codex/skills/` | `~/.codex/skills/` | `-t codex` |
-| **Antigravity** | `.agent/skills/` | `~/.gemini/antigravity/skills/` | `-t antigravity` |
-| **OpenCode** | `.opencode/skill/` | `~/.config/opencode/skill/` | `-t opencode` |
-| **Amp** | `.agents/skills/` | `~/.config/agents/skills/` | `-t amp` |
-| **Kilo Code** | `.kilocode/skills/` | `~/.kilocode/skills/` | `-t kilo` |
-| **Roo Code** | `.roo/skills/` | `~/.roo/skills/` | `-t roo` |
-| **Goose** | `.goose/skills/` | `~/.config/goose/skills/` | `-t goose` |
+## 🤖 Supported Platforms (29 Agents)
+
+| Platform | Project Dir | Global Dir |
+|----------|-------------|------------|
+| **Cursor** | `.cursor/skills/` | `~/.cursor/skills/` |
+| **Claude Code** | `.claude/skills/` | `~/.claude/skills/` |
+| **GitHub Copilot** | `.github/skills/` | `~/.github/skills/` |
+| **OpenAI Codex** | `.codex/skills/` | `~/.codex/skills/` |
+| **Windsurf** | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| **Cline** | `.cline/skills/` | `~/.cline/skills/` |
+| **Gemini CLI** | `.gemini/skills/` | `~/.gemini/skills/` |
+| **Antigravity** | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
+| **OpenCode** | `.opencode/skill/` | `~/.config/opencode/skill/` |
+| **Amp** | `.agents/skills/` | `~/.config/agents/skills/` |
+
+**+19 more agents:** Kilo, Roo, Goose, CodeBuddy, Continue, Crush, Clawdbot, Droid, Kiro, MCPJam, Mux, OpenHands, Pi, Qoder, Qwen Code, Trae, Zencoder, Neovate, Command Code
+
+---
+
+## 🔒 Privacy & Telemetry
+
+The CLI collects anonymous usage data to improve the product. **No personal data is collected.**
+
+```bash
+# Opt out of telemetry
+export DISABLE_TELEMETRY=1
+# or
+export DO_NOT_TRACK=1
+```
+
+Telemetry is automatically disabled in CI environments.
 
 ---
 

package/dist/cli/index.js

@@ -8,7 +8,9 @@ import chalk from 'chalk';
 import inquirer from 'inquirer';
 import ora from 'ora';
 import * as p from '@clack/prompts';
-import { discoverSkills, loadSkill, validateMetadata, validateBody, formatValidationResult, generateSkillsPromptXML, generateFullSkillsContext, listSkillResources, listMarketplaceSkills, installSkill, uninstallSkill, searchSkills, getInstalledSkills, listMarketplaces, addMarketplace, checkUpdates, installFromGitHubUrl, getSkillByScoped, getSkillBaseUrl, fetchAssetManifest, getAssetUrl, fetchAsset, fetchSkillsForCLI } from '../core/index.js';
+import { discoverSkills, loadSkill, validateMetadata, validateBody, formatValidationResult, generateSkillsPromptXML, generateFullSkillsContext, listSkillResources, listMarketplaceSkills, installSkill, uninstallSkill, searchSkills, getInstalledSkills, listMarketplaces, addMarketplace, checkUpdates, installFromGitHubUrl, getSkillByScoped, getSkillBaseUrl, fetchAssetManifest, getAssetUrl, fetchAsset, fetchSkillsForCLI, 
+// Telemetry
+setVersion, trackSearch } from '../core/index.js';
 import { homedir } from 'os';
 // Centralized agent configuration with project and global paths
 const home = homedir();
@@ -74,6 +76,121 @@ const AGENTS = {
         projectDir: '.goose/skills',
         globalDir: `${home}/.config/goose/skills`,
     },
+    // New agents from vercel-labs/skills (19 additional)
+    'cline': {
+        name: 'cline',
+        displayName: 'Cline',
+        projectDir: '.cline/skills',
+        globalDir: `${home}/.cline/skills`,
+    },
+    'codebuddy': {
+        name: 'codebuddy',
+        displayName: 'CodeBuddy',
+        projectDir: '.codebuddy/skills',
+        globalDir: `${home}/.codebuddy/skills`,
+    },
+    'command-code': {
+        name: 'command-code',
+        displayName: 'Command Code',
+        projectDir: '.commandcode/skills',
+        globalDir: `${home}/.commandcode/skills`,
+    },
+    'continue': {
+        name: 'continue',
+        displayName: 'Continue',
+        projectDir: '.continue/skills',
+        globalDir: `${home}/.continue/skills`,
+    },
+    'crush': {
+        name: 'crush',
+        displayName: 'Crush',
+        projectDir: '.crush/skills',
+        globalDir: `${home}/.config/crush/skills`,
+    },
+    'clawdbot': {
+        name: 'clawdbot',
+        displayName: 'Clawdbot',
+        projectDir: 'skills',
+        globalDir: `${home}/.clawdbot/skills`,
+    },
+    'droid': {
+        name: 'droid',
+        displayName: 'Droid',
+        projectDir: '.factory/skills',
+        globalDir: `${home}/.factory/skills`,
+    },
+    'gemini-cli': {
+        name: 'gemini-cli',
+        displayName: 'Gemini CLI',
+        projectDir: '.gemini/skills',
+        globalDir: `${home}/.gemini/skills`,
+    },
+    'kiro-cli': {
+        name: 'kiro-cli',
+        displayName: 'Kiro CLI',
+        projectDir: '.kiro/skills',
+        globalDir: `${home}/.kiro/skills`,
+    },
+    'mcpjam': {
+        name: 'mcpjam',
+        displayName: 'MCPJam',
+        projectDir: '.mcpjam/skills',
+        globalDir: `${home}/.mcpjam/skills`,
+    },
+    'mux': {
+        name: 'mux',
+        displayName: 'Mux',
+        projectDir: '.mux/skills',
+        globalDir: `${home}/.mux/skills`,
+    },
+    'openhands': {
+        name: 'openhands',
+        displayName: 'OpenHands',
+        projectDir: '.openhands/skills',
+        globalDir: `${home}/.openhands/skills`,
+    },
+    'pi': {
+        name: 'pi',
+        displayName: 'Pi',
+        projectDir: '.pi/skills',
+        globalDir: `${home}/.pi/agent/skills`,
+    },
+    'qoder': {
+        name: 'qoder',
+        displayName: 'Qoder',
+        projectDir: '.qoder/skills',
+        globalDir: `${home}/.qoder/skills`,
+    },
+    'qwen-code': {
+        name: 'qwen-code',
+        displayName: 'Qwen Code',
+        projectDir: '.qwen/skills',
+        globalDir: `${home}/.qwen/skills`,
+    },
+    'trae': {
+        name: 'trae',
+        displayName: 'Trae',
+        projectDir: '.trae/skills',
+        globalDir: `${home}/.trae/skills`,
+    },
+    'windsurf': {
+        name: 'windsurf',
+        displayName: 'Windsurf',
+        projectDir: '.windsurf/skills',
+        globalDir: `${home}/.codeium/windsurf/skills`,
+    },
+    'zencoder': {
+        name: 'zencoder',
+        displayName: 'Zencoder',
+        projectDir: '.zencoder/skills',
+        globalDir: `${home}/.zencoder/skills`,
+    },
+    'neovate': {
+        name: 'neovate',
+        displayName: 'Neovate',
+        projectDir: '.neovate/skills',
+        globalDir: `${home}/.neovate/skills`,
+    },
 };
 // Helper to get install path
 function getInstallPath(agent, global) {
@@ -83,6 +200,8 @@ function getInstallPath(agent, global) {
     return global ? config.globalDir : config.projectDir;
 }
 const program = new Command();
+// Initialize telemetry with CLI version
+setVersion('1.0.23');
 // Main flow when running `skills` - go straight to install
 async function showMainMenu() {
     console.log('');
@@ -827,6 +946,177 @@ program
         process.exit(1);
     }
 });
+// ============================================
+// SEARCH COMMAND - Main user-facing search
+// ============================================
+program
+    .command('search <query...>')
+    .alias('s')
+    .description('Search and install skills from marketplace (67K+ skills)')
+    .option('-l, --limit <n>', 'Maximum results to show', '20')
+    .option('-s, --sort <by>', 'Sort by: stars, recent, name', 'stars')
+    .option('--json', 'Output as JSON for scripting (no interactive prompt)')
+    .action(async (queryParts, options) => {
+    try {
+        const query = queryParts.join(' ');
+        const limit = parseInt(options.limit) || 20;
+        if (!options.json) {
+            console.log(chalk.bold(`\n🔍 Searching for "${query}"...\n`));
+        }
+        // Fetch results from database
+        let result;
+        try {
+            result = await fetchSkillsForCLI({
+                search: query,
+                limit,
+                sortBy: options.sort
+            });
+        }
+        catch {
+            // Fallback to GitHub sources
+            if (!options.json) {
+                console.log(chalk.gray('Falling back to GitHub sources...'));
+            }
+            const skills = await searchSkills(query);
+            result = { skills: skills.slice(0, limit), total: skills.length };
+        }
+        // Track search telemetry
+        trackSearch(query, result.total);
+        if (result.skills.length === 0) {
+            if (options.json) {
+                console.log(JSON.stringify({ skills: [], total: 0, query }));
+            }
+            else {
+                console.log(chalk.yellow(`No skills found matching "${query}"`));
+            }
+            return;
+        }
+        // JSON output (non-interactive)
+        if (options.json) {
+            console.log(JSON.stringify({
+                skills: result.skills.map(s => ({
+                    name: s.name,
+                    author: s.author,
+                    scopedName: s.scopedName || `${s.author}/${s.name}`,
+                    description: s.description,
+                    stars: s.stars || 0,
+                    githubUrl: s.githubUrl
+                })),
+                total: result.total,
+                query
+            }, null, 2));
+            return;
+        }
+        // Display results summary
+        console.log(chalk.gray(`Found ${result.total.toLocaleString()} skills. Select to install:\n`));
+        // Interactive install - always show selection prompt
+        const choices = result.skills.map((skill) => ({
+            name: `${skill.name} ${skill.stars ? chalk.yellow(`⭐${skill.stars.toLocaleString()}`) : ''} ${chalk.dim(`@${skill.author || 'unknown'}`)}`,
+            value: {
+                name: skill.name,
+                scopedName: skill.scopedName || `${skill.author}/${skill.name}`,
+                githubUrl: skill.githubUrl || ''
+            },
+            short: skill.name
+        }));
+        const { selectedSkills } = await inquirer.prompt([
+            {
+                type: 'checkbox',
+                name: 'selectedSkills',
+                message: 'Select skills (Space to select, Enter to confirm):',
+                choices,
+                pageSize: 15,
+                loop: false
+            }
+        ]);
+        if (selectedSkills.length === 0) {
+            console.log(chalk.yellow('\nNo skills selected.\n'));
+            return;
+        }
+        // Select platforms
+        const agentChoices = Object.entries(AGENTS).map(([key, config]) => ({
+            name: config.displayName,
+            value: key,
+            checked: ['cursor', 'claude', 'copilot', 'antigravity'].includes(key)
+        }));
+        const { platforms } = await inquirer.prompt([
+            {
+                type: 'checkbox',
+                name: 'platforms',
+                message: 'Install to which platforms?',
+                choices: agentChoices,
+                pageSize: 10
+            }
+        ]);
+        if (platforms.length === 0) {
+            console.log(chalk.yellow('\nNo platforms selected.\n'));
+            return;
+        }
+        // Install skills
+        const { mkdir, cp, rm } = await import('fs/promises');
+        const { join } = await import('path');
+        const { tmpdir } = await import('os');
+        const { exec } = await import('child_process');
+        const { promisify } = await import('util');
+        const execAsync = promisify(exec);
+        console.log(chalk.bold(`\n📦 Installing ${selectedSkills.length} skill(s)...\n`));
+        for (const skill of selectedSkills) {
+            const installSpinner = ora(`Installing ${skill.name}...`).start();
+            try {
+                // Fetch skill details
+                const { getSkillByScoped } = await import('../core/skillsdb.js');
+                const dbSkill = await getSkillByScoped(skill.scopedName);
+                if (!dbSkill) {
+                    installSpinner.fail(`${skill.name}: Not found`);
+                    continue;
+                }
+                const githubUrl = dbSkill.github_url || dbSkill.githubUrl;
+                if (!githubUrl) {
+                    installSpinner.fail(`${skill.name}: No GitHub URL`);
+                    continue;
+                }
+                // Parse GitHub URL
+                const urlMatch = githubUrl.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+                if (!urlMatch) {
+                    installSpinner.fail(`${skill.name}: Invalid GitHub URL`);
+                    continue;
+                }
+                const [, owner, repo] = urlMatch;
+                const branch = dbSkill.branch || 'main';
+                const skillPath = (dbSkill.path || '').replace(/\/SKILL\.md$/i, '');
+                // Clone to temp
+                const tempDir = join(tmpdir(), `skill-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+                await mkdir(tempDir, { recursive: true });
+                try {
+                    await execAsync(`git clone --depth 1 --branch ${branch} https://github.com/${owner}/${repo}.git .`, { cwd: tempDir });
+                    // Copy to each platform
+                    for (const platform of platforms) {
+                        const agentConfig = AGENTS[platform];
+                        if (!agentConfig)
+                            continue;
+                        const targetDir = agentConfig.projectDir;
+                        const skillDir = join(process.cwd(), targetDir, dbSkill.name);
+                        await mkdir(skillDir, { recursive: true });
+                        const sourceDir = skillPath ? join(tempDir, skillPath) : tempDir;
+                        await cp(sourceDir, skillDir, { recursive: true });
+                    }
+                    installSpinner.succeed(`${skill.name} → ${platforms.join(', ')}`);
+                }
+                finally {
+                    await rm(tempDir, { recursive: true, force: true }).catch(() => { });
+                }
+            }
+            catch (err) {
+                installSpinner.fail(`${skill.name}: ${err.message || err}`);
+            }
+        }
+        console.log(chalk.bold.green(`\n✨ Installation complete!\n`));
+    }
+    catch (error) {
+        console.error(chalk.red('Error searching:'), error);
+        process.exit(1);
+    }
+});
 // Install - Install a skill by scoped name (e.g., @author/skill or author/skill)
 program
     .command('install <scoped-name> [platforms...]')
@@ -2333,5 +2623,71 @@ program
         process.exit(1);
     }
 });
+// ============================================
+// CHECK COMMAND - Check for skill updates
+// ============================================
+program
+    .command('check')
+    .description('Check for available skill updates')
+    .option('-a, --agent <agent>', 'Check specific agent only')
+    .option('-g, --global', 'Check globally installed skills')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const spinner = ora('Checking for updates...').start();
+        // Get list of agents to check
+        const agentsToCheck = options.agent
+            ? [options.agent]
+            : Object.keys(AGENTS);
+        const updates = [];
+        for (const agentName of agentsToCheck) {
+            const config = AGENTS[agentName];
+            if (!config)
+                continue;
+            const skillsDir = options.global ? config.globalDir : config.projectDir;
+            try {
+                const { existsSync, readdirSync } = await import('fs');
+                if (!existsSync(skillsDir))
+                    continue;
+                const skills = readdirSync(skillsDir, { withFileTypes: true })
+                    .filter(d => d.isDirectory())
+                    .map(d => d.name);
+                for (const skill of skills) {
+                    // Check if skill has updates available
+                    // For now, just list installed skills
+                    updates.push({
+                        skill,
+                        agent: config.displayName,
+                        currentVersion: 'installed',
+                        latestVersion: 'check online',
+                        path: `${skillsDir}/${skill}`,
+                    });
+                }
+            }
+            catch {
+                // Skip if can't read directory
+            }
+        }
+        spinner.stop();
+        if (options.json) {
+            console.log(JSON.stringify({ updates, count: updates.length }, null, 2));
+            return;
+        }
+        if (updates.length === 0) {
+            console.log(chalk.green('✓ No skills installed to check.'));
+            return;
+        }
+        console.log(chalk.bold(`\n📦 Found ${updates.length} installed skill(s):\n`));
+        for (const update of updates) {
+            console.log(`  ${chalk.cyan(update.skill)} ${chalk.gray(`(${update.agent})`)}`);
+            console.log(chalk.gray(`    ${update.path}`));
+        }
+        console.log(chalk.gray('\nTip: Run `skills update` to update all skills.\n'));
+    }
+    catch (error) {
+        console.error(chalk.red('Error checking for updates:'), error);
+        process.exit(1);
+    }
+});
 program.parse();
 //# sourceMappingURL=index.js.map