openskills-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenSkills
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# openskills-mcp
+
+Discover and install AI agent skills via the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+OpenSkills indexes skills from trusted GitHub repositories and makes them searchable through MCP tools. This package connects your AI agent to the hosted OpenSkills server.
+
+## Quick Start
+
+```bash
+npx openskills-mcp --api-key osk_your_key_here
+```
+
+Get your API key at [openskills.dev/dashboard](https://openskills.dev/dashboard).
+
+## MCP Configuration
+
+### Claude Desktop / Claude Code
+
+Add to your `claude_desktop_config.json` or `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "openskills": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "openskills-mcp",
+        "--api-key",
+        "osk_your_key_here"
+      ]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to your MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "openskills": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "openskills-mcp",
+        "--api-key",
+        "osk_your_key_here"
+      ]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### search_skills
+
+Search for skills using natural language.
+
+```
+search_skills("process PDF files", max_results=5, verified_only=true)
+```
+
+Returns skill metadata: name, description, tags, stars, verified status, relevance score.
+
+### get_skill
+
+Get installation command for a skill.
+
+```
+get_skill(skill="pdf-processing", agent="claude-code", global_install=false)
+```
+
+Returns a simple installation command:
+```bash
+npx openskills pdf-processing -a claude-code
+```
+
+The openskills CLI handles downloading, extracting, and symlinking automatically.
+
+## How It Works
+
+This package runs a local MCP server (stdio transport) that proxies requests to the hosted OpenSkills server (HTTP transport) with your API key for authentication.
+
+```
+Your AI Agent <--stdio--> openskills-mcp <--HTTP--> OpenSkills Server
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- An OpenSkills API key
+
+## License
+
+MIT

package/dist/bin/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * OpenSkills CLI - Main entry point
+ *
+ * Dual-mode CLI:
+ * 1. Installation mode: npx openskills <skill> [options]
+ * 2. MCP proxy mode: npx openskills --api-key <key>
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}

