@hasna/skills 0.0.3 → 0.0.4

package/src/mcp/index.ts

@@ -1,234 +0,0 @@
-#!/usr/bin/env bun
-/**
- * MCP server for the skills library.
- * Exposes tools for listing, searching, and installing skills.
- *
- * Usage:
- *   skills mcp          # Start MCP server on stdio
- *   skills-mcp          # Direct binary
- */
-
-import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import {
-  SKILLS,
-  CATEGORIES,
-  getSkill,
-  getSkillsByCategory,
-  searchSkills,
-} from "../lib/registry.js";
-import {
-  installSkill,
-  installSkillForAgent,
-  removeSkill,
-  removeSkillForAgent,
-  AGENT_TARGETS,
-  type AgentTarget,
-} from "../lib/installer.js";
-import {
-  getSkillDocs,
-  getSkillBestDoc,
-  getSkillRequirements,
-  generateSkillMd,
-} from "../lib/skillinfo.js";
-
-const server = new McpServer({
-  name: "skills",
-  version: "0.0.3",
-});
-
-// ---- Tools ----
-
-server.registerTool("list_skills", {
-  title: "List Skills",
-  description: "List all available skills, optionally filtered by category",
-  inputSchema: {
-    category: z.string().optional().describe("Filter by category name"),
-  },
-}, async ({ category }) => {
-  const skills = category
-    ? getSkillsByCategory(category)
-    : SKILLS;
-
-  return {
-    content: [{ type: "text", text: JSON.stringify(skills, null, 2) }],
-  };
-});
-
-server.registerTool("search_skills", {
-  title: "Search Skills",
-  description: "Search skills by query string (matches name, description, and tags)",
-  inputSchema: {
-    query: z.string().describe("Search query"),
-  },
-}, async ({ query }) => {
-  const results = searchSkills(query);
-  return {
-    content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
-  };
-});
-
-server.registerTool("get_skill_info", {
-  title: "Get Skill Info",
-  description: "Get detailed metadata about a skill including requirements, env vars, and dependencies",
-  inputSchema: {
-    name: z.string().describe("Skill name (e.g. 'image', 'deep-research')"),
-  },
-}, async ({ name }) => {
-  const skill = getSkill(name);
-  if (!skill) {
-    return { content: [{ type: "text", text: `Skill '${name}' not found` }], isError: true };
-  }
-
-  const reqs = getSkillRequirements(name);
-  return {
-    content: [{ type: "text", text: JSON.stringify({ ...skill, ...reqs }, null, 2) }],
-  };
-});
-
-server.registerTool("get_skill_docs", {
-  title: "Get Skill Docs",
-  description: "Get documentation for a skill (SKILL.md, README.md, or CLAUDE.md)",
-  inputSchema: {
-    name: z.string().describe("Skill name"),
-  },
-}, async ({ name }) => {
-  const doc = getSkillBestDoc(name);
-  if (!doc) {
-    return { content: [{ type: "text", text: `No documentation found for '${name}'` }], isError: true };
-  }
-  return { content: [{ type: "text", text: doc }] };
-});
-
-server.registerTool("install_skill", {
-  title: "Install Skill",
-  description: "Install a skill. Without --for, installs full source to .skills/. With --for, copies SKILL.md to agent skill directory.",
-  inputSchema: {
-    name: z.string().describe("Skill name to install"),
-    for: z.string().optional().describe("Agent target: claude, codex, gemini, or all"),
-    scope: z.string().optional().describe("Install scope: global or project (default: global)"),
-  },
-}, async ({ name, for: agent, scope }) => {
-  if (agent) {
-    const agents: AgentTarget[] = agent === "all"
-      ? [...AGENT_TARGETS]
-      : [agent as AgentTarget];
-
-    const results = agents.map(a =>
-      installSkillForAgent(name, { agent: a, scope: (scope as "global" | "project") || "global" }, generateSkillMd)
-    );
-
-    return {
-      content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
-      isError: results.some(r => !r.success),
-    };
-  }
-
-  const result = installSkill(name);
-  return {
-    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-    isError: !result.success,
-  };
-});
-
-server.registerTool("remove_skill", {
-  title: "Remove Skill",
-  description: "Remove an installed skill. Without --for, removes from .skills/. With --for, removes from agent skill directory.",
-  inputSchema: {
-    name: z.string().describe("Skill name to remove"),
-    for: z.string().optional().describe("Agent target: claude, codex, gemini, or all"),
-    scope: z.string().optional().describe("Remove scope: global or project (default: global)"),
-  },
-}, async ({ name, for: agent, scope }) => {
-  if (agent) {
-    const agents: AgentTarget[] = agent === "all"
-      ? [...AGENT_TARGETS]
-      : [agent as AgentTarget];
-
-    const results = agents.map(a => ({
-      skill: name,
-      agent: a,
-      removed: removeSkillForAgent(name, { agent: a, scope: (scope as "global" | "project") || "global" }),
-    }));
-
-    return {
-      content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
-    };
-  }
-
-  const removed = removeSkill(name);
-  return {
-    content: [{ type: "text", text: JSON.stringify({ skill: name, removed }, null, 2) }],
-  };
-});
-
-server.registerTool("list_categories", {
-  title: "List Categories",
-  description: "List all skill categories with counts",
-}, async () => {
-  const cats = CATEGORIES.map(category => ({
-    name: category,
-    count: getSkillsByCategory(category).length,
-  }));
-  return { content: [{ type: "text", text: JSON.stringify(cats, null, 2) }] };
-});
-
-server.registerTool("get_requirements", {
-  title: "Get Requirements",
-  description: "Get environment variables, system dependencies, and npm dependencies for a skill",
-  inputSchema: {
-    name: z.string().describe("Skill name"),
-  },
-}, async ({ name }) => {
-  const reqs = getSkillRequirements(name);
-  if (!reqs) {
-    return { content: [{ type: "text", text: `Skill '${name}' not found` }], isError: true };
-  }
-  return { content: [{ type: "text", text: JSON.stringify(reqs, null, 2) }] };
-});
-
-// ---- Resources ----
-
-server.registerResource("Skills Registry", "skills://registry", {
-  description: "Full list of all available skills as JSON",
-}, async () => ({
-  contents: [{
-    uri: "skills://registry",
-    text: JSON.stringify(SKILLS, null, 2),
-    mimeType: "application/json",
-  }],
-}));
-
-server.registerResource(
-  "Skill Info",
-  new ResourceTemplate("skills://{name}", { list: undefined }),
-  {
-    description: "Individual skill metadata and documentation",
-  },
-  async (uri, { name }) => {
-    const skill = getSkill(name as string);
-    const doc = getSkillBestDoc(name as string);
-    const reqs = getSkillRequirements(name as string);
-
-    return {
-      contents: [{
-        uri: uri.href,
-        text: JSON.stringify({ ...skill, documentation: doc, requirements: reqs }, null, 2),
-        mimeType: "application/json",
-      }],
-    };
-  }
-);
-
-// ---- Start server ----
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch((error) => {
-  console.error("MCP server error:", error);
-  process.exit(1);
-});

