openskills-cli 0.1.0

package/dist/src/utils/mode-detector.js

@@ -0,0 +1,156 @@
+/**
+ * CLI mode detection utility.
+ *
+ * Determines which mode the CLI should operate in based on command-line arguments.
+ */
+/**
+ * Detect CLI mode from command-line arguments.
+ *
+ * Mode priority:
+ * 1. Help (-h, --help)
+ * 2. Version (-v, --version)
+ * 3. MCP proxy (--api-key)
+ * 4. Installation (positional skill name or -s/--skill flag)
+ * 5. Help (default if no valid flags)
+ *
+ * @param args - Command-line arguments (process.argv.slice(2))
+ * @returns Detected CLI mode
+ *
+ * @example
+ * ```typescript
+ * detectMode(['pdf-processing', '-a', 'claude-code']) // 'install'
+ * detectMode(['-s', 'pdf', '-a', 'claude-code'])      // 'install'
+ * detectMode(['--api-key', 'osk_abc123'])             // 'mcp'
+ * detectMode(['-h'])                                  // 'help'
+ * detectMode(['-v'])                                  // 'version'
+ * detectMode([])                                      // 'help'
+ * ```
+ */
+export function detectMode(args) {
+    // Priority 1: Help
+    if (args.includes('-h') || args.includes('--help')) {
+        return 'help';
+    }
+    // Priority 2: Version
+    if (args.includes('-v') || args.includes('--version')) {
+        return 'version';
+    }
+    // Priority 3: MCP proxy mode
+    if (args.includes('--api-key')) {
+        return 'mcp';
+    }
+    // Priority 4: Installation mode (positional skill name or -s flag)
+    if (args.includes('-s') || args.includes('--skill') || hasPositionalSkill(args)) {
+        return 'install';
+    }
+    // Default: Show help
+    return 'help';
+}
+/**
+ * Check if args contain a positional skill name.
+ * A positional skill is the first non-flag argument.
+ *
+ * @param args - Command-line arguments
+ * @returns True if positional skill exists
+ */
+function hasPositionalSkill(args) {
+    if (args.length === 0)
+        return false;
+    // First arg that doesn't start with - and isn't after a flag that takes a value
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        // Skip flags
+        if (arg.startsWith('-')) {
+            // Skip next arg if this flag takes a value
+            if (arg === '-a' || arg === '--agent' || arg === '--api-key') {
+                i++; // Skip the value
+            }
+            continue;
+        }
+        // Found positional argument
+        return true;
+    }
+    return false;
+}
+/**
+ * Parse installation options from command-line arguments.
+ *
+ * Supports both positional and flag-based skill names:
+ * - Positional: npx openskills pdf-processing -a claude-code
+ * - Flag-based: npx openskills -s pdf-processing -a claude-code
+ *
+ * @param args - Command-line arguments
+ * @returns Parsed installation options or partial options for interactive mode
+ *
+ * @example
+ * ```typescript
+ * parseInstallOptions(['pdf-processing', '-a', 'claude-code'])
+ * // { skill: 'pdf-processing', agent: 'claude-code', global: false, force: false, multiAgent: false }
+ *
+ * parseInstallOptions(['pdf-processing', '-y'])
+ * // { skill: 'pdf-processing', agent: null, global: true, force: false, multiAgent: true }
+ *
+ * parseInstallOptions(['pdf-processing'])
+ * // { skill: 'pdf-processing', agent: null, global: false, force: false, multiAgent: false }
+ * ```
+ */
+export function parseInstallOptions(args) {
+    // Find skill name (positional or flag-based)
+    let skill = null;
+    // Check for -s/--skill flag first
+    const skillIdx = args.findIndex(arg => arg === '-s' || arg === '--skill');
+    if (skillIdx !== -1 && args[skillIdx + 1]) {
+        skill = args[skillIdx + 1];
+    }
+    else {
+        // Look for positional skill name (first non-flag argument)
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            // Skip flags
+            if (arg.startsWith('-')) {
+                // Skip next arg if this flag takes a value
+                if (arg === '-a' || arg === '--agent' || arg === '-s' || arg === '--skill') {
+                    i++; // Skip the value
+                }
+                continue;
+            }
+            // Found positional skill name
+            skill = arg;
+            break;
+        }
+    }
+    // Find -a/--agent flag
+    const agentIdx = args.findIndex(arg => arg === '-a' || arg === '--agent');
+    const agent = agentIdx !== -1 && args[agentIdx + 1] ? args[agentIdx + 1] : null;
+    // Check for -g/--global or -p/--project flag
+    const hasGlobal = args.includes('-g') || args.includes('--global');
+    const hasProject = args.includes('-p') || args.includes('--project');
+    const hasMultiAgent = args.includes('-y');
+    // Track if scope was explicitly set by user
+    const scopeExplicit = hasGlobal || hasProject || hasMultiAgent;
+    // If both flags provided, -g takes precedence
+    // If -y flag provided without -p, default to global
+    const global = hasGlobal || (hasMultiAgent && !hasProject);
+    // Check for --force flag
+    const force = args.includes('--force');
+    // Check for -y flag (multi-agent installation)
+    const multiAgent = hasMultiAgent;
+    return { skill, agent, global, force, multiAgent, scopeExplicit };
+}
+/**
+ * Parse API key from command-line arguments.
+ *
+ * @param args - Command-line arguments
+ * @returns API key or null if not found
+ *
+ * @example
+ * ```typescript
+ * parseApiKey(['--api-key', 'osk_abc123']) // 'osk_abc123'
+ * parseApiKey(['-s', 'pdf'])               // null
+ * ```
+ */
+export function parseApiKey(args) {
+    const keyIdx = args.indexOf('--api-key');
+    return keyIdx !== -1 && args[keyIdx + 1] ? args[keyIdx + 1] : null;
+}
+//# sourceMappingURL=mode-detector.js.map

