@frontmcp/skills 0.0.1

package/catalog/skills-manifest.json

@@ -0,0 +1,414 @@
+{
+  "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",
+      "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",
+      "targets": ["all"],
+      "hasResources": true,
+      "tags": ["transport", "sse", "streamable-http", "stateless", "protocol", "session"],
+      "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",
+      "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"],
+      "bundle": ["recommended", "minimal", "full"],
+      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
+    },
+    {
+      "name": "create-tool",
+      "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",
+      "targets": ["all"],
+      "hasResources": true,
+      "tags": ["tools", "mcp", "zod", "schema"],
+      "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",
+      "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"],
+      "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",
+      "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"],
+      "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",
+      "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"],
+      "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",
+      "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",
+      "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",
+      "targets": ["all"],
+      "hasResources": true,
+      "tags": ["testing", "jest", "e2e", "quality"],
+      "bundle": ["recommended", "full"],
+      "install": { "destinations": ["project-local"], "mergeStrategy": "skip-existing" }
+    }
+  ]
+}