package/dist/bin/cli.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * OpenSkills CLI - Main entry point
+ *
+ * Dual-mode CLI:
+ * 1. Installation mode: npx openskills <skill> [options]
+ * 2. MCP proxy mode: npx openskills --api-key <key>
+ */
+import { detectMode, parseInstallOptions, parseApiKey } from '../src/utils/mode-detector.js';
+import { install } from '../src/modes/install.js';
+import { userError, ExitCode } from '../src/utils/errors.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+// Get package.json for version
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../..', 'package.json'), 'utf-8'));
+const args = process.argv.slice(2);
+const mode = detectMode(args);
+/**
+ * Show help message.
+ */
+function showHelp() {
+    console.log(`
+OpenSkills CLI v${packageJson.version}
+
+Install AI agent skills locally or discover via MCP protocol.
+
+INSTALLATION MODE:
+  npx openskills <skill> [options]
+
+  Positional:
+    <skill>               Skill identifier (e.g., pdf-processing)
+
+  Options:
+    -a, --agent <name>    Agent name (e.g., claude-code, cursor)
+    -g, --global          Install globally to ~/.agents/skills/
+    -p, --project         Install to project ./agents/skills/ (default if no flag)
+    -y                    Install for multiple agents (claude-code, codex, cursor, gemini-cli, qwen-code)
+    --force               Overwrite existing installation
+
+  Examples:
+    npx openskills pdf-processing -a claude-code -g
+    npx openskills pdf-processing -a claude-code -p
+    npx openskills pdf-processing -y
+    npx openskills pdf-processing
+      (Interactive: prompts for agent and scope)
+
+  Legacy syntax (still supported):
+    npx openskills -s pdf-processing -a claude-code
+
+MCP PROXY MODE:
+  npx openskills --api-key <key>
+
+  Required:
+    --api-key <key>       OpenSkills API key (format: osk_...)
+
+  Environment:
+    OPENSKILLS_BACKEND_URL    Backend server URL (default: https://openskills-mcp.hf.space)
+
+  Example:
+    npx openskills --api-key osk_abc123def456
+
+OTHER:
+  -h, --help            Show this help message
+  -v, --version         Show version number
+
+SUPPORTED AGENTS:
+  claude-code, openclaw, cursor, windsurf, codex, cody, aider, continue,
+  gemini-cli, qwen-code, and 15+ more
+
+For more information, visit: https://github.com/nadeemsangrasi/openskills-mcp
+`);
+}
+/**
+ * Show version.
+ */
+function showVersion() {
+    console.log(`openskills v${packageJson.version}`);
+}
+/**
+ * Main entry point.
+ */
+async function main() {
+    try {
+        switch (mode) {
+            case 'help':
+                showHelp();
+                process.exit(ExitCode.SUCCESS);
+                break;
+            case 'version':
+                showVersion();
+                process.exit(ExitCode.SUCCESS);
+                break;
+            case 'install': {
+                const options = parseInstallOptions(args);
+                // Validate that at least skill name is provided
+                if (!options.skill) {
+                    userError('Skill name is required', [
+                        'Usage: npx openskills <skill> [options]',
+                        'Example: npx openskills pdf-processing -a claude-code',
+                    ]);
+                }
+                // Pass options to install (may have null agent for interactive mode)
+                await install(options);
+                break;
+            }
+            case 'mcp': {
+                const apiKey = parseApiKey(args);
+                if (!apiKey) {
+                    userError('Missing required flag: --api-key', ['Usage: npx openskills --api-key <your-key>']);
+                }
+                if (!apiKey.startsWith('osk_')) {
+                    userError("Invalid API key format. Keys start with 'osk_'", ['Get a valid key at: https://openskills.dev/dashboard']);
+                }
+                // Import and start MCP proxy
+                const { startProxy } = await import('../src/modes/mcp-proxy.js');
+                await startProxy(apiKey);
+                break;
+            }
+            default:
+                showHelp();
+                process.exit(ExitCode.SUCCESS);
+        }
+    }
+    catch (error) {
+        console.error(`✗ Error: ${error.message}`);
+        process.exit(ExitCode.SYSTEM_ERROR);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/modes/install.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Installation mode handler.
+ *
+ * Orchestrates the complete skill installation flow:
+ * 1. Validate arguments or prompt for missing options
+ * 2. Check existing installation
+ * 3. Download skill zip from server (server does sparse checkout)
+ * 4. Extract to .agents/skills/
+ * 5. Create symlink(s) to agent directory(ies)
+ * 6. Log installation events
+ *
+ * Server handles sparse checkout - no git required on client.
+ *
+ * Supports:
+ * - Single-agent installation: npx openskills pdf-processing -a claude-code
+ * - Multi-agent installation: npx openskills pdf-processing -y
+ * - Interactive prompts: npx openskills pdf-processing
+ */
+/**
+ * Execute installation flow.
+ *
+ * @param options - Installation options (may have null agent for interactive mode)
+ */
+export declare function install(options: {
+    skill: string | null;
+    agent: string | null;
+    global: boolean;
+    force: boolean;
+    multiAgent: boolean;
+    scopeExplicit: boolean;
+}): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/src/modes/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/modes/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAgFH;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ChB"}

package/dist/src/modes/install.js

@@ -0,0 +1,215 @@
+/**
+ * Installation mode handler.
+ *
+ * Orchestrates the complete skill installation flow:
+ * 1. Validate arguments or prompt for missing options
+ * 2. Check existing installation
+ * 3. Download skill zip from server (server does sparse checkout)
+ * 4. Extract to .agents/skills/
+ * 5. Create symlink(s) to agent directory(ies)
+ * 6. Log installation events
+ *
+ * Server handles sparse checkout - no git required on client.
+ *
+ * Supports:
+ * - Single-agent installation: npx openskills pdf-processing -a claude-code
+ * - Multi-agent installation: npx openskills pdf-processing -y
+ * - Interactive prompts: npx openskills pdf-processing
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { fetchSkillZip } from '../services/downloader.js';
+import { extractSkill, validateSkillMd, cleanup } from '../services/extractor.js';
+import { createSymlink, resolveHome } from '../services/symlink.js';
+import { getAgentDir } from '../utils/agent-dirs.js';
+import { createInstallLogger } from '../utils/logger.js';
+import { promptAgent, promptScope, showMultiAgentInfo } from '../utils/prompts.js';
+import { DEFAULT_AGENTS } from '../utils/constants.js';
+import { validateSkillSlug, validateAgentName, networkError, systemError, success, step, info, ExitCode, } from '../utils/errors.js';
+/**
+ * Get installation base directory.
+ *
+ * @param isGlobal - Whether global or project installation
+ * @returns Base directory path
+ */
+function getBaseDir(isGlobal) {
+    if (isGlobal) {
+        return path.join(os.homedir(), '.agents', 'skills');
+    }
+    else {
+        return path.join(process.cwd(), '.agents', 'skills');
+    }
+}
+/**
+ * Check if skill already exists in .agents/skills/.
+ *
+ * @param skillSlug - Skill identifier
+ * @param isGlobal - Whether global or project installation
+ * @returns True if skill exists
+ */
+function skillExists(skillSlug, isGlobal) {
+    const baseDir = getBaseDir(isGlobal);
+    const skillDir = path.join(baseDir, skillSlug);
+    return fs.existsSync(skillDir) && fs.existsSync(path.join(skillDir, 'SKILL.md'));
+}
+/**
+ * Create symlink for a single agent.
+ *
+ * @param skillDir - Source skill directory
+ * @param agent - Agent name
+ * @param isGlobal - Whether global installation
+ * @param log - Logger function
+ */
+async function createAgentSymlink(skillDir, agent, isGlobal, log) {
+    const agentDir = getAgentDir(agent, isGlobal);
+    const agentPath = isGlobal ? resolveHome(`~/${agentDir}`) : agentDir;
+    const symlinkPath = path.join(agentPath, path.basename(skillDir));
+    step(`Creating symlink for ${agent} at ${symlinkPath}`);
+    try {
+        await createSymlink(skillDir, symlinkPath);
+        log('symlink_created', { agent, symlink_path: symlinkPath });
+    }
+    catch (error) {
+        log('error', { agent, error: error.message });
+        systemError(`Symlink creation failed for ${agent}: ${error.message}`);
+    }
+}
+/**
+ * Execute installation flow.
+ *
+ * @param options - Installation options (may have null agent for interactive mode)
+ */
+export async function install(options) {
+    const startTime = Date.now();
+    // Validate skill name
+    if (!options.skill) {
+        systemError('Skill name is required');
+    }
+    validateSkillSlug(options.skill);
+    // Handle multi-agent installation (-y flag)
+    if (options.multiAgent) {
+        showMultiAgentInfo(options.skill);
+        const installOpts = {
+            skill: options.skill,
+            agent: DEFAULT_AGENTS,
+            global: true, // -y always installs globally
+            force: options.force,
+            multiAgent: true,
+        };
+        await executeInstall(installOpts, startTime);
+        return;
+    }
+    // Interactive mode: prompt for missing options
+    let agent = options.agent;
+    let isGlobal = options.global;
+    if (!agent) {
+        agent = await promptAgent();
+    }
+    // If scope was not explicitly set (no -g or -p flag), prompt for scope
+    if (!options.scopeExplicit) {
+        isGlobal = await promptScope();
+    }
+    const installOpts = {
+        skill: options.skill,
+        agent: agent,
+        global: isGlobal,
+        force: options.force,
+        multiAgent: false,
+    };
+    await executeInstall(installOpts, startTime);
+}
+/**
+ * Execute the actual installation process.
+ *
+ * @param options - Validated installation options
+ * @param startTime - Installation start timestamp
+ */
+async function executeInstall(options, startTime) {
+    const agents = Array.isArray(options.agent) ? options.agent : [options.agent];
+    const installScope = options.global ? 'global' : 'project';
+    // Use first agent for logging (or 'multi' for multi-agent)
+    const logAgent = options.multiAgent ? 'multi-agent' : agents[0];
+    const log = createInstallLogger(options.skill, logAgent, installScope);
+    try {
+        log('start');
+        // Determine installation paths
+        const baseDir = getBaseDir(options.global);
+        const skillDir = path.join(baseDir, options.skill);
+        // Check existing installation
+        const exists = skillExists(options.skill, options.global);
+        if (exists && !options.force) {
+            // Skill exists, reuse files and create symlinks
+            info(`Skill ${options.skill} already exists, reusing files`);
+            for (const agent of agents) {
+                const validAgent = validateAgentName(agent);
+                await createAgentSymlink(skillDir, validAgent, options.global, log);
+            }
+            const duration = Date.now() - startTime;
+            success('Installation complete', duration);
+            log('complete', { duration_ms: duration });
+            process.exit(ExitCode.SUCCESS);
+            return;
+        }
+        if (exists && options.force) {
+            // Force reinstall: delete existing
+            step('Removing existing installation...');
+            fs.rmSync(skillDir, { recursive: true, force: true });
+        }
+        // Download skill zip from server (server does sparse checkout)
+        step(`Downloading ${options.skill}...`);
+        log('download_begin');
+        // Create temp directory for zip
+        const tmpDir = path.join(os.tmpdir(), 'openskills');
+        if (!fs.existsSync(tmpDir)) {
+            fs.mkdirSync(tmpDir, { recursive: true });
+        }
+        let zipPath;
+        try {
+            zipPath = await fetchSkillZip(options.skill, tmpDir);
+            log('download_complete', { duration_ms: Date.now() - startTime });
+        }
+        catch (error) {
+            log('error', { error: error.message });
+            networkError(error.message);
+        }
+        // Extract to .agents/skills/
+        step(`Extracting to ${skillDir}`);
+        log('extract_begin');
+        try {
+            await extractSkill(zipPath, skillDir);
+            log('extract_complete', { target_path: skillDir, duration_ms: Date.now() - startTime });
+        }
+        catch (error) {
+            cleanup(zipPath, skillDir);
+            log('error', { error: error.message });
+            systemError(`Extraction failed: ${error.message}`);
+        }
+        // Validate SKILL.md
+        try {
+            validateSkillMd(skillDir);
+        }
+        catch (error) {
+            cleanup(zipPath, skillDir);
+            log('error', { error: error.message });
+            systemError(`Skill validation failed: ${error.message}`);
+        }
+        // Clean up zip file
+        cleanup(zipPath);
+        // Create symlinks for all agents
+        for (const agent of agents) {
+            const validAgent = validateAgentName(agent);
+            await createAgentSymlink(skillDir, validAgent, options.global, log);
+        }
+        // Success
+        const duration = Date.now() - startTime;
+        success('Installation complete', duration);
+        log('complete', { duration_ms: duration, agents: agents.length });
+        process.exit(ExitCode.SUCCESS);
+    }
+    catch (error) {
+        log('error', { error: error.message });
+        throw error;
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/src/modes/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/modes/install.ts"],"names":[],"mappings":"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"}

package/dist/src/modes/mcp-proxy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP proxy mode handler.
+ *
+ * Creates a local stdio MCP server that proxies all tool calls
+ * to the hosted OpenSkills MCP server with X-API-Key auth.
+ *
+ * Architecture:
+ *   AI Agent <--stdio--> this proxy <--HTTP+X-API-Key--> hosted server
+ */
+/**
+ * Start the stdio-to-HTTP MCP proxy.
+ *
+ * @param apiKey - OpenSkills API key (osk_xxx)
+ */
+export declare function startProxy(apiKey: string): Promise<void>;
+//# sourceMappingURL=mcp-proxy.d.ts.map

package/dist/src/modes/mcp-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-proxy.d.ts","sourceRoot":"","sources":["../../../src/modes/mcp-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+G9D"}

package/dist/src/modes/mcp-proxy.js

@@ -0,0 +1,117 @@
+/**
+ * MCP proxy mode handler.
+ *
+ * Creates a local stdio MCP server that proxies all tool calls
+ * to the hosted OpenSkills MCP server with X-API-Key auth.
+ *
+ * Architecture:
+ *   AI Agent <--stdio--> this proxy <--HTTP+X-API-Key--> hosted server
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+const BACKEND_URL = 'https://sangrasi-openskills-mcp.hf.space';
+/**
+ * Start the stdio-to-HTTP MCP proxy.
+ *
+ * @param apiKey - OpenSkills API key (osk_xxx)
+ */
+export async function startProxy(apiKey) {
+    const remoteUrl = `${BACKEND_URL}/mcp`;
+    // 1. Connect to remote OpenSkills MCP server as a client
+    const remoteClient = new Client({
+        name: 'openskills-proxy',
+        version: '1.0.0',
+    });
+    const remoteTransport = new StreamableHTTPClientTransport(new URL(remoteUrl), {
+        requestInit: {
+            headers: {
+                'X-API-Key': apiKey,
+                'Accept': 'application/json, text/event-stream',
+            },
+        },
+    });
+    try {
+        await remoteClient.connect(remoteTransport);
+    }
+    catch (err) {
+        const msg = err.message || String(err);
+        if (msg.includes('401') || msg.includes('Unauthorized')) {
+            console.error('Error: Invalid API key. Check your key at https://openskills.dev/dashboard');
+            process.exit(2);
+        }
+        console.error(`Error: Failed to connect to OpenSkills server: ${msg}`);
+        process.exit(3);
+    }
+    // 2. Discover remote tools
+    let tools;
+    try {
+        const result = await remoteClient.listTools();
+        tools = result.tools;
+    }
+    catch (err) {
+        console.error(`Error: Failed to list remote tools: ${err.message}`);
+        process.exit(3);
+    }
+    // Log to stderr (stdout is reserved for MCP stdio protocol)
+    console.error(`OpenSkills: Connected to ${BACKEND_URL}. ${tools.length} tools available: ${tools.map((t) => t.name).join(', ')}`);
+    // 3. Create local stdio MCP server
+    const localServer = new McpServer({
+        name: 'openskills',
+        version: '1.0.0',
+    });
+    // 4. Register each remote tool as a local proxy tool
+    for (const tool of tools) {
+        localServer.tool(tool.name, tool.description || `Proxy to remote tool: ${tool.name}`, {}, async (args) => {
+            try {
+                const result = await remoteClient.callTool({
+                    name: tool.name,
+                    arguments: args,
+                });
+                // Return result directly - MCP SDK handles the response format
+                return result;
+            }
+            catch (err) {
+                const msg = err.message || String(err);
+                if (msg.includes('401') || msg.includes('Unauthorized')) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: Invalid API key. Check your key at https://openskills.dev/dashboard',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error calling ${tool.name}: ${msg}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    // 5. Start local stdio transport
+    const stdioTransport = new StdioServerTransport();
+    await localServer.connect(stdioTransport);
+    console.error('OpenSkills MCP proxy running (stdio -> remote)');
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        console.error('OpenSkills: Shutting down...');
+        await localServer.close();
+        await remoteClient.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await localServer.close();
+        await remoteClient.close();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=mcp-proxy.js.map