skillpkg-mcp-server 0.3.1 → 0.5.0

package/README.md

@@ -89,7 +89,7 @@ Installs a skill from multiple sources:
   "source": "commit-helper",        // Registry
   "source": "github:user/repo",     // GitHub repo
   "source": "gist:abc123",          // GitHub Gist
-  "source": "https://example.com/skill.yaml", // URL
+  "source": "https://example.com/SKILL.md",   // URL
   "source": "./my-skill",           // Local path
   "scope": "local"                  // "local" | "global"
 }

package/dist/index.d.ts

@@ -16,5 +16,5 @@
 export declare const VERSION = "0.1.0";
 export * from './types.js';
 export { SkillpkgMcpServer } from './server.js';
-export { createAllToolHandlers, createListSkillsHandler, createLoadSkillHandler, createSearchSkillsHandler, createInstallSkillHandler, createUninstallSkillHandler, createSkillInfoHandler, createRecommendSkillHandler, } from './tools/index.js';
+export { createAllToolHandlers, createListSkillsHandler, createLoadSkillHandler, createSearchSkillsHandler, createInstallSkillHandler, createUninstallSkillHandler, createSyncSkillsHandler, createCreateSkillHandler, createSkillStatusHandler, createSkillInfoHandler, createRecommendSkillHandler, } from './tools/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -19,5 +19,5 @@ export * from './types.js';
 // Server
 export { SkillpkgMcpServer } from './server.js';
 // Tool handlers
-export { createAllToolHandlers, createListSkillsHandler, createLoadSkillHandler, createSearchSkillsHandler, createInstallSkillHandler, createUninstallSkillHandler, createSkillInfoHandler, createRecommendSkillHandler, } from './tools/index.js';
+export { createAllToolHandlers, createListSkillsHandler, createLoadSkillHandler, createSearchSkillsHandler, createInstallSkillHandler, createUninstallSkillHandler, createSyncSkillsHandler, createCreateSkillHandler, createSkillStatusHandler, createSkillInfoHandler, createRecommendSkillHandler, } from './tools/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/tools/create-skill.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tool: create_skill
+ *
+ * Creates a new skill with SKILL.md format.
+ * Useful for AI agents to help users create new skills.
+ */
+import type { ToolHandler } from '../types.js';
+export interface CreateSkillInput {
+    name: string;
+    description?: string;
+    instructions?: string;
+}
+export declare function createCreateSkillHandler(): ToolHandler;
+//# sourceMappingURL=create-skill.d.ts.map

package/dist/tools/create-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skill.d.ts","sourceRoot":"","sources":["../../src/tools/create-skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AAI3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAgCD,wBAAgB,wBAAwB,IAAI,WAAW,CA8EtD"}

package/dist/tools/create-skill.js