package/src/mcp/mcp.test.ts

@@ -1,212 +0,0 @@
-import { describe, test, expect } from "bun:test";
-import { join } from "path";
-
-const MCP_PATH = join(import.meta.dir, "index.ts");
-
-/**
- * Helper class to communicate with the MCP server over stdio.
- */
-class McpClient {
-  private proc: ReturnType<typeof Bun.spawn>;
-  private buffer = "";
-  private messages: any[] = [];
-  private reader: ReadableStreamDefaultReader<Uint8Array>;
-
-  constructor() {
-    this.proc = Bun.spawn(["bun", "run", MCP_PATH], {
-      stdin: "pipe",
-      stdout: "pipe",
-      stderr: "pipe",
-      env: { ...process.env, NO_COLOR: "1" },
-    });
-    this.reader = this.proc.stdout.getReader();
-    this._readLoop();
-  }
-
-  private async _readLoop() {
-    const decoder = new TextDecoder();
-    try {
-      while (true) {
-        const { done, value } = await this.reader.read();
-        if (done) break;
-        this.buffer += decoder.decode(value, { stream: true });
-        // Parse complete lines
-        const lines = this.buffer.split("\n");
-        this.buffer = lines.pop()!; // Keep incomplete line
-        for (const line of lines) {
-          if (line.trim()) {
-            try {
-              this.messages.push(JSON.parse(line));
-            } catch {}
-          }
-        }
-      }
-    } catch {}
-  }
-
-  send(msg: any) {
-    this.proc.stdin.write(JSON.stringify(msg) + "\n");
-  }
-
-  async waitForMessage(id: number, timeout = 8000): Promise<any> {
-    const start = Date.now();
-    while (Date.now() - start < timeout) {
-      const found = this.messages.find(m => m.id === id);
-      if (found) return found;
-      await new Promise(r => setTimeout(r, 50));
-    }
-    return null;
-  }
-
-  async initialize(): Promise<void> {
-    this.send({
-      jsonrpc: "2.0",
-      id: 1,
-      method: "initialize",
-      params: {
-        protocolVersion: "2025-03-26",
-        capabilities: {},
-        clientInfo: { name: "test", version: "1.0" },
-      },
-    });
-    await this.waitForMessage(1);
-    this.send({
-      jsonrpc: "2.0",
-      method: "notifications/initialized",
-    });
-    // Give server time to process notification
-    await new Promise(r => setTimeout(r, 100));
-  }
-
-  async request(method: string, params: Record<string, unknown> = {}, id = 2): Promise<any> {
-    this.send({ jsonrpc: "2.0", id, method, params });
-    return this.waitForMessage(id);
-  }
-
-  async close() {
-    try {
-      this.reader.cancel();
-      this.proc.stdin.end();
-      this.proc.kill();
-      await this.proc.exited;
-    } catch {}
-  }
-}
-
-describe("MCP Server", () => {
-  test("lists tools", async () => {
-    const client = new McpClient();
-    try {
-      await client.initialize();
-      const response = await client.request("tools/list");
-      expect(response).not.toBeNull();
-      expect(response.result).toBeDefined();
-      const tools = response.result.tools;
-      expect(Array.isArray(tools)).toBe(true);
-
-      const toolNames = tools.map((t: any) => t.name);
-      expect(toolNames).toContain("list_skills");
-      expect(toolNames).toContain("search_skills");
-      expect(toolNames).toContain("get_skill_info");
-      expect(toolNames).toContain("get_skill_docs");
-      expect(toolNames).toContain("install_skill");
-      expect(toolNames).toContain("remove_skill");
-      expect(toolNames).toContain("list_categories");
-      expect(toolNames).toContain("get_requirements");
-    } finally {
-      await client.close();
-    }
-  }, 15000);
-
-  test("lists resources", async () => {
-    const client = new McpClient();
-    try {
-      await client.initialize();
-      const response = await client.request("resources/list");
-      expect(response).not.toBeNull();
-      expect(response.result).toBeDefined();
-      const resources = response.result.resources;
-      expect(Array.isArray(resources)).toBe(true);
-
-      const uris = resources.map((r: any) => r.uri);
-      expect(uris).toContain("skills://registry");
-    } finally {
-      await client.close();
-    }
-  }, 15000);
-
-  test("calls list_categories tool", async () => {
-    const client = new McpClient();
-    try {
-      await client.initialize();
-      const response = await client.request("tools/call", {
-        name: "list_categories",
-        arguments: {},
-      });
-      expect(response).not.toBeNull();
-      expect(response.result).toBeDefined();
-      const content = response.result.content;
-      expect(Array.isArray(content)).toBe(true);
-      const categories = JSON.parse(content[0].text);
-      expect(Array.isArray(categories)).toBe(true);
-      expect(categories.length).toBe(17);
-      expect(categories[0]).toHaveProperty("name");
-      expect(categories[0]).toHaveProperty("count");
-    } finally {
-      await client.close();
-    }
-  }, 15000);
-
-  test("calls search_skills tool", async () => {
-    const client = new McpClient();
-    try {
-      await client.initialize();
-      const response = await client.request("tools/call", {
-        name: "search_skills",
-        arguments: { query: "image" },
-      });
-      expect(response).not.toBeNull();
-      expect(response.result).toBeDefined();
-      const results = JSON.parse(response.result.content[0].text);
-      expect(Array.isArray(results)).toBe(true);
-      expect(results.length).toBeGreaterThan(0);
-    } finally {
-      await client.close();
-    }
-  }, 15000);
-
-  test("calls get_skill_info tool", async () => {
-    const client = new McpClient();
-    try {
-      await client.initialize();
-      const response = await client.request("tools/call", {
-        name: "get_skill_info",
-        arguments: { name: "image" },
-      });
-      expect(response).not.toBeNull();
-      expect(response.result).toBeDefined();
-      const info = JSON.parse(response.result.content[0].text);
-      expect(info.name).toBe("image");
-      expect(info.displayName).toBeDefined();
-      expect(info.category).toBeDefined();
-    } finally {
-      await client.close();
-    }
-  }, 15000);
-
-  test("returns error for nonexistent skill", async () => {
-    const client = new McpClient();
-    try {
-      await client.initialize();
-      const response = await client.request("tools/call", {
-        name: "get_skill_info",
-        arguments: { name: "nonexistent-xyz" },
-      });
-      expect(response).not.toBeNull();
-      expect(response.result).toBeDefined();
-      expect(response.result.isError).toBe(true);
-    } finally {
-      await client.close();
-    }
-  }, 15000);
-});

package/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "jsx": "react-jsx",
-    "types": ["bun-types", "react"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "bin", "skills"]
-}