@frontmcp/skills 0.0.1 → 1.0.0-beta.10

package/catalog/skills-manifest.json

@@ -2,413 +2,74 @@
   "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"],
-      "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" }
+      "tags": ["router", "config", "transport", "http", "auth", "session", "redis", "sqlite", "throttle", "guide"],
+      "bundle": ["recommended", "full"]
     },
     {
-      "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",
+      "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" }
+      "tags": ["router", "deployment", "node", "vercel", "lambda", "cloudflare", "cli", "browser", "sdk", "guide"],
+      "bundle": ["recommended", "minimal", "full"]
     },
     {
-      "name": "decorators-guide",
+      "name": "frontmcp-development",
       "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",
+      "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"],
-      "bundle": ["recommended", "minimal", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
+      "tags": ["router", "development", "tools", "resources", "prompts", "agents", "skills", "guide"],
+      "bundle": ["recommended", "minimal", "full"]
     },
     {
-      "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",
+      "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": true,
-      "tags": ["agent", "ai", "llm", "tools", "autonomous"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
+      "tags": ["guides", "examples", "best-practices", "architecture", "walkthrough", "end-to-end"],
+      "bundle": ["recommended", "full"]
     },
     {
-      "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",
+      "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": false,
-      "tags": ["skill", "tools", "workflow", "instructions"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local", ".claude/skills"], "mergeStrategy": "skip-existing" }
+      "tags": ["production", "security", "performance", "reliability", "observability", "audit", "best-practices"],
+      "bundle": ["recommended", "full"]
     },
     {
-      "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",
+      "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": 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" }
+      "tags": ["router", "setup", "scaffold", "project", "nx", "redis", "sqlite", "structure", "guide"],
+      "bundle": ["recommended", "minimal", "full"]
     },
     {
-      "name": "setup-testing",
+      "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"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "skip-existing" }
+      "tags": ["router", "testing", "jest", "e2e", "coverage", "quality", "guide"],
+      "bundle": ["recommended", "full"]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/skills",
-  "version": "0.0.1",
+  "version": "1.0.0-beta.10",
   "description": "Curated skills catalog for FrontMCP projects",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -25,7 +25,7 @@
   "main": "./src/index.js",
   "types": "./index.d.js",
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=24.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"

package/src/loader.js

@@ -25,7 +25,6 @@ const path = tslib_1.__importStar(require("node:path"));
 function loadManifest(catalogDir) {
     const dir = catalogDir ?? path.resolve(__dirname, '..', 'catalog');
     const manifestPath = path.join(dir, 'skills-manifest.json');
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
     return require(manifestPath);
 }
 /**

package/src/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/loader.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAWH,oCAKC;AAMD,8CAIC;AAKD,kDAEC;AAKD,8CAIC;AAMD,4DAEC;AAMD,8CAEC;AASD,4CAGC;;AApED,wDAAkC;AAGlC;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,UAAmB;IAC9C,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IAC5D,iEAAiE;IACjE,OAAO,OAAO,CAAC,YAAY,CAAkB,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,MAA2B,EAAE,MAAc;IAC3E,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAA8C,CAAC,CACvG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAA2B,EAAE,QAAgB;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAA2B,EAAE,MAAc;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACzB,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAiF,CAAC,CACtG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CAAC,MAA2B;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,MAA2B;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAwB,EAAE,UAAmB;IAC5E,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC","sourcesContent":["/**\n * Skills catalog loader and filtering helpers.\n *\n * Provides functions to query the catalog manifest by target, category, and bundle.\n *\n * @module skills/loader\n */\n\nimport * as path from 'node:path';\nimport type { SkillCatalogEntry, SkillManifest } from './manifest';\n\n/**\n * Load the skills manifest from the catalog directory.\n *\n * @param catalogDir - Absolute path to the catalog directory. Defaults to the bundled catalog.\n * @returns The parsed skills manifest\n */\nexport function loadManifest(catalogDir?: string): SkillManifest {\n  const dir = catalogDir ?? path.resolve(__dirname, '..', 'catalog');\n  const manifestPath = path.join(dir, 'skills-manifest.json');\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  return require(manifestPath) as SkillManifest;\n}\n\n/**\n * Filter skills by deployment target.\n * Returns skills that include the given target or 'all'.\n */\nexport function getSkillsByTarget(skills: SkillCatalogEntry[], target: string): SkillCatalogEntry[] {\n  return skills.filter(\n    (s) => s.targets.includes('all') || s.targets.includes(target as SkillCatalogEntry['targets'][number]),\n  );\n}\n\n/**\n * Filter skills by category.\n */\nexport function getSkillsByCategory(skills: SkillCatalogEntry[], category: string): SkillCatalogEntry[] {\n  return skills.filter((s) => s.category === category);\n}\n\n/**\n * Filter skills by bundle membership.\n */\nexport function getSkillsByBundle(skills: SkillCatalogEntry[], bundle: string): SkillCatalogEntry[] {\n  return skills.filter((s) =>\n    s.bundle?.includes(bundle as SkillCatalogEntry['bundle'] extends (infer U)[] | undefined ? U : never),\n  );\n}\n\n/**\n * Get only instruction-only skills (no scripts/, references/, or assets/ directories).\n * These are safe to use with `instructions: { file: ... }` wrappers.\n */\nexport function getInstructionOnlySkills(skills: SkillCatalogEntry[]): SkillCatalogEntry[] {\n  return skills.filter((s) => !s.hasResources);\n}\n\n/**\n * Get only resource-carrying skills (have scripts/, references/, or assets/).\n * These need full directory loading via `skillDir()`.\n */\nexport function getResourceSkills(skills: SkillCatalogEntry[]): SkillCatalogEntry[] {\n  return skills.filter((s) => s.hasResources);\n}\n\n/**\n * Resolve the absolute path to a skill directory.\n *\n * @param entry - The catalog entry\n * @param catalogDir - Absolute path to the catalog directory\n * @returns Absolute path to the skill directory\n */\nexport function resolveSkillPath(entry: SkillCatalogEntry, catalogDir?: string): string {\n  const dir = catalogDir ?? path.resolve(__dirname, '..', 'catalog');\n  return path.resolve(dir, entry.path);\n}\n"]}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/loader.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAWH,oCAIC;AAMD,8CAIC;AAKD,kDAEC;AAKD,8CAIC;AAMD,4DAEC;AAMD,8CAEC;AASD,4CAGC;;AAnED,wDAAkC;AAGlC;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,UAAmB;IAC9C,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,YAAY,CAAkB,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,MAA2B,EAAE,MAAc;IAC3E,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAA8C,CAAC,CACvG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAA2B,EAAE,QAAgB;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAA2B,EAAE,MAAc;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACzB,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAiF,CAAC,CACtG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CAAC,MAA2B;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,MAA2B;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAwB,EAAE,UAAmB;IAC5E,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC","sourcesContent":["/**\n * Skills catalog loader and filtering helpers.\n *\n * Provides functions to query the catalog manifest by target, category, and bundle.\n *\n * @module skills/loader\n */\n\nimport * as path from 'node:path';\nimport type { SkillCatalogEntry, SkillManifest } from './manifest';\n\n/**\n * Load the skills manifest from the catalog directory.\n *\n * @param catalogDir - Absolute path to the catalog directory. Defaults to the bundled catalog.\n * @returns The parsed skills manifest\n */\nexport function loadManifest(catalogDir?: string): SkillManifest {\n  const dir = catalogDir ?? path.resolve(__dirname, '..', 'catalog');\n  const manifestPath = path.join(dir, 'skills-manifest.json');\n  return require(manifestPath) as SkillManifest;\n}\n\n/**\n * Filter skills by deployment target.\n * Returns skills that include the given target or 'all'.\n */\nexport function getSkillsByTarget(skills: SkillCatalogEntry[], target: string): SkillCatalogEntry[] {\n  return skills.filter(\n    (s) => s.targets.includes('all') || s.targets.includes(target as SkillCatalogEntry['targets'][number]),\n  );\n}\n\n/**\n * Filter skills by category.\n */\nexport function getSkillsByCategory(skills: SkillCatalogEntry[], category: string): SkillCatalogEntry[] {\n  return skills.filter((s) => s.category === category);\n}\n\n/**\n * Filter skills by bundle membership.\n */\nexport function getSkillsByBundle(skills: SkillCatalogEntry[], bundle: string): SkillCatalogEntry[] {\n  return skills.filter((s) =>\n    s.bundle?.includes(bundle as SkillCatalogEntry['bundle'] extends (infer U)[] | undefined ? U : never),\n  );\n}\n\n/**\n * Get only instruction-only skills (no scripts/, references/, or assets/ directories).\n * These are safe to use with `instructions: { file: ... }` wrappers.\n */\nexport function getInstructionOnlySkills(skills: SkillCatalogEntry[]): SkillCatalogEntry[] {\n  return skills.filter((s) => !s.hasResources);\n}\n\n/**\n * Get only resource-carrying skills (have scripts/, references/, or assets/).\n * These need full directory loading via `skillDir()`.\n */\nexport function getResourceSkills(skills: SkillCatalogEntry[]): SkillCatalogEntry[] {\n  return skills.filter((s) => s.hasResources);\n}\n\n/**\n * Resolve the absolute path to a skill directory.\n *\n * @param entry - The catalog entry\n * @param catalogDir - Absolute path to the catalog directory\n * @returns Absolute path to the skill directory\n */\nexport function resolveSkillPath(entry: SkillCatalogEntry, catalogDir?: string): string {\n  const dir = catalogDir ?? path.resolve(__dirname, '..', 'catalog');\n  return path.resolve(dir, entry.path);\n}\n"]}

package/src/manifest.d.ts

@@ -12,7 +12,7 @@ export type SkillTarget = 'node' | 'vercel' | 'lambda' | 'cloudflare' | 'all';
 /**
  * Skill categories for organizing the catalog.
  */
-export type SkillCategory = 'setup' | 'deployment' | 'development' | 'config' | 'auth' | 'plugins' | 'adapters' | 'testing';
+export type SkillCategory = 'setup' | 'deployment' | 'development' | 'config' | 'testing' | 'guides' | 'production';
 /**
  * Bundle membership for curated scaffold presets.
  */
@@ -61,8 +61,8 @@ export interface SkillCatalogEntry {
     tags: string[];
     /** Bundle membership for scaffold presets */
     bundle?: SkillBundle[];
-    /** Install configuration for future distribution */
-    install: SkillInstallConfig;
+    /** Install configuration for future distribution (optional — not yet used by CLI) */
+    install?: SkillInstallConfig;
 }
 /**
  * The skills catalog manifest — single source of truth for scaffold and install tooling.

package/src/manifest.js

@@ -16,10 +16,9 @@ exports.VALID_CATEGORIES = [
     'deployment',
     'development',
     'config',
-    'auth',
-    'plugins',
-    'adapters',
     'testing',
+    'guides',
+    'production',
 ];
 /** Valid bundles for manifest validation */
 exports.VALID_BUNDLES = ['recommended', 'minimal', 'full'];

package/src/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/manifest.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAsFH,uDAAuD;AAC1C,QAAA,aAAa,GAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;AAEvG,+CAA+C;AAClC,QAAA,gBAAgB,GAA6B;IACxD,OAAO;IACP,YAAY;IACZ,aAAa;IACb,QAAQ;IACR,MAAM;IACN,SAAS;IACT,UAAU;IACV,SAAS;CACV,CAAC;AAEF,4CAA4C;AAC/B,QAAA,aAAa,GAA2B,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC","sourcesContent":["/**\n * Skills catalog manifest types.\n *\n * Defines the contract between the catalog, scaffold tooling, and future installer.\n *\n * @module skills/manifest\n */\n\n/**\n * Supported deployment targets for skill filtering.\n */\nexport type SkillTarget = 'node' | 'vercel' | 'lambda' | 'cloudflare' | 'all';\n\n/**\n * Skill categories for organizing the catalog.\n */\nexport type SkillCategory =\n  | 'setup'\n  | 'deployment'\n  | 'development'\n  | 'config'\n  | 'auth'\n  | 'plugins'\n  | 'adapters'\n  | 'testing';\n\n/**\n * Bundle membership for curated scaffold presets.\n */\nexport type SkillBundle = 'recommended' | 'minimal' | 'full';\n\n/**\n * Install destination types for future provider wiring.\n */\nexport type SkillDestination = 'project-local' | '.claude/skills' | 'codex' | 'gemini';\n\n/**\n * Merge strategy when installing a skill that already exists at the destination.\n */\nexport type SkillMergeStrategy = 'overwrite' | 'skip-existing';\n\n/**\n * Install configuration for a catalog skill.\n */\nexport interface SkillInstallConfig {\n  /** Where this skill can be installed */\n  destinations: SkillDestination[];\n  /** How to handle existing skills at the destination */\n  mergeStrategy: SkillMergeStrategy;\n  /** Other skills this depends on (by name) */\n  dependencies?: string[];\n}\n\n/**\n * A single entry in the skills catalog manifest.\n *\n * This is the core contract connecting SKILL.md files to scaffolding,\n * future installation, and provider-specific destinations.\n */\nexport interface SkillCatalogEntry {\n  /** Unique skill name — matches SKILL.md frontmatter `name` */\n  name: string;\n  /** Skill category for organization */\n  category: SkillCategory;\n  /** Short description */\n  description: string;\n  /** Path to the skill directory, relative to catalog/ */\n  path: string;\n  /** Deployment targets this skill applies to */\n  targets: SkillTarget[];\n  /** Whether the skill has scripts/, references/, or assets/ directories */\n  hasResources: boolean;\n  /** Target-specific storage defaults (e.g., { node: 'redis-docker', vercel: 'vercel-kv' }) */\n  storageDefault?: Record<string, string>;\n  /** Tags for secondary filtering and search */\n  tags: string[];\n  /** Bundle membership for scaffold presets */\n  bundle?: SkillBundle[];\n  /** Install configuration for future distribution */\n  install: SkillInstallConfig;\n}\n\n/**\n * The skills catalog manifest — single source of truth for scaffold and install tooling.\n */\nexport interface SkillManifest {\n  /** Manifest schema version */\n  version: 1;\n  /** All catalog skills */\n  skills: SkillCatalogEntry[];\n}\n\n/** Valid deployment targets for manifest validation */\nexport const VALID_TARGETS: readonly SkillTarget[] = ['node', 'vercel', 'lambda', 'cloudflare', 'all'];\n\n/** Valid categories for manifest validation */\nexport const VALID_CATEGORIES: readonly SkillCategory[] = [\n  'setup',\n  'deployment',\n  'development',\n  'config',\n  'auth',\n  'plugins',\n  'adapters',\n  'testing',\n];\n\n/** Valid bundles for manifest validation */\nexport const VALID_BUNDLES: readonly SkillBundle[] = ['recommended', 'minimal', 'full'];\n"]}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/manifest.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA8EH,uDAAuD;AAC1C,QAAA,aAAa,GAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;AAEvG,+CAA+C;AAClC,QAAA,gBAAgB,GAA6B;IACxD,OAAO;IACP,YAAY;IACZ,aAAa;IACb,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,YAAY;CACb,CAAC;AAEF,4CAA4C;AAC/B,QAAA,aAAa,GAA2B,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC","sourcesContent":["/**\n * Skills catalog manifest types.\n *\n * Defines the contract between the catalog, scaffold tooling, and future installer.\n *\n * @module skills/manifest\n */\n\n/**\n * Supported deployment targets for skill filtering.\n */\nexport type SkillTarget = 'node' | 'vercel' | 'lambda' | 'cloudflare' | 'all';\n\n/**\n * Skill categories for organizing the catalog.\n */\nexport type SkillCategory = 'setup' | 'deployment' | 'development' | 'config' | 'testing' | 'guides' | 'production';\n\n/**\n * Bundle membership for curated scaffold presets.\n */\nexport type SkillBundle = 'recommended' | 'minimal' | 'full';\n\n/**\n * Install destination types for future provider wiring.\n */\nexport type SkillDestination = 'project-local' | '.claude/skills' | 'codex' | 'gemini';\n\n/**\n * Merge strategy when installing a skill that already exists at the destination.\n */\nexport type SkillMergeStrategy = 'overwrite' | 'skip-existing';\n\n/**\n * Install configuration for a catalog skill.\n */\nexport interface SkillInstallConfig {\n  /** Where this skill can be installed */\n  destinations: SkillDestination[];\n  /** How to handle existing skills at the destination */\n  mergeStrategy: SkillMergeStrategy;\n  /** Other skills this depends on (by name) */\n  dependencies?: string[];\n}\n\n/**\n * A single entry in the skills catalog manifest.\n *\n * This is the core contract connecting SKILL.md files to scaffolding,\n * future installation, and provider-specific destinations.\n */\nexport interface SkillCatalogEntry {\n  /** Unique skill name — matches SKILL.md frontmatter `name` */\n  name: string;\n  /** Skill category for organization */\n  category: SkillCategory;\n  /** Short description */\n  description: string;\n  /** Path to the skill directory, relative to catalog/ */\n  path: string;\n  /** Deployment targets this skill applies to */\n  targets: SkillTarget[];\n  /** Whether the skill has scripts/, references/, or assets/ directories */\n  hasResources: boolean;\n  /** Target-specific storage defaults (e.g., { node: 'redis-docker', vercel: 'vercel-kv' }) */\n  storageDefault?: Record<string, string>;\n  /** Tags for secondary filtering and search */\n  tags: string[];\n  /** Bundle membership for scaffold presets */\n  bundle?: SkillBundle[];\n  /** Install configuration for future distribution (optional — not yet used by CLI) */\n  install?: SkillInstallConfig;\n}\n\n/**\n * The skills catalog manifest — single source of truth for scaffold and install tooling.\n */\nexport interface SkillManifest {\n  /** Manifest schema version */\n  version: 1;\n  /** All catalog skills */\n  skills: SkillCatalogEntry[];\n}\n\n/** Valid deployment targets for manifest validation */\nexport const VALID_TARGETS: readonly SkillTarget[] = ['node', 'vercel', 'lambda', 'cloudflare', 'all'];\n\n/** Valid categories for manifest validation */\nexport const VALID_CATEGORIES: readonly SkillCategory[] = [\n  'setup',\n  'deployment',\n  'development',\n  'config',\n  'testing',\n  'guides',\n  'production',\n];\n\n/** Valid bundles for manifest validation */\nexport const VALID_BUNDLES: readonly SkillBundle[] = ['recommended', 'minimal', 'full'];\n"]}