@@ -0,0 +1,106 @@
+/**
+ * Tool: create_skill
+ *
+ * Creates a new skill with SKILL.md format.
+ * Useful for AI agents to help users create new skills.
+ */
+import { successResult, errorResult, validateString } from './utils.js';
+import { SkillCreator } from 'skillpkg-core';
+/**
+ * Convert string to kebab-case
+ */
+function toKebabCase(str) {
+    return str
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Validate skill name
+ */
+function validateSkillName(name) {
+    if (!name) {
+        return 'Name is required';
+    }
+    const normalized = toKebabCase(name);
+    if (normalized.length < 2) {
+        return 'Name must be at least 2 characters';
+    }
+    if (normalized.length > 100) {
+        return 'Name must be less than 100 characters';
+    }
+    return null;
+}
+export function createCreateSkillHandler() {
+    return {
+        name: 'create_skill',
+        description: `Create a new skill with SKILL.md format.
+
+This tool helps AI agents create new skills for users. It generates:
+- A directory with the skill name
+- A SKILL.md file with frontmatter and instructions
+
+Parameters:
+- name (required): Skill name (will be converted to kebab-case)
+- description (optional): Short description of the skill
+- instructions (optional): The skill instructions content
+
+Returns the path to the created SKILL.md file.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'Skill name (e.g., "my-helper", "code-reviewer")',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Short description of what the skill does',
+                },
+                instructions: {
+                    type: 'string',
+                    description: 'The full instructions content for the skill (markdown)',
+                },
+            },
+            required: ['name'],
+        },
+        async execute(args) {
+            const input = args;
+            try {
+                const rawName = validateString(input.name, 'name');
+                // Validate name
+                const nameError = validateSkillName(rawName);
+                if (nameError) {
+                    return errorResult(nameError);
+                }
+                const skillName = toKebabCase(rawName);
+                const description = input.description || 'A helpful skill';
+                const instructions = input.instructions;
+                const creator = new SkillCreator();
+                // Create the skill
+                const skillMdPath = await creator.create({
+                    name: skillName,
+                    description,
+                    instructions,
+                    createDir: true,
+                });
+                const lines = [
+                    `✅ Created skill: ${skillName}`,
+                    '',
+                    `📄 File: ${skillMdPath}`,
+                    '',
+                    '📋 Next steps:',
+                    `   • Edit ${skillName}/SKILL.md to customize instructions`,
+                    `   • Run \`skillpkg install ./${skillName}\` to install locally`,
+                    `   • Run \`skillpkg sync\` to sync to AI platforms`,
+                ];
+                return successResult(lines.join('\n'));
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return errorResult(`Failed to create skill: ${message}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=create-skill.js.map

package/dist/tools/create-skill.js.map

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

package/dist/tools/index.d.ts

@@ -12,10 +12,13 @@ import { createInstallSkillHandler } from './install-skill.js';
 import { createUninstallSkillHandler } from './uninstall-skill.js';
 import { createSkillInfoHandler } from './skill-info.js';
 import { createRecommendSkillHandler } from './recommend-skill.js';
+import { createSyncSkillsHandler } from './sync-skills.js';
+import { createCreateSkillHandler } from './create-skill.js';
+import { createSkillStatusHandler } from './skill-status.js';
 /**
  * Create all tool handlers
  */
 export declare function createAllToolHandlers(): ToolHandler[];
-export { createListSkillsHandler, createLoadSkillHandler, createSearchSkillsHandler, createInstallSkillHandler, createUninstallSkillHandler, createSkillInfoHandler, createRecommendSkillHandler, };
+export { createListSkillsHandler, createLoadSkillHandler, createSearchSkillsHandler, createInstallSkillHandler, createUninstallSkillHandler, createSyncSkillsHandler, createCreateSkillHandler, createSkillStatusHandler, createSkillInfoHandler, createRecommendSkillHandler, };
 export * from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,EAAE,CAarD;AAGD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,CAAC;AAGF,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,EAAE,CAgBrD;AAGD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,GAC5B,CAAC;AAGF,cAAc,YAAY,CAAC"}

package/dist/tools/index.js

@@ -12,6 +12,9 @@ import { createInstallSkillHandler } from './install-skill.js';
 import { createUninstallSkillHandler } from './uninstall-skill.js';
 import { createSkillInfoHandler } from './skill-info.js';
 import { createRecommendSkillHandler } from './recommend-skill.js';
+import { createSyncSkillsHandler } from './sync-skills.js';
+import { createCreateSkillHandler } from './create-skill.js';
+import { createSkillStatusHandler } from './skill-status.js';
 /**
  * Create all tool handlers
  */
@@ -22,6 +25,9 @@ export function createAllToolHandlers() {
         createLoadSkillHandler(),
         createInstallSkillHandler(),
         createUninstallSkillHandler(),
+        createSyncSkillsHandler(),
+        createCreateSkillHandler(),
+        createSkillStatusHandler(),
         // Search & Discovery
         createSearchSkillsHandler(),
         createSkillInfoHandler(),
@@ -29,7 +35,7 @@ export function createAllToolHandlers() {
     ];
 }
 // Export individual handlers for selective use
-export { createListSkillsHandler, createLoadSkillHandler, createSearchSkillsHandler, createInstallSkillHandler, createUninstallSkillHandler, createSkillInfoHandler, createRecommendSkillHandler, };
+export { createListSkillsHandler, createLoadSkillHandler, createSearchSkillsHandler, createInstallSkillHandler, createUninstallSkillHandler, createSyncSkillsHandler, createCreateSkillHandler, createSkillStatusHandler, createSkillInfoHandler, createRecommendSkillHandler, };
 // Re-export utilities
 export * from './utils.js';
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,2BAA2B;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,wBAAwB;QACxB,uBAAuB,EAAE;QACzB,sBAAsB,EAAE;QACxB,yBAAyB,EAAE;QAC3B,2BAA2B,EAAE;QAE7B,qBAAqB;QACrB,yBAAyB,EAAE;QAC3B,sBAAsB,EAAE;QACxB,2BAA2B,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,CAAC;AAEF,sBAAsB;AACtB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,2BAA2B;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,wBAAwB;QACxB,uBAAuB,EAAE;QACzB,sBAAsB,EAAE;QACxB,yBAAyB,EAAE;QAC3B,2BAA2B,EAAE;QAC7B,uBAAuB,EAAE;QACzB,wBAAwB,EAAE;QAC1B,wBAAwB,EAAE;QAE1B,qBAAqB;QACrB,yBAAyB,EAAE;QAC3B,sBAAsB,EAAE;QACxB,2BAA2B,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,GAC5B,CAAC;AAEF,sBAAsB;AACtB,cAAc,YAAY,CAAC"}

package/dist/tools/install-skill.d.ts

@@ -1,8 +1,8 @@
 /**
  * Tool: install_skill
  *
- * Installs a skill from GitHub, Gist, URL, or local path.
- * Supports SKILL.md format (industry standard for Claude Code and OpenAI Codex).
+ * v2.0: Uses new Installer module with dependency resolution.
+ * Returns dependency info and MCP requirements.
  */
 import type { ToolHandler } from '../types.js';
 export declare function createInstallSkillHandler(): ToolHandler;

package/dist/tools/install-skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-skill.d.ts","sourceRoot":"","sources":["../../src/tools/install-skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAiE,MAAM,aAAa,CAAC;AA4I9G,wBAAgB,yBAAyB,IAAI,WAAW,CAyHvD"}
+{"version":3,"file":"install-skill.d.ts","sourceRoot":"","sources":["../../src/tools/install-skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAiC,MAAM,aAAa,CAAC;AAqN9E,wBAAgB,yBAAyB,IAAI,WAAW,CAyHvD"}

package/dist/tools/install-skill.js

@@ -1,37 +1,29 @@
 /**
  * Tool: install_skill
  *
- * Installs a skill from GitHub, Gist, URL, or local path.
- * Supports SKILL.md format (industry standard for Claude Code and OpenAI Codex).
+ * v2.0: Uses new Installer module with dependency resolution.
+ * Returns dependency info and MCP requirements.
  */
 import { getStore, successResult, errorResult, validateString, validateScope } from './utils.js';
 import { InvalidSourceError } from '../types.js';
-import { parse as parseSkillYaml, detectSkillMd, fetchSkillMdContent } from 'skillpkg-core';
-/**
- * Parse source string to determine source type
- */
+import matter from 'gray-matter';
+import { detectSkillMd, fetchSkillMdContent, createInstaller, createStateManager, createConfigManager, } from 'skillpkg-core';
 function parseSource(source) {
-    // GitHub: github:user/repo or user/repo
     if (source.startsWith('github:')) {
         return { type: 'github', value: source.slice(7) };
     }
     if (/^[a-zA-Z0-9_-]+\/[a-zA-Z0-9_.-]+$/.test(source)) {
         return { type: 'github', value: source };
     }
-    // Gist: gist:id
     if (source.startsWith('gist:')) {
         return { type: 'gist', value: source.slice(5) };
     }
-    // URL: https:// or http://
     if (source.startsWith('https://') || source.startsWith('http://')) {
         return { type: 'url', value: source };
     }
-    // Local path: starts with ./ or / or contains path separators
     if (source.startsWith('./') || source.startsWith('/') || source.startsWith('../')) {
         return { type: 'local', value: source };
     }
-    // Simple skill names are no longer supported (no central registry)
-    // Suggest using github:owner/repo format instead
     throw new InvalidSourceError(`Invalid source "${source}". Use one of: github:owner/repo, gist:id, https://url, or ./local/path`);
 }
 /**
@@ -45,36 +37,25 @@ async function fetchSkillFromUrl(url) {
     return response.text();
 }
 /**
- * Fetch skill from GitHub repo (SKILL.md or skill.yaml)
- * Uses shared logic from skillpkg-core
+ * Fetch skill from GitHub repo
  */
 async function fetchSkillFromGitHub(repo) {
     const token = process.env.GITHUB_TOKEN;
-    // Try SKILL.md first using core's detection
     const detection = await detectSkillMd(repo, token);
     if (detection.hasSkill && detection.skillFile) {
         const content = await fetchSkillMdContent(repo, detection.skillFile, token);
         if (content) {
-            // Convert to skill.yaml format for compatibility
-            return `schema: "1.0"\nname: ${content.name}\nversion: ${content.version}\ndescription: ${JSON.stringify(content.description)}\ninstructions: |\n${content.instructions.split('\n').map((l) => '  ' + l).join('\n')}`;
-        }
-    }
-    // Fall back to skill.yaml
-    const skillYamlPaths = ['skill.yaml', 'skill.yml', '.claude/skill.yaml'];
-    const branches = ['main', 'master', 'HEAD'];
-    for (const branch of branches) {
-        for (const path of skillYamlPaths) {
-            const url = `https://raw.githubusercontent.com/${repo}/${branch}/${path}`;
-            try {
-                const yamlContent = await fetchSkillFromUrl(url);
-                return yamlContent;
-            }
-            catch {
-                // Try next path/branch
-            }
+            return {
+                schema: '1.0',
+                name: content.name,
+                version: content.version,
+                description: content.description,
+                instructions: content.instructions,
+            };
         }
     }
-    throw new Error(`Could not find SKILL.md or skill.yaml in repository ${repo}`);
+    // No SKILL.md found in standard locations
+    return null;
 }
 /**
  * Fetch skill from Gist
@@ -86,13 +67,25 @@ async function fetchSkillFromGist(gistId) {
         throw new Error(`Failed to fetch gist ${gistId}: ${response.status}`);
     }
     const gist = (await response.json());
-    // Look for skill.yaml or skill.yml
+    // Look for SKILL.md in Gist files
     for (const [filename, file] of Object.entries(gist.files)) {
-        if (filename === 'skill.yaml' || filename === 'skill.yml') {
-            return file.content;
+        if (filename === 'SKILL.md' || filename === 'skill.md') {
+            try {
+                const { data, content: body } = matter(file.content);
+                return {
+                    schema: '1.0',
+                    name: data.name || '',
+                    version: data.version || '1.0.0',
+                    description: data.description || '',
+                    instructions: body.trim(),
+                };
+            }
+            catch {
+                // Invalid frontmatter
+            }
         }
     }
-    throw new Error(`No skill.yaml found in gist ${gistId}`);
+    return null;
 }
 /**
  * Fetch skill from local path
@@ -101,40 +94,117 @@ async function fetchSkillFromLocal(path) {
     const fs = await import('fs/promises');
     const nodePath = await import('path');
     let skillPath = path;
-    const stat = await fs.stat(path);
-    if (stat.isDirectory()) {
-        // Look for skill.yaml in directory
-        const candidates = ['skill.yaml', 'skill.yml'];
-        for (const candidate of candidates) {
-            const fullPath = nodePath.join(path, candidate);
-            try {
-                await fs.access(fullPath);
-                skillPath = fullPath;
-                break;
+    try {
+        const stat = await fs.stat(path);
+        if (stat.isDirectory()) {
+            // Only SKILL.md format is supported
+            const candidates = ['SKILL.md', 'skill.md'];
+            for (const candidate of candidates) {
+                const fullPath = nodePath.join(path, candidate);
+                try {
+                    await fs.access(fullPath);
+                    skillPath = fullPath;
+                    break;
+                }
+                catch {
+                    // Try next
+                }
             }
-            catch {
-                // Try next
+        }
+        // Only process SKILL.md files
+        if (!skillPath.toLowerCase().endsWith('.md')) {
+            return null;
+        }
+        const content = await fs.readFile(skillPath, 'utf-8');
+        const { data, content: body } = matter(content);
+        return {
+            schema: '1.0',
+            name: data.name || '',
+            version: data.version || '1.0.0',
+            description: data.description || '',
+            instructions: body.trim(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Create a SkillFetcherAdapter
+ */
+function createFetcher() {
+    return {
+        async fetchMetadata(source) {
+            const skill = await fetchSkillBySource(source);
+            if (!skill)
+                return null;
+            return {
+                name: skill.name,
+                version: skill.version,
+                dependencies: skill.dependencies,
+            };
+        },
+        async fetchSkill(source) {
+            return fetchSkillBySource(source);
+        },
+    };
+}
+async function fetchSkillBySource(source) {
+    try {
+        const { type, value } = parseSource(source);
+        switch (type) {
+            case 'github':
+                return fetchSkillFromGitHub(value);
+            case 'gist':
+                return fetchSkillFromGist(value);
+            case 'url': {
+                const content = await fetchSkillFromUrl(value);
+                // Parse as SKILL.md format with gray-matter
+                try {
+                    const { data, content: body } = matter(content);
+                    return {
+                        schema: '1.0',
+                        name: data.name || '',
+                        version: data.version || '1.0.0',
+                        description: data.description || '',
+                        instructions: body.trim(),
+                    };
+                }
+                catch {
+                    return null;
+                }
             }
+            case 'local':
+                return fetchSkillFromLocal(value);
         }
     }
-    return fs.readFile(skillPath, 'utf-8');
+    catch {
+        return null;
+    }
 }
 export function createInstallSkillHandler() {
     return {
         name: 'install_skill',
-        description: `Install a skill from various sources. Supports SKILL.md format (industry standard for Claude Code and OpenAI Codex).
+        description: `Install a skill from various sources with dependency resolution.
+
+Supports SKILL.md format (industry standard for Claude Code and OpenAI Codex).
 
 Supported source formats:
 • GitHub: github:user/repo or user/repo (e.g., "anthropics/claude-code-skills")
 • Gist: gist:id (e.g., "gist:abc123")
-• URL: https://... (direct link to SKILL.md or skill.yaml)
-• Local: ./path or /absolute/path (local file or directory)`,
+• URL: https://... (direct link to SKILL.md)
+• Local: ./path or /absolute/path (local file or directory)
+
+Returns:
+• List of installed skills (including dependencies)
+• MCP servers required by the skill
+• Suggestions for next steps`,
         inputSchema: {
             type: 'object',
             properties: {
                 source: {
                     type: 'string',
-                    description: 'Source to install from: skill-name, github:user/repo, gist:id, URL, or local path',
+                    description: 'Source to install from: github:user/repo, gist:id, URL, or local path',
                 },
                 scope: {
                     type: 'string',
@@ -150,70 +220,63 @@ Supported source formats:
             try {
                 const sourceStr = validateString(input.source, 'source');
                 const scope = validateScope(input.scope, 'local');
-                // Parse the source
+                // Normalize source
                 const { type, value } = parseSource(sourceStr);
-                // Fetch skill content based on source type
-                let skillContent;
-                switch (type) {
-                    case 'github':
-                        skillContent = await fetchSkillFromGitHub(value);
-                        break;
-                    case 'gist':
-                        skillContent = await fetchSkillFromGist(value);
-                        break;
-                    case 'url':
-                        skillContent = await fetchSkillFromUrl(value);
-                        break;
-                    case 'local':
-                        skillContent = await fetchSkillFromLocal(value);
-                        break;
+                const normalizedSource = type === 'github' ? `github:${value}` : sourceStr;
+                // Get project path (cwd for MCP server context)
+                const cwd = process.cwd();
+                // Create installer
+                const stateManager = createStateManager();
+                const configManager = createConfigManager();
+                const storeManager = getStore(scope);
+                const fetcher = createFetcher();
+                // Initialize store if needed
+                if (!(await storeManager.isInitialized())) {
+                    await storeManager.init();
                 }
-                // Parse the skill content
-                const parseResult = parseSkillYaml(skillContent);
-                if (!parseResult.success || !parseResult.data) {
-                    const errors = parseResult.errors?.map((e) => e.message).join(', ') || 'Unknown parse error';
-                    return errorResult(`Invalid skill.yaml: ${errors}`);
+                const installer = createInstaller(stateManager, configManager, storeManager, fetcher);
+                // Run installation
+                const result = await installer.install(cwd, normalizedSource);
+                if (!result.success) {
+                    const errors = result.errors.join('; ');
+                    return errorResult(`Installation failed: ${errors}`);
                 }
-                const skill = parseResult.data;
-                // Get the store and initialize if needed
-                const store = getStore(scope);
-                if (!(await store.isInitialized())) {
-                    await store.init();
+                // Build response
+                const installed = result.skills.filter((s) => s.action === 'installed');
+                const updated = result.skills.filter((s) => s.action === 'updated');
+                const skipped = result.skills.filter((s) => s.action === 'skipped');
+                const lines = [];
+                if (installed.length > 0) {
+                    lines.push(`✅ Installed ${installed.length} skill(s):`);
+                    for (const skill of installed) {
+                        const note = skill.transitive ? ` (dependency of ${skill.requiredBy})` : '';
+                        lines.push(`   • ${skill.name} v${skill.version}${note}`);
+                    }
                 }
-                // Check if already installed
-                if (await store.hasSkill(skill.name)) {
-                    // Update instead of error
-                    await store.updateSkill(skill.name, skill);
-                    const output = {
-                        success: true,
-                        skill: {
-                            id: `${scope}:${skill.name}`,
-                            name: skill.name,
-                            version: skill.version,
-                            source: sourceStr,
-                            installedAt: new Date().toISOString(),
-                        },
-                        message: `Updated "${skill.name}" to v${skill.version} in ${scope} scope.`,
-                    };
-                    return successResult(output.message);
+                if (updated.length > 0) {
+                    lines.push(`🔄 Updated ${updated.length} skill(s):`);
+                    for (const skill of updated) {
+                        lines.push(`   • ${skill.name} v${skill.version}`);
+                    }
                 }
-                // Add the skill
-                await store.addSkill(skill, {
-                    source: type === 'local' ? 'local' : 'import',
-                    sourceUrl: sourceStr,
-                });
-                const output = {
-                    success: true,
-                    skill: {
-                        id: `${scope}:${skill.name}`,
-                        name: skill.name,
-                        version: skill.version,
-                        source: sourceStr,
-                        installedAt: new Date().toISOString(),
-                    },
-                    message: `Successfully installed "${skill.name}" v${skill.version} to ${scope} scope.`,
-                };
-                return successResult(output.message);
+                if (skipped.length > 0) {
+                    lines.push(`⏭️  Skipped ${skipped.length} already installed skill(s)`);
+                }
+                // MCP requirements
+                if (result.mcpRequired.length > 0) {
+                    lines.push('');
+                    lines.push('⚠️  MCP servers required:');
+                    for (const mcp of result.mcpRequired) {
+                        lines.push(`   • ${mcp}`);
+                    }
+                    lines.push('   Configure these in your skillpkg.json or install manually.');
+                }
+                // Next steps
+                lines.push('');
+                lines.push('📋 Next steps:');
+                lines.push('   • Run `skillpkg sync` to sync to AI platforms');
+                lines.push('   • Run `skillpkg tree` to see dependency tree');
+                return successResult(lines.join('\n'));
             }
             catch (error) {
                 if (error instanceof InvalidSourceError) {