package/dist/src/utils/mode-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-detector.js","sourceRoot":"","sources":["../../../src/utils/mode-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,mBAAmB;IACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sBAAsB;IACtB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,6BAA6B;IAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mEAAmE;IACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qBAAqB;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,IAAc;IACxC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpC,gFAAgF;IAChF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,aAAa;QACb,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,2CAA2C;YAC3C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBAC7D,CAAC,EAAE,CAAC,CAAC,iBAAiB;YACxB,CAAC;YACD,SAAS;QACX,CAAC;QAED,4BAA4B;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAQhD,6CAA6C;IAC7C,IAAI,KAAK,GAAkB,IAAI,CAAC;IAEhC,kCAAkC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC;IAC1E,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;QAC1C,KAAK,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,2DAA2D;QAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAEpB,aAAa;YACb,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,2CAA2C;gBAC3C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBAC3E,CAAC,EAAE,CAAC,CAAC,iBAAiB;gBACxB,CAAC;gBACD,SAAS;YACX,CAAC;YAED,8BAA8B;YAC9B,KAAK,GAAG,GAAG,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,QAAQ,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEhF,6CAA6C;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE1C,4CAA4C;IAC5C,MAAM,aAAa,GAAG,SAAS,IAAI,UAAU,IAAI,aAAa,CAAC;IAE/D,8CAA8C;IAC9C,oDAAoD;IACpD,MAAM,MAAM,GAAG,SAAS,IAAI,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3D,yBAAyB;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEvC,+CAA+C;IAC/C,MAAM,UAAU,GAAG,aAAa,CAAC;IAEjC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO,MAAM,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC"}

package/dist/src/utils/prompts.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Interactive CLI prompts for missing installation options.
+ */
+/**
+ * Prompt user to select an agent.
+ *
+ * @returns Selected agent name
+ */
+export declare function promptAgent(): Promise<string>;
+/**
+ * Prompt user to select installation scope (global vs project).
+ *
+ * @returns True if global, false if project
+ */
+export declare function promptScope(): Promise<boolean>;
+/**
+ * Show multi-agent installation info.
+ *
+ * @param skillName - Skill being installed
+ */
+export declare function showMultiAgentInfo(skillName: string): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/src/utils/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAkBnD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CA0BpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAK1D"}

package/dist/src/utils/prompts.js

@@ -0,0 +1,69 @@
+/**
+ * Interactive CLI prompts for missing installation options.
+ */
+import prompts from 'prompts';
+import { SUPPORTED_AGENTS, DEFAULT_AGENTS } from './constants.js';
+/**
+ * Prompt user to select an agent.
+ *
+ * @returns Selected agent name
+ */
+export async function promptAgent() {
+    const response = await prompts({
+        type: 'select',
+        name: 'agent',
+        message: 'Select an agent:',
+        choices: SUPPORTED_AGENTS.map(agent => ({
+            title: agent,
+            value: agent,
+        })),
+        initial: 0,
+    });
+    if (!response.agent) {
+        console.error('\n✗ Installation cancelled');
+        process.exit(1);
+    }
+    return response.agent;
+}
+/**
+ * Prompt user to select installation scope (global vs project).
+ *
+ * @returns True if global, false if project
+ */
+export async function promptScope() {
+    const response = await prompts({
+        type: 'select',
+        name: 'scope',
+        message: 'Installation scope:',
+        choices: [
+            {
+                title: 'Global (~/.agents/skills/)',
+                description: 'Available to all projects',
+                value: 'global',
+            },
+            {
+                title: 'Project (./agents/skills/)',
+                description: 'Only for current project',
+                value: 'project',
+            },
+        ],
+        initial: 0,
+    });
+    if (!response.scope) {
+        console.error('\n✗ Installation cancelled');
+        process.exit(1);
+    }
+    return response.scope === 'global';
+}
+/**
+ * Show multi-agent installation info.
+ *
+ * @param skillName - Skill being installed
+ */
+export function showMultiAgentInfo(skillName) {
+    console.log(`\n📦 Installing ${skillName} for multiple agents:`);
+    console.log(`   Agents: ${DEFAULT_AGENTS.join(', ')}`);
+    console.log(`   Scope: Global (~/.agents/skills/)`);
+    console.log('');
+}
+//# sourceMappingURL=prompts.js.map

package/dist/src/utils/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtC,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,qBAAqB;QAC9B,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,4BAA4B;gBACnC,WAAW,EAAE,2BAA2B;gBACxC,KAAK,EAAE,QAAQ;aAChB;YACD;gBACE,KAAK,EAAE,4BAA4B;gBACnC,WAAW,EAAE,0BAA0B;gBACvC,KAAK,EAAE,SAAS;aACjB;SACF;QACD,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,uBAAuB,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,cAAc,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "openskills-cli",
+  "version": "0.1.0",
+  "description": "Install AI agent skills locally or discover via MCP protocol",
+  "type": "module",
+  "bin": {
+    "openskills": "dist/bin/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "extract-zip": "^2.0.1",
+    "node-fetch": "^3.3.2",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/prompts": "^2.4.9",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.4",
+    "typescript": "^5.3.3"
+  },
+  "keywords": [
+    "mcp",
+    "ai",
+    "skills",
+    "claude",
+    "cursor",
+    "agent",
+    "model-context-protocol",
+    "skill-installation",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nadeemsangrasi/openskills-mcp.git"
+  }
+}