@frontmcp/skills 0.0.1 → 1.0.0-beta.11

package/catalog/skills-manifest.json

@@ -2,413 +2,368 @@
   "version": 1,
   "skills": [
     {
-      "name": "frontmcp-skills-usage",
-      "category": "setup",
-      "description": "Search, install, and manage FrontMCP development skills for Claude Code and Codex. Use when setting up skills for AI-assisted development, choosing between static and dynamic skill delivery, or configuring skill providers.",
-      "path": "setup/frontmcp-skills-usage",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["skills", "cli", "install", "claude", "codex", "search", "catalog"],
-      "bundle": ["recommended", "minimal", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills", "codex"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "setup-project",
-      "category": "setup",
-      "description": "Scaffold and configure a new FrontMCP MCP server project. Use when creating a new project, setting up @FrontMcp and @App decorators, or choosing a deployment target.",
-      "path": "setup/setup-project",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["setup", "project", "scaffold", "getting-started"],
-      "bundle": ["recommended", "minimal", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "setup-redis",
-      "category": "setup",
-      "description": "Configure Redis for session storage and distributed state management. Use when adding Redis, Docker Redis, Vercel KV, or setting up pub/sub for resource subscriptions.",
-      "path": "setup/setup-redis",
-      "targets": ["node", "vercel"],
-      "hasResources": false,
-      "storageDefault": { "node": "redis-docker", "vercel": "vercel-kv" },
-      "tags": ["setup", "redis", "storage", "session"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite", "dependencies": ["setup-project"] }
-    },
-    {
-      "name": "setup-sqlite",
-      "category": "setup",
-      "description": "Configure SQLite for local development and single-instance deployments. Use when setting up local storage, CLI tools, unix-socket daemons, or WAL mode.",
-      "path": "setup/setup-sqlite",
-      "targets": ["node"],
-      "hasResources": false,
-      "storageDefault": { "node": "sqlite" },
-      "tags": ["setup", "sqlite", "storage", "local"],
-      "bundle": ["minimal", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite", "dependencies": ["setup-project"] }
-    },
-    {
-      "name": "multi-app-composition",
-      "category": "setup",
-      "description": "Compose multiple apps in a single server with shared tools, scoped auth, and external app loading. Use when building multi-app servers, sharing tools between apps, loading ESM or remote apps, or configuring per-app auth.",
-      "path": "setup/multi-app-composition",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["multi-app", "composition", "architecture", "scope", "shared-tools"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "nx-workflow",
-      "category": "setup",
-      "description": "Complete Nx monorepo workflow for FrontMCP with all generators, build, test, and deployment commands. Use when working in an Nx workspace, running generators, or managing monorepo builds.",
-      "path": "setup/nx-workflow",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["nx", "monorepo", "generators", "workflow", "scaffold"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "project-structure-standalone",
-      "category": "setup",
-      "description": "Best practices for organizing a standalone FrontMCP project — file layout, naming conventions, and folder hierarchy. Use when scaffolding with frontmcp create or organizing an existing standalone project.",
-      "path": "setup/project-structure-standalone",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["project", "structure", "standalone", "organization", "best-practices"],
-      "bundle": ["recommended", "minimal", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "project-structure-nx",
-      "category": "setup",
-      "description": "Best practices for organizing a FrontMCP Nx monorepo — apps, libs, servers, generators, and multi-app composition. Use when working with frontmcp create --nx or an Nx workspace.",
-      "path": "setup/project-structure-nx",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["project", "structure", "nx", "monorepo", "organization", "best-practices"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "configure-transport",
+      "name": "frontmcp-config",
       "category": "config",
-      "description": "Choose and configure transport protocols — SSE, Streamable HTTP, stateless API, or legacy. Use when deciding between transport modes, enabling distributed sessions, or configuring event stores.",
-      "path": "config/configure-transport",
+      "description": "Use when you want to configure auth, set up CORS, add rate limiting, throttle requests, manage sessions, choose transport, set HTTP options, add authentication, configure JWT, or set up OAuth. The skill for server CONFIGURATION.",
+      "path": "frontmcp-config",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["transport", "sse", "streamable-http", "stateless", "protocol", "session"],
+      "tags": ["router", "config", "transport", "http", "auth", "session", "redis", "sqlite", "throttle", "guide"],
       "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "configure-elicitation",
-      "category": "config",
-      "description": "Enable interactive user input requests from tools during execution. Use when tools need to ask the user for confirmation, choices, or additional data mid-execution.",
-      "path": "config/configure-elicitation",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["elicitation", "user-input", "interactive", "confirmation", "form"],
-      "bundle": ["full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "configure-http",
-      "category": "config",
-      "description": "Configure HTTP server options including port, CORS, unix sockets, and entry path. Use when customizing the HTTP listener, enabling CORS, or binding to a unix socket.",
-      "path": "config/configure-http",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["http", "cors", "port", "socket", "server", "configuration"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "configure-throttle",
-      "category": "config",
-      "description": "Set up rate limiting, concurrency control, timeouts, and IP filtering at server and per-tool level. Use when protecting against abuse, limiting request rates, or configuring IP allow/deny lists.",
-      "path": "config/configure-throttle",
+      "references": [
+        {
+          "name": "configure-auth-modes",
+          "description": "Detailed comparison of public, transparent, remote, and managed auth modes"
+        },
+        {
+          "name": "configure-auth",
+          "description": "Set up authentication modes, credential vault, and OAuth flows for FrontMCP servers"
+        },
+        {
+          "name": "configure-elicitation",
+          "description": "Configure interactive user input during tool execution for confirmations, choices, and forms"
+        },
+        {
+          "name": "configure-http",
+          "description": "Configure HTTP server port, CORS policy, unix sockets, and entry path prefix"
+        },
+        {
+          "name": "configure-session",
+          "description": "Set up session storage with Redis or Vercel KV for persistent user state across requests"
+        },
+        {
+          "name": "configure-throttle-guard-config",
+          "description": "Complete GuardConfig interface reference for rate limiting, concurrency, and IP filtering"
+        },
+        {
+          "name": "configure-throttle",
+          "description": "Protect servers with rate limiting, concurrency control, execution timeouts, and IP filtering"
+        },
+        {
+          "name": "configure-transport-protocol-presets",
+          "description": "Reference for legacy, modern, stateless, and minimal transport protocol presets"
+        },
+        {
+          "name": "configure-transport",
+          "description": "Configure client transport protocols including SSE, Streamable HTTP, and stateless API modes"
+        },
+        {
+          "name": "setup-redis",
+          "description": "Cross-reference to the full Redis configuration guide in frontmcp-setup"
+        },
+        {
+          "name": "setup-sqlite",
+          "description": "Cross-reference to the full SQLite configuration guide in frontmcp-setup"
+        }
+      ]
+    },
+    {
+      "name": "frontmcp-deployment",
+      "category": "deployment",
+      "description": "Use when you need to deploy, build for production, containerize, or ship a FrontMCP server. Covers Vercel, Lambda, Cloudflare, Docker, edge runtime, serverless, bundle for CLI, and Node targets. Triggers: deploy, build for production, dockerize, serverless, go live.",
+      "path": "frontmcp-deployment",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["throttle", "rate-limit", "concurrency", "timeout", "security", "guard", "ip-filter"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "decorators-guide",
-      "category": "development",
-      "description": "Complete reference for all FrontMCP decorators and when to use each one. Use when choosing between decorators, understanding the architecture, or looking up decorator signatures.",
-      "path": "development/decorators-guide",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["decorators", "reference", "architecture", "guide"],
+      "tags": ["router", "deployment", "node", "vercel", "lambda", "cloudflare", "cli", "browser", "sdk", "guide"],
       "bundle": ["recommended", "minimal", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-tool",
+      "references": [
+        {
+          "name": "build-for-browser",
+          "description": "Build a FrontMCP server or client for browser environments and frontend frameworks"
+        },
+        {
+          "name": "build-for-cli",
+          "description": "Build a FrontMCP server as a standalone CLI binary using Node.js SEA or bundled JS"
+        },
+        {
+          "name": "build-for-sdk",
+          "description": "Build a FrontMCP server as an embeddable library with create() and connect() APIs"
+        },
+        {
+          "name": "deploy-to-cloudflare",
+          "description": "Deploy a FrontMCP server to Cloudflare Workers with KV, D1, and Durable Objects"
+        },
+        {
+          "name": "deploy-to-lambda",
+          "description": "Deploy a FrontMCP server to AWS Lambda with API Gateway using SAM or CDK"
+        },
+        {
+          "name": "deploy-to-node-dockerfile",
+          "description": "Multi-stage Dockerfile for building and running a FrontMCP server in production"
+        },
+        {
+          "name": "deploy-to-node",
+          "description": "Deploy a FrontMCP server as a standalone Node.js app with Docker and process managers"
+        },
+        {
+          "name": "deploy-to-vercel-config",
+          "description": "Reference vercel.json configuration for deploying a FrontMCP server to Vercel"
+        },
+        {
+          "name": "deploy-to-vercel",
+          "description": "Deploy a FrontMCP server to Vercel serverless functions with Vercel KV storage"
+        }
+      ]
+    },
+    {
+      "name": "frontmcp-development",
       "category": "development",
-      "description": "Create and register an MCP tool with Zod input validation and typed output. Use when building tools, defining input schemas, adding output validation, or registering tools in an app.",
-      "path": "development/create-tool",
+      "description": "Use when you want to create a tool, add a resource, build a prompt, write a provider, implement an adapter, add OpenAPI integration, create a plugin, agent, job, or workflow. The skill for BUILDING any FrontMCP component.",
+      "path": "frontmcp-development",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["tools", "mcp", "zod", "schema"],
+      "tags": ["router", "development", "tools", "resources", "prompts", "agents", "skills", "guide"],
       "bundle": ["recommended", "minimal", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-resource",
-      "category": "development",
-      "description": "Create MCP resources and resource templates with URI-based access. Use when exposing data via URIs, creating resource templates, or serving dynamic content.",
-      "path": "development/create-resource",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["resources", "mcp", "uri", "templates"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-prompt",
-      "category": "development",
-      "description": "Create MCP prompts for reusable AI interaction patterns. Use when building prompts, defining prompt arguments, or creating conversation templates.",
-      "path": "development/create-prompt",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["prompts", "mcp", "templates"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-agent",
-      "category": "development",
-      "description": "Create autonomous AI agents with inner tools, LLM providers, and multi-agent swarms. Use when building agents, configuring LLM adapters, adding inner tools, or setting up agent handoff.",
-      "path": "development/create-agent",
+      "references": [
+        {
+          "name": "create-adapter",
+          "description": "Build adapters that generate MCP tools and resources from external sources automatically"
+        },
+        {
+          "name": "create-agent-llm-config",
+          "description": "Reference for supported LLM provider configurations including Anthropic and OpenAI"
+        },
+        {
+          "name": "create-agent",
+          "description": "Create autonomous AI agents that use LLM reasoning to plan and invoke inner tools"
+        },
+        {
+          "name": "create-job",
+          "description": "Create long-running background jobs with retry policies, progress tracking, and permissions"
+        },
+        {
+          "name": "create-plugin-hooks",
+          "description": "Intercept and extend FrontMCP flows using before, after, around, and stage hook decorators"
+        },
+        {
+          "name": "create-plugin",
+          "description": "Build plugins with providers, context extensions, lifecycle hooks, and contributed tools"
+        },
+        {
+          "name": "create-prompt",
+          "description": "Define reusable AI interaction patterns that produce structured message sequences"
+        },
+        {
+          "name": "create-provider",
+          "description": "Create singleton DI providers for database pools, API clients, and shared services"
+        },
+        {
+          "name": "create-resource",
+          "description": "Expose data to AI clients via URI-based static resources and parameterized templates"
+        },
+        {
+          "name": "create-skill-with-tools",
+          "description": "Create skills that combine structured instructions with MCP tool references for orchestration"
+        },
+        {
+          "name": "create-skill",
+          "description": "Create instruction-only skills that package knowledge and workflow guides for AI clients"
+        },
+        {
+          "name": "create-tool-annotations",
+          "description": "Reference for MCP tool annotation hints like readOnly, destructive, and idempotent"
+        },
+        {
+          "name": "create-tool-output-schema-types",
+          "description": "Reference for all supported outputSchema types including Zod shapes and JSON Schema"
+        },
+        {
+          "name": "create-tool",
+          "description": "Build MCP tools with Zod input/output validation and dependency injection"
+        },
+        {
+          "name": "create-workflow",
+          "description": "Connect multiple jobs into managed DAG pipelines with dependencies, conditions, and triggers"
+        },
+        {
+          "name": "decorators-guide",
+          "description": "Complete reference for the hierarchical decorator system from @FrontMcp to @Tool"
+        },
+        {
+          "name": "official-adapters",
+          "description": "Convert OpenAPI specs and external definitions into MCP tools automatically"
+        },
+        {
+          "name": "official-plugins",
+          "description": "Guide to the 6 official plugins for discovery, memory, auth, caching, flags, and monitoring"
+        }
+      ]
+    },
+    {
+      "name": "frontmcp-extensibility",
+      "category": "extensibility",
+      "description": "Extend FrontMCP servers with external npm packages and libraries. Covers VectoriaDB for semantic search, and patterns for integrating third-party services into providers and tools. Use when adding search, ML, database, or external API capabilities beyond the core SDK.",
+      "path": "frontmcp-extensibility",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["agent", "ai", "llm", "tools", "autonomous"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-skill-with-tools",
-      "category": "development",
-      "description": "Create skills that reference and orchestrate MCP tools for multi-step workflows. Use when building skills with tool references, SKILL.md directories, or workflow instructions.",
-      "path": "development/create-skill-with-tools",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["skill", "tools", "workflow", "instructions"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-skill",
-      "category": "development",
-      "description": "Create instruction-only skills that guide AI through workflows without tool references. Use when building knowledge packages, coding guidelines, or workflow templates.",
-      "path": "development/create-skill",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["skill", "instructions", "knowledge", "workflow", "guide"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-provider",
-      "category": "development",
-      "description": "Create dependency injection providers for database connections, API clients, and singleton services. Use when tools and resources need shared services, DB pools, or configuration objects.",
-      "path": "development/create-provider",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["provider", "di", "dependency-injection", "singleton", "database", "service"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-job",
-      "category": "development",
-      "description": "Create long-running jobs with retry policies, progress tracking, and permission controls. Use when building background tasks, data processing pipelines, or scheduled operations.",
-      "path": "development/create-job",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["job", "background", "retry", "progress", "long-running"],
+      "tags": ["extensibility", "vectoriadb", "search", "integration", "npm", "provider", "external-services"],
       "bundle": ["full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-workflow",
-      "category": "development",
-      "description": "Create multi-step workflows that connect jobs into managed execution pipelines with dependencies and conditions. Use when orchestrating sequential or parallel job execution.",
-      "path": "development/create-workflow",
+      "references": [
+        {
+          "name": "vectoriadb",
+          "description": "Use VectoriaDB for in-memory vector search with ML-based or TF-IDF engines in FrontMCP servers"
+        }
+      ]
+    },
+    {
+      "name": "frontmcp-guides",
+      "category": "guides",
+      "description": "Tutorials, walkthroughs, and end-to-end examples for building FrontMCP servers. Use when you want a getting started guide, how to build a complete project, learn best practices, or follow a step-by-step example. Triggers: tutorial, walkthrough, how to build, getting started, learn FrontMCP.",
+      "path": "frontmcp-guides",
       "targets": ["all"],
-      "hasResources": false,
-      "tags": ["workflow", "pipeline", "orchestration", "steps", "jobs"],
-      "bundle": ["full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "deploy-to-node",
-      "category": "deployment",
-      "description": "Deploy a FrontMCP server as a standalone Node.js application with Docker. Use when deploying to a VPS, Docker, or bare metal server.",
-      "path": "deployment/deploy-to-node",
-      "targets": ["node"],
-      "hasResources": true,
-      "tags": ["deployment", "node", "docker", "production"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite" }
-    },
-    {
-      "name": "deploy-to-vercel",
-      "category": "deployment",
-      "description": "Deploy a FrontMCP server to Vercel serverless functions. Use when deploying to Vercel, configuring Vercel KV, or setting up serverless MCP.",
-      "path": "deployment/deploy-to-vercel",
-      "targets": ["vercel"],
       "hasResources": true,
-      "tags": ["deployment", "vercel", "serverless", "edge"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite" }
-    },
-    {
-      "name": "deploy-to-lambda",
-      "category": "deployment",
-      "description": "Deploy a FrontMCP server to AWS Lambda with API Gateway. Use when deploying to AWS, setting up SAM or CDK, or configuring Lambda handlers.",
-      "path": "deployment/deploy-to-lambda",
-      "targets": ["lambda"],
-      "hasResources": false,
-      "tags": ["deployment", "lambda", "aws", "serverless"],
+      "tags": ["guides", "examples", "best-practices", "architecture", "walkthrough", "end-to-end"],
       "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite" }
-    },
-    {
-      "name": "deploy-to-cloudflare",
-      "category": "deployment",
-      "description": "Deploy a FrontMCP server to Cloudflare Workers. Use when deploying to Cloudflare, configuring wrangler.toml, or setting up Workers KV storage.",
-      "path": "deployment/deploy-to-cloudflare",
-      "targets": ["cloudflare"],
-      "hasResources": false,
-      "tags": ["deployment", "cloudflare", "workers", "serverless"],
-      "bundle": ["full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite" }
-    },
-    {
-      "name": "build-for-cli",
-      "category": "deployment",
-      "description": "Build a distributable CLI binary (SEA) or JS bundle from an MCP server. Use when creating standalone executables, CLI tools, or self-contained binaries.",
-      "path": "deployment/build-for-cli",
-      "targets": ["node"],
-      "hasResources": false,
-      "tags": ["deployment", "cli", "binary", "sea", "executable"],
-      "bundle": ["full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite" }
-    },
-    {
-      "name": "build-for-browser",
-      "category": "deployment",
-      "description": "Build a FrontMCP server for browser environments. Use when creating browser-compatible MCP clients, embedding MCP in web apps, or building client-side tool interfaces.",
-      "path": "deployment/build-for-browser",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["deployment", "browser", "client", "web", "frontend"],
-      "bundle": ["full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite" }
-    },
-    {
-      "name": "build-for-sdk",
-      "category": "deployment",
-      "description": "Build a FrontMCP server as an embeddable SDK library for Node.js applications without HTTP serving. Use when embedding MCP in existing apps, using connect()/connectOpenAI()/connectClaude(), or distributing as an npm package.",
-      "path": "deployment/build-for-sdk",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["deployment", "sdk", "library", "embed", "programmatic", "connect"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "configure-auth",
-      "category": "auth",
-      "description": "Set up authentication with public, transparent, local, or remote auth modes. Use when adding auth, OAuth, login, session security, or protecting tools and resources.",
-      "path": "auth/configure-auth",
+      "references": [
+        {
+          "name": "example-knowledge-base",
+          "description": "Multi-app knowledge base with vector storage, semantic search, AI research agent, and audit plugin"
+        },
+        {
+          "name": "example-task-manager",
+          "description": "Authenticated task management server with CRUD tools, Redis storage, OAuth, and Vercel deployment"
+        },
+        {
+          "name": "example-weather-api",
+          "description": "Beginner MCP server with a weather lookup tool, static resource, Zod schemas, and E2E tests"
+        }
+      ]
+    },
+    {
+      "name": "frontmcp-production-readiness",
+      "category": "production",
+      "description": "Pre-production audit and checklist for FrontMCP servers. Use before go-live to verify security hardening, performance checks, observability, monitoring, and health checks. Triggers: production ready, security audit, performance check, production checklist, hardening, go live.",
+      "path": "frontmcp-production-readiness",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["auth", "oauth", "security", "session"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite" }
-    },
-    {
-      "name": "configure-session",
-      "category": "auth",
-      "description": "Configure session storage with Redis, Vercel KV, or in-memory backends. Use when setting up sessions, choosing a storage provider, or configuring TTL and key prefixes.",
-      "path": "auth/configure-session",
-      "targets": ["node", "vercel"],
-      "hasResources": false,
-      "tags": ["session", "storage", "redis", "memory"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite", "dependencies": ["configure-auth"] }
-    },
-    {
-      "name": "create-plugin",
-      "category": "plugins",
-      "description": "Build a FrontMCP plugin with lifecycle hooks and context extensions. Use when creating custom plugins, extending tool context, or adding cross-cutting concerns.",
-      "path": "plugins/create-plugin",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["plugins", "extensibility", "hooks", "context"],
-      "bundle": ["full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-plugin-hooks",
-      "category": "plugins",
-      "description": "Create plugins with flow lifecycle hooks using @Will, @Did, @Stage, and @Around decorators. Use when intercepting tool calls, adding logging, modifying request/response, or implementing cross-cutting middleware.",
-      "path": "plugins/create-plugin-hooks",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["plugin", "hooks", "will", "did", "stage", "around", "flow", "middleware"],
-      "bundle": ["full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "official-plugins",
-      "category": "plugins",
-      "description": "Install and configure official FrontMCP plugins including CodeCall, Remember, Approval, Cache, Feature Flags, and Dashboard. Use when adding caching, memory, tool approval, feature gating, or CodeCall orchestration.",
-      "path": "plugins/official-plugins",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["plugins", "codecall", "remember", "approval", "cache", "feature-flags", "dashboard"],
+      "tags": ["production", "security", "performance", "reliability", "observability", "audit", "best-practices"],
       "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "official-adapters",
-      "category": "adapters",
-      "description": "Use the OpenAPI adapter to convert REST APIs into MCP tools automatically. Use when integrating external APIs, OpenAPI specs, or converting Swagger docs to MCP tools.",
-      "path": "adapters/official-adapters",
-      "targets": ["all"],
-      "hasResources": false,
-      "tags": ["adapters", "openapi", "rest-api", "swagger", "integration"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "create-adapter",
-      "category": "adapters",
-      "description": "Create custom adapters that convert external definitions into MCP tools, resources, and prompts. Use when building integrations beyond OpenAPI, connecting to proprietary APIs, or generating tools from custom schemas.",
-      "path": "adapters/create-adapter",
+      "references": [
+        {
+          "name": "common-checklist",
+          "description": "Security, performance, reliability, and observability checks for all deployment targets"
+        },
+        {
+          "name": "production-browser",
+          "description": "Checklist for publishing FrontMCP as a browser-compatible SDK bundle"
+        },
+        {
+          "name": "production-cli-binary",
+          "description": "Checklist for publishing FrontMCP as a one-shot CLI binary with stdin/stdout transport"
+        },
+        {
+          "name": "production-cli-daemon",
+          "description": "Checklist for deploying FrontMCP as a long-running local daemon with socket transport"
+        },
+        {
+          "name": "production-cloudflare",
+          "description": "Checklist for deploying FrontMCP to Cloudflare Workers with KV and Durable Objects"
+        },
+        {
+          "name": "production-lambda",
+          "description": "Checklist for deploying FrontMCP to AWS Lambda with SAM, API Gateway, and DynamoDB"
+        },
+        {
+          "name": "production-node-sdk",
+          "description": "Checklist for publishing FrontMCP as an embedded npm package used as a direct client SDK"
+        },
+        {
+          "name": "production-node-server",
+          "description": "Checklist for deploying FrontMCP as a long-running Node.js server with Docker"
+        },
+        {
+          "name": "production-vercel",
+          "description": "Checklist for deploying FrontMCP to Vercel serverless or edge functions with Vercel KV"
+        }
+      ]
+    },
+    {
+      "name": "frontmcp-setup",
+      "category": "setup",
+      "description": "Domain router for project setup, scaffolding, and organization. Use this skill whenever someone asks to create a new FrontMCP project, set up an Nx monorepo, configure Redis or SQLite storage, organize project structure, compose multiple apps into one server, or manage the skills system. Also triggers for questions like 'how do I start', 'project layout', 'folder structure', 'add redis', 'set up database', or 'create a new app'.",
+      "path": "frontmcp-setup",
       "targets": ["all"],
-      "hasResources": false,
-      "tags": ["adapter", "custom", "dynamic-adapter", "integration", "codegen"],
-      "bundle": ["full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
-    },
-    {
-      "name": "setup-testing",
+      "hasResources": true,
+      "tags": ["router", "setup", "scaffold", "project", "nx", "redis", "sqlite", "structure", "guide"],
+      "bundle": ["recommended", "minimal", "full"],
+      "references": [
+        {
+          "name": "frontmcp-skills-usage",
+          "description": "Search, install, and manage FrontMCP skill catalog for AI agents (Claude Code, Codex)"
+        },
+        {
+          "name": "multi-app-composition",
+          "description": "Compose multiple @App classes, ESM packages, and remote MCP servers into a single FrontMCP gateway"
+        },
+        {
+          "name": "nx-workflow",
+          "description": "Scaffold, build, test, and deploy FrontMCP projects using the @frontmcp/nx plugin in a monorepo"
+        },
+        {
+          "name": "project-structure-nx",
+          "description": "Canonical directory layout, generators, and dependency rules for FrontMCP Nx monorepos"
+        },
+        {
+          "name": "project-structure-standalone",
+          "description": "File layout, naming conventions, and dev workflow for standalone FrontMCP projects"
+        },
+        {
+          "name": "readme-guide",
+          "description": "Generate deployment-target-aware README.md files for FrontMCP MCP servers"
+        },
+        {
+          "name": "setup-project",
+          "description": "Scaffold a new FrontMCP project with CLI or manual setup, decorators, apps, and deployment config"
+        },
+        {
+          "name": "setup-redis",
+          "description": "Provision and configure Redis or Vercel KV for session storage and distributed state"
+        },
+        {
+          "name": "setup-sqlite",
+          "description": "Configure SQLite with WAL mode and optional encryption for local single-instance deployments"
+        }
+      ]
+    },
+    {
+      "name": "frontmcp-testing",
       "category": "testing",
-      "description": "Configure and run unit and E2E tests for FrontMCP applications. Use when writing tests, setting up Jest, configuring coverage, or testing tools and resources.",
-      "path": "testing/setup-testing",
+      "description": "Use when you want to write tests, run tests, add e2e tests, improve test coverage, test a tool, test a resource, or learn how to test any FrontMCP component. The skill for ALL testing needs.",
+      "path": "frontmcp-testing",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["testing", "jest", "e2e", "quality"],
+      "tags": ["router", "testing", "jest", "e2e", "coverage", "quality", "guide"],
       "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "skip-existing" }
+      "references": [
+        {
+          "name": "setup-testing",
+          "description": "Configure Jest, write unit and E2E tests, and enforce 95%+ coverage for FrontMCP applications"
+        },
+        {
+          "name": "test-auth",
+          "description": "Test authenticated MCP servers with TestTokenFactory, MockOAuthServer, and role-based access"
+        },
+        {
+          "name": "test-browser-build",
+          "description": "Validate browser build output for Node.js-free bundles and test with Playwright"
+        },
+        {
+          "name": "test-cli-binary",
+          "description": "Test CLI binary and SEA build for startup, health check, and JS bundle import"
+        },
+        {
+          "name": "test-direct-client",
+          "description": "In-memory testing with create() and connectOpenAI/connectClaude without HTTP overhead"
+        },
+        {
+          "name": "test-e2e-handler",
+          "description": "Full MCP protocol E2E tests over HTTP with McpTestClient and TestServer"
+        },
+        {
+          "name": "test-tool-unit",
+          "description": "Unit test a ToolContext execute method with mock context, inputs, and Zod schema validation"
+        }
+      ]
     }
   ]
 }