@withpica/mcp-server-directory 1.2.0 → 1.4.0

package/src/tools/skills.ts

@@ -0,0 +1,146 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+
+/**
+ * Directory MCP skill tools — ADR-140 Phase 2b
+ *
+ * Sister of mcp-server/src/tools/skills.ts. Two meta-tools — list and get —
+ * named `directory_skill_*` to match the directory MCP's `directory_*` prefix
+ * convention. Same lazy-loading shape as the creator MCP variant.
+ */
+
+import { ToolDefinition, ToolExecutor, ToolResult } from "./index.js";
+import { SkillsRegistry, SkillNotFoundError } from "../skills/index.js";
+
+export class DirectorySkillsTools {
+  private registry: SkillsRegistry;
+
+  constructor() {
+    this.registry = new SkillsRegistry();
+  }
+
+  getTools(): Array<{ definition: ToolDefinition; executor: ToolExecutor }> {
+    return [
+      {
+        definition: {
+          name: "directory_skill_list",
+          tier: "read",
+          description:
+            "Use when the user asks: 'what skills do you have?', 'what can you do?', 'show me your methodologies', 'how do I find music here?'. " +
+            "Returns the list of downloadable directory skill methodologies — name, description, trigger phrases. " +
+            "Cheap to call. Use directory_skill_get(name) to load a specific skill's full methodology body.",
+          inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+          },
+        },
+        executor: this.listSkills.bind(this),
+      },
+      {
+        definition: {
+          name: "directory_skill_get",
+          tier: "read",
+          description:
+            "Use when the user asks: 'what skills do you have?', 'what can you do?', 'show me your methodologies'. " +
+            "Returns the full methodology body for one directory skill — markdown with step-by-step instructions and tool chains. " +
+            "Call directory_skill_list first to see available skill names, then directory_skill_get to load one. Read once at the start of the workflow; do not re-fetch on every step.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              name: {
+                type: "string",
+                description:
+                  "Kebab-case skill name from directory_skill_list (e.g. 'find-music-for-sync-brief').",
+              },
+            },
+            required: ["name"],
+            additionalProperties: false,
+          },
+        },
+        executor: this.getSkill.bind(this),
+      },
+    ];
+  }
+
+  private async listSkills(_args: Record<string, any>): Promise<ToolResult> {
+    const skills = this.registry.listSkills();
+    return {
+      content: [
+        {
+          type: "text",
+          text: skills.length
+            ? `Available directory skills (${skills.length}):\n\n` +
+              skills
+                .map(
+                  (s) =>
+                    `- ${s.name} — ${s.description}\n  triggers: ${s.triggers.join(", ")}\n  audience: ${s.audience}`,
+                )
+                .join("\n\n") +
+              "\n\nCall directory_skill_get(name) to load a skill's full methodology."
+            : "No directory skills available.",
+        },
+      ],
+      structuredContent: { skills },
+    };
+  }
+
+  private async getSkill(args: Record<string, any>): Promise<ToolResult> {
+    const name = String(args?.name ?? "").trim();
+    if (!name) {
+      return {
+        isError: true,
+        content: [
+          {
+            type: "text",
+            text: "Missing required argument: name. Call directory_skill_list to see available skill names.",
+          },
+        ],
+      };
+    }
+    let skill;
+    try {
+      skill = this.registry.getSkill(name);
+    } catch (err) {
+      if (err instanceof SkillNotFoundError) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: `Skill not found: ${name}. Call directory_skill_list to see available skill names.`,
+            },
+          ],
+        };
+      }
+      throw err;
+    }
+    const frontmatterSummary = [
+      `# ${skill.name}`,
+      "",
+      `**Description:** ${skill.description}`,
+      `**Audience:** ${skill.audience}`,
+      `**Triggers:** ${skill.triggers.join(", ")}`,
+      `**Tools used:** ${skill.tools_required.join(", ")}`,
+      `**Output:** ${skill.output}`,
+      "",
+      "---",
+      "",
+    ].join("\n");
+    return {
+      content: [
+        {
+          type: "text",
+          text: frontmatterSummary + skill.body,
+        },
+      ],
+      structuredContent: {
+        name: skill.name,
+        description: skill.description,
+        triggers: skill.triggers,
+        audience: skill.audience,
+        tools_required: skill.tools_required,
+        output: skill.output,
+      },
+    };
+  }
+}