feat: Add create-expert CLI and create-expert-skill MCP server

.changeset/create-expert-skill.md

@@ -0,0 +1,6 @@
+---
+"perstack": patch
+"create-expert": patch
+---
+
+Add create-expert CLI and create-expert-skill MCP server for creating and test-running expert definitions

.gitignore

@@ -23,6 +23,7 @@ perstack.lock
 perstack.toml
 !examples/**/perstack.toml
 !benchmarks/**/perstack.toml
+!apps/create-expert/perstack.toml
 perstack/
 !apps/perstack
 Thumbs.db

apps/create-expert-skill/bin/server.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
+import { Command } from "commander"
+import packageJson from "../package.json" with { type: "json" }
+import { createCreateExpertSkillServer } from "../src/server.js"
+
+async function main() {
+  const program = new Command()
+  program
+    .name(packageJson.name)
+    .description(packageJson.description)
+    .version(packageJson.version, "-v, --version", "display the version number")
+    .action(async () => {
+      const server = createCreateExpertSkillServer()
+      const transport = new StdioServerTransport()
+      console.error("Running @perstack/create-expert-skill version", packageJson.version)
+      await server.connect(transport)
+    })
+  program.parse()
+}
+main()

apps/create-expert-skill/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@perstack/create-expert-skill",
+  "version": "0.0.1",
+  "description": "MCP skill for testing Perstack expert definitions",
+  "author": "Wintermute Technologies, Inc.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "bin": {
+      "@perstack/create-expert-skill": "dist/bin/server.js"
+    },
+    "exports": {
+      ".": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "pnpm run clean && tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "commander": "^14.0.2",
+    "ts-dedent": "^2.2.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@tsconfig/node22": "^22.0.5",
+    "@types/node": "^25.0.10",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}

apps/create-expert-skill/src/index.ts

@@ -0,0 +1,7 @@
+export {
+  createCreateExpertSkillServer,
+  registerAllTools,
+  SKILL_NAME,
+  SKILL_VERSION,
+} from "./server.js"
+export { registerRunExpert, runExpert } from "./tools/run-expert.js"

apps/create-expert-skill/src/lib/tool-result.ts

@@ -0,0 +1,11 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js"
+
+export function successToolResult(result: unknown): CallToolResult {
+  return { content: [{ type: "text", text: JSON.stringify(result) }] }
+}
+
+export function errorToolResult(e: Error): CallToolResult {
+  return {
+    content: [{ type: "text", text: JSON.stringify({ error: e.name, message: e.message }) }],
+  }
+}

apps/create-expert-skill/src/server.ts

@@ -0,0 +1,26 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
+import packageJson from "../package.json" with { type: "json" }
+import { registerRunExpert } from "./tools/run-expert.js"
+
+export const SKILL_NAME = packageJson.name
+export const SKILL_VERSION = packageJson.version
+
+export function registerAllTools(server: McpServer): void {
+  registerRunExpert(server)
+}
+
+export function createCreateExpertSkillServer(): McpServer {
+  const server = new McpServer(
+    {
+      name: SKILL_NAME,
+      version: SKILL_VERSION,
+    },
+    {
+      capabilities: {
+        tools: {},
+      },
+    },
+  )
+  registerAllTools(server)
+  return server
+}