@codemcp/agentskills-mcp 1.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+MIT License
+
+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/dist/bin.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Executable entry point for Agent Skills MCP Server
+ *
+ * Usage: agentskills-mcp [project-directory]
+ *
+ * If no directory provided, uses current working directory.
+ * Reads package.json from project directory to load skill configuration.
+ * Skills are loaded from .agentskills/skills within the project directory.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * Executable entry point for Agent Skills MCP Server
+ *
+ * Usage: agentskills-mcp [project-directory]
+ *
+ * If no directory provided, uses current working directory.
+ * Reads package.json from project directory to load skill configuration.
+ * Skills are loaded from .agentskills/skills within the project directory.
+ */
+import { SkillRegistry, PackageConfigManager } from "@codemcp/agentskills-core";
+import { MCPServer } from "./server.js";
+import * as path from "node:path";
+import * as fs from "node:fs";
+async function main() {
+    // Get project directory from CLI args or use current directory
+    const projectDir = process.argv[2] || process.cwd();
+    // Validate project directory exists
+    if (!fs.existsSync(projectDir)) {
+        console.error(`Project directory not found: ${projectDir}`);
+        process.exit(1);
+    }
+    // Validate it's a directory
+    const projectStat = fs.statSync(projectDir);
+    if (!projectStat.isDirectory()) {
+        console.error(`Not a directory: ${projectDir}`);
+        process.exit(1);
+    }
+    try {
+        // Check if package.json exists
+        const packageJsonPath = path.join(projectDir, "package.json");
+        if (!fs.existsSync(packageJsonPath)) {
+            console.error(`package.json not found in: ${projectDir}`);
+            console.error(`\nPlease create a package.json with agentskills field:`);
+            console.error(`{`);
+            console.error(`  "name": "my-project",`);
+            console.error(`  "agentskills": {`);
+            console.error(`    "skill-name": "npm:package-name" or "file:./path"`);
+            console.error(`  }`);
+            console.error(`}`);
+            process.exit(1);
+        }
+        // Read package.json configuration
+        const configManager = new PackageConfigManager(projectDir);
+        const config = await configManager.loadConfig();
+        // Get skills directory from config (or use default)
+        const skillsDir = path.join(projectDir, config.config.skillsDirectory);
+        // Check if skills directory exists
+        if (!fs.existsSync(skillsDir)) {
+            console.error(`Skills directory not found: ${skillsDir}`);
+            console.error(`\nRun 'agentskills install' to install configured skills.`);
+            process.exit(1);
+        }
+        // Warn if no skills are configured
+        if (Object.keys(config.skills).length === 0) {
+            console.error(`Warning: No skills configured in package.json agentskills field`);
+            console.error(`The server will start but no skills will be available.`);
+        }
+        // Create registry and load skills
+        const registry = new SkillRegistry();
+        await registry.loadSkills(skillsDir);
+        // Create and start server
+        const server = new MCPServer(registry);
+        await server.start();
+        // Server is now running via stdio
+        // Keep process alive until stdin closes
+        process.stdin.on("close", () => {
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        // Only write to stderr if we haven't started stdio communication
+        process.stderr.write(`Failed to start MCP server: ${error}\n`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Agent Skills MCP Server
+ *
+ * This server exposes Agent Skills functionality through the Model Context Protocol (MCP).
+ * It provides tools for discovering, validating, and installing skills.
+ */
+export { MCPServer } from "./server.js";
+/**
+ * Main MCP server class for Agent Skills
+ *
+ * Minimal implementation to pass smoke tests.
+ * Will be expanded as we implement actual functionality.
+ *
+ * @deprecated Use MCPServer instead
+ */
+export declare class AgentSkillsServer {
+    constructor();
+}
+export default AgentSkillsServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;GAOG;AACH,qBAAa,iBAAiB;;CAI7B;AAGD,eAAe,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * Agent Skills MCP Server
+ *
+ * This server exposes Agent Skills functionality through the Model Context Protocol (MCP).
+ * It provides tools for discovering, validating, and installing skills.
+ */
+// Export the core MCPServer class
+export { MCPServer } from "./server.js";
+/**
+ * Main MCP server class for Agent Skills
+ *
+ * Minimal implementation to pass smoke tests.
+ * Will be expanded as we implement actual functionality.
+ *
+ * @deprecated Use MCPServer instead
+ */
+export class AgentSkillsServer {
+    constructor() {
+        // Minimal constructor for now
+    }
+}
+// Re-export for convenience and backward compatibility
+export default AgentSkillsServer;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kCAAkC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IAC5B;QACE,8BAA8B;IAChC,CAAC;CACF;AAED,uDAAuD;AACvD,eAAe,iBAAiB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,161 @@
+/**
+ * MCPServer - Core MCP server implementation for Agent Skills
+ *
+ * This class implements the Model Context Protocol (MCP) server that exposes
+ * Agent Skills as tools and resources. It uses the @modelcontextprotocol/sdk
+ * with stdio transport for communication with MCP clients.
+ *
+ * Architecture:
+ * - Uses McpServer from @modelcontextprotocol/sdk for MCP protocol handling
+ * - Accepts SkillRegistry via dependency injection (separation of concerns)
+ * - Announces capabilities: tools and resources
+ * - Routes requests to appropriate handlers
+ * - Server is immediately ready after construction (no explicit lifecycle)
+ */
+import { SkillRegistry } from "@codemcp/agentskills-core";
+/**
+ * MCPServer - Main server class for Agent Skills MCP integration
+ *
+ * Features:
+ * - Accepts SkillRegistry via dependency injection
+ * - Announces tools and resources capabilities
+ * - Server is "live" immediately upon construction
+ * - Routes tools/list, tools/call, resources/list, resources/read requests
+ * - Error handling without crashes
+ */
+export declare class MCPServer {
+    private mcpServer;
+    private registry;
+    private transport;
+    /**
+     * Creates a new MCPServer instance
+     *
+     * Note: Call start() to begin accepting MCP protocol messages.
+     *
+     * @param registry - Pre-initialized SkillRegistry instance
+     */
+    constructor(registry: SkillRegistry);
+    /**
+     * Start the MCP server and begin accepting protocol messages
+     *
+     * This connects the server to the stdio transport. The method returns
+     * immediately after connection is established. The server will continue
+     * running until stdin is closed.
+     */
+    start(): Promise<void>;
+    /**
+     * Register MCP request handlers
+     *
+     * Registers the use_skill tool for retrieving skill instructions.
+     * Registers resource handlers for exposing skills as MCP resources.
+     */
+    private registerHandlers;
+    /**
+     * Get all skill names from the registry
+     *
+     * @returns Array of skill names
+     */
+    private getSkillNames;
+    /**
+     * Get list of concrete resources (internal helper for MCP protocol)
+     *
+     * Returns all skills as concrete resources with skill:// URIs.
+     * Each skill is exposed as an individual resource for discovery.
+     *
+     * @returns Array of resource definitions for MCP protocol
+     */
+    private getResourcesList;
+    /**
+     * Get tool description with list of available skills
+     *
+     * Generates a dynamic description that includes all loaded skills
+     * with their descriptions for better discoverability.
+     *
+     * @returns Tool description string with skill list
+     */
+    private getToolDescription;
+    /**
+     * Handle use_skill tool execution
+     *
+     * Retrieves skill instructions for the requested skill.
+     * Returns only instructions - metadata is available via resources.
+     *
+     * @param args - Tool arguments with skill_name and optional arguments
+     * @returns MCP tool result with skill instructions
+     */
+    private handleUseSkillTool;
+    /**
+     * Get server capabilities
+     *
+     * @returns Server capabilities object
+     */
+    getCapabilities(): {
+        tools?: object;
+        resources?: object;
+    };
+    /**
+     * Get list of available tools
+     *
+     * Returns the use_skill tool definition with dynamic skill enumeration.
+     *
+     * @returns Array of tool definitions
+     */
+    getTools(): unknown[];
+    /**
+     * Call a tool
+     *
+     * Handles tool execution for use_skill tool.
+     *
+     * @param toolName - Name of the tool to call
+     * @param args - Arguments object for the tool
+     * @returns Tool execution result
+     */
+    callTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get list of resource templates (internal helper for MCP protocol)
+     *
+     * Returns a single template that covers all skills using the {skillName} pattern.
+     * Clients construct URIs dynamically using skill names from the tool's enum.
+     *
+     * @returns Array with single resource template for MCP protocol
+     */
+    private getResourceTemplatesList;
+    /**
+     * Handle resource read request (internal helper for MCP protocol)
+     *
+     * Parses skill:// URIs and returns SKILL.md content.
+     *
+     * @param uri - Resource URI (skill://<name>)
+     * @returns MCP resource content response
+     */
+    private handleReadResource;
+    /**
+     * Get list of resources
+     *
+     * Returns concrete list of all skills as resources. This method is for testing and
+     * external callers. The MCP protocol uses getResourcesList internally.
+     *
+     * @returns Array of resource definitions
+     */
+    getResources(): unknown[];
+    /**
+     * Get list of resource templates
+     *
+     * Returns resource templates for skills. This method is for testing and
+     * external callers. The MCP protocol uses getResourceTemplatesList internally.
+     *
+     * @returns Array of resource template definitions
+     */
+    getResourceTemplates(): unknown[];
+    /**
+     * Read a resource
+     *
+     * Reads a skill resource by URI. This method is for testing and
+     * external callers. The MCP protocol uses handleReadResource internally.
+     *
+     * @param uri - Resource URI
+     * @returns Resource content
+     */
+    readResource(uri: string): Promise<unknown>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ1D;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAuB;IAExC;;;;;;OAMG;gBACS,QAAQ,EAAE,aAAa;IAwBnC;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAyExB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAKrB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;;;;;;;OAQG;YACW,kBAAkB;IAwBhC;;;;OAIG;IACH,eAAe,IAAI;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAOzD;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO,EAAE;IAwBrB;;;;;;;;OAQG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC;IAmBnB;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB;IA0ChC;;;;;;;OAOG;YACW,kBAAkB;IA4BhC;;;;;;;OAOG;IACH,YAAY,IAAI,OAAO,EAAE;IAIzB;;;;;;;OAOG;IACH,oBAAoB,IAAI,OAAO,EAAE;IAIjC;;;;;;;;OAQG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUlD"}

package/dist/server.js

@@ -0,0 +1,361 @@
+/**
+ * MCPServer - Core MCP server implementation for Agent Skills
+ *
+ * This class implements the Model Context Protocol (MCP) server that exposes
+ * Agent Skills as tools and resources. It uses the @modelcontextprotocol/sdk
+ * with stdio transport for communication with MCP clients.
+ *
+ * Architecture:
+ * - Uses McpServer from @modelcontextprotocol/sdk for MCP protocol handling
+ * - Accepts SkillRegistry via dependency injection (separation of concerns)
+ * - Announces capabilities: tools and resources
+ * - Routes requests to appropriate handlers
+ * - Server is immediately ready after construction (no explicit lifecycle)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * MCPServer - Main server class for Agent Skills MCP integration
+ *
+ * Features:
+ * - Accepts SkillRegistry via dependency injection
+ * - Announces tools and resources capabilities
+ * - Server is "live" immediately upon construction
+ * - Routes tools/list, tools/call, resources/list, resources/read requests
+ * - Error handling without crashes
+ */
+export class MCPServer {
+    mcpServer;
+    registry;
+    transport;
+    /**
+     * Creates a new MCPServer instance
+     *
+     * Note: Call start() to begin accepting MCP protocol messages.
+     *
+     * @param registry - Pre-initialized SkillRegistry instance
+     */
+    constructor(registry) {
+        this.registry = registry;
+        // Initialize MCP server with capabilities
+        this.mcpServer = new McpServer({
+            name: "agent-skills-mcp-server",
+            version: "0.1.0"
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {}
+            }
+        });
+        // Register handlers BEFORE connecting (required by SDK)
+        this.registerHandlers();
+        // Create stdio transport
+        this.transport = new StdioServerTransport();
+    }
+    /**
+     * Start the MCP server and begin accepting protocol messages
+     *
+     * This connects the server to the stdio transport. The method returns
+     * immediately after connection is established. The server will continue
+     * running until stdin is closed.
+     */
+    async start() {
+        await this.mcpServer.connect(this.transport);
+    }
+    /**
+     * Register MCP request handlers
+     *
+     * Registers the use_skill tool for retrieving skill instructions.
+     * Registers resource handlers for exposing skills as MCP resources.
+     */
+    registerHandlers() {
+        // Get skill names for enum
+        const skillNames = this.getSkillNames();
+        // Register use_skill tool with Zod schema
+        this.mcpServer.registerTool("use_skill", {
+            description: this.getToolDescription(),
+            inputSchema: {
+                skill_name: z
+                    .enum(skillNames.length > 0
+                    ? skillNames
+                    : ["_no_skills_available"])
+                    .describe("Name of the skill to retrieve"),
+                arguments: z
+                    .object({})
+                    .passthrough()
+                    .optional()
+                    .describe("Optional arguments for skill execution context")
+            }
+        }, async (args) => {
+            return this.handleUseSkillTool(args);
+        });
+        // Access underlying server for resource capabilities
+        // Using type assertion as the SDK doesn't expose these methods directly
+        const underlyingServer = this.mcpServer.server;
+        // Register resource capabilities via the underlying server
+        underlyingServer.registerCapabilities({
+            resources: {}
+        });
+        // Register resources/list handler (concrete resources)
+        underlyingServer.setRequestHandler(ListResourcesRequestSchema, async () => ({
+            resources: this.getResourcesList()
+        }));
+        // Register resources/templates/list handler via the underlying server
+        underlyingServer.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+            resourceTemplates: this.getResourceTemplatesList()
+        }));
+        // Register resources/read handler via the underlying server
+        underlyingServer.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            return this.handleReadResource(request.params.uri);
+        });
+    }
+    /**
+     * Get all skill names from the registry
+     *
+     * @returns Array of skill names
+     */
+    getSkillNames() {
+        const metadata = this.registry.getAllMetadata();
+        return metadata.map((m) => m.name);
+    }
+    /**
+     * Get list of concrete resources (internal helper for MCP protocol)
+     *
+     * Returns all skills as concrete resources with skill:// URIs.
+     * Each skill is exposed as an individual resource for discovery.
+     *
+     * @returns Array of resource definitions for MCP protocol
+     */
+    getResourcesList() {
+        const skills = this.registry.getAllMetadata();
+        return skills.map((skill) => ({
+            uri: `skill://${skill.name}`,
+            name: skill.name,
+            description: skill.description,
+            mimeType: "text/markdown"
+        }));
+    }
+    /**
+     * Get tool description with list of available skills
+     *
+     * Generates a dynamic description that includes all loaded skills
+     * with their descriptions for better discoverability.
+     *
+     * @returns Tool description string with skill list
+     */
+    getToolDescription() {
+        const skills = this.registry.getAllMetadata();
+        const instruction = "You've got skills! Use them whenever their description matches what you need to accomplish.";
+        if (skills.length === 0) {
+            return `${instruction} No skills currently loaded.`;
+        }
+        const skillList = skills
+            .map((skill) => `- ${skill.name}: ${skill.description}`)
+            .join("\n");
+        return `${instruction}
+
+Available skills:
+${skillList}`;
+    }
+    /**
+     * Handle use_skill tool execution
+     *
+     * Retrieves skill instructions for the requested skill.
+     * Returns only instructions - metadata is available via resources.
+     *
+     * @param args - Tool arguments with skill_name and optional arguments
+     * @returns MCP tool result with skill instructions
+     */
+    async handleUseSkillTool(args) {
+        const skillName = args.skill_name;
+        // Get skill from registry
+        const skill = this.registry.getSkill(skillName);
+        if (!skill) {
+            throw new Error(`Skill not found: ${skillName}`);
+        }
+        // Return ONLY instructions - simple and clean
+        // Metadata is available via resources for discovery
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ instructions: skill.body }, null, 2)
+                }
+            ]
+        };
+    }
+    /**
+     * Get server capabilities
+     *
+     * @returns Server capabilities object
+     */
+    getCapabilities() {
+        return {
+            tools: {},
+            resources: {}
+        };
+    }
+    /**
+     * Get list of available tools
+     *
+     * Returns the use_skill tool definition with dynamic skill enumeration.
+     *
+     * @returns Array of tool definitions
+     */
+    getTools() {
+        return [
+            {
+                name: "use_skill",
+                description: this.getToolDescription(),
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        skill_name: {
+                            type: "string",
+                            description: "Name of the skill to retrieve",
+                            enum: this.getSkillNames()
+                        },
+                        arguments: {
+                            type: "object",
+                            description: "Optional arguments for skill execution context"
+                        }
+                    },
+                    required: ["skill_name"]
+                }
+            }
+        ];
+    }
+    /**
+     * Call a tool
+     *
+     * Handles tool execution for use_skill tool.
+     *
+     * @param toolName - Name of the tool to call
+     * @param args - Arguments object for the tool
+     * @returns Tool execution result
+     */
+    async callTool(toolName, args) {
+        try {
+            if (toolName === "use_skill") {
+                return await this.handleUseSkillTool(args);
+            }
+            // Return error for unknown tools
+            return {
+                isError: true,
+                error: `Unknown tool: ${toolName}`
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                error: error instanceof Error ? error.message : "Unknown error"
+            };
+        }
+    }
+    /**
+     * Get list of resource templates (internal helper for MCP protocol)
+     *
+     * Returns a single template that covers all skills using the {skillName} pattern.
+     * Clients construct URIs dynamically using skill names from the tool's enum.
+     *
+     * @returns Array with single resource template for MCP protocol
+     */
+    getResourceTemplatesList() {
+        // Get skill names for enum (reuse same method as tool)
+        const skillNames = this.getSkillNames();
+        return [
+            {
+                uriTemplate: "skill://{skillName}",
+                name: "Agent Skill",
+                description: "Access skill instructions and metadata. Use skill names from the use_skill tool's skill_name parameter.",
+                mimeType: "text/markdown",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        skillName: {
+                            type: "string",
+                            enum: skillNames,
+                            description: "Name of the skill to retrieve"
+                        }
+                    },
+                    required: ["skillName"]
+                }
+            }
+        ];
+    }
+    /**
+     * Handle resource read request (internal helper for MCP protocol)
+     *
+     * Parses skill:// URIs and returns SKILL.md content.
+     *
+     * @param uri - Resource URI (skill://<name>)
+     * @returns MCP resource content response
+     */
+    async handleReadResource(uri) {
+        // Parse URI: skill://<name> or skill://<name>/SKILL.md
+        const match = uri.match(/^skill:\/\/([^/]+)/);
+        if (!match) {
+            throw new Error(`Invalid skill URI: ${uri}`);
+        }
+        const skillName = match[1];
+        const skill = this.registry.getSkill(skillName);
+        if (!skill) {
+            throw new Error(`Skill not found: ${skillName}`);
+        }
+        // Return full SKILL.md content
+        return {
+            contents: [
+                {
+                    uri: uri,
+                    mimeType: "text/markdown",
+                    text: skill.body
+                }
+            ]
+        };
+    }
+    /**
+     * Get list of resources
+     *
+     * Returns concrete list of all skills as resources. This method is for testing and
+     * external callers. The MCP protocol uses getResourcesList internally.
+     *
+     * @returns Array of resource definitions
+     */
+    getResources() {
+        return this.getResourcesList();
+    }
+    /**
+     * Get list of resource templates
+     *
+     * Returns resource templates for skills. This method is for testing and
+     * external callers. The MCP protocol uses getResourceTemplatesList internally.
+     *
+     * @returns Array of resource template definitions
+     */
+    getResourceTemplates() {
+        return this.getResourceTemplatesList();
+    }
+    /**
+     * Read a resource
+     *
+     * Reads a skill resource by URI. This method is for testing and
+     * external callers. The MCP protocol uses handleReadResource internally.
+     *
+     * @param uri - Resource URI
+     * @returns Resource content
+     */
+    async readResource(uri) {
+        try {
+            return await this.handleReadResource(uri);
+        }
+        catch (error) {
+            return {
+                isError: true,
+                error: error instanceof Error ? error.message : "Unknown error"
+            };
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@codemcp/agentskills-mcp",
+  "version": "1.1.0",
+  "description": "MCP server implementation for Agent Skills",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "agentskills-mcp": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.19.1",
+    "zod": "4.3.6",
+    "@codemcp/agentskills-core": "1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "@typescript-eslint/eslint-plugin": "^8.21.0",
+    "@typescript-eslint/parser": "^8.21.0",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "prettier": "^3.4.2",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "8.21.0",
+    "vitest": "^3.0.3"
+  },
+  "keywords": [
+    "agentskills",
+    "mcp",
+    "server"
+  ],
+  "author": "Oliver Jägle <github@beimir.net>",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "clean:build": "rimraf dist",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --check .",
+    "format:fix": "prettier --write .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}