@frontmcp/skills 0.0.1 → 1.0.0-beta.9

package/catalog/skills-manifest.json

@@ -2,413 +2,64 @@
   "version": 1,
   "skills": [
     {
-      "name": "frontmcp-skills-usage",
+      "name": "frontmcp-setup",
       "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",
+      "description": "Domain router for project setup and scaffolding \u2014 new projects, project structure, Nx workspaces, storage backends, multi-app composition, and the skills system. Use when starting or organizing a FrontMCP project.",
+      "path": "frontmcp-setup",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["transport", "sse", "streamable-http", "stateless", "protocol", "session"],
-      "bundle": ["recommended", "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": "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",
+      "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": "Domain router for building MCP components \u2014 tools, resources, prompts, agents, providers, jobs, workflows, and skills. Use when starting any FrontMCP development task and need to find the right skill.",
+      "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" }
-    },
-    {
-      "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" }
+      "tags": ["router", "development", "tools", "resources", "prompts", "agents", "skills", "guide"],
+      "bundle": ["recommended", "minimal", "full"]
     },
     {
-      "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-deployment",
+      "category": "deployment",
+      "description": "Domain router for shipping MCP servers \u2014 deploy to Node, Vercel, Lambda, Cloudflare, or build for CLI, browser, and SDK. Use when choosing a deployment target or build format.",
+      "path": "frontmcp-deployment",
       "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" }
+      "tags": ["router", "deployment", "node", "vercel", "lambda", "cloudflare", "cli", "browser", "sdk", "guide"],
+      "bundle": ["recommended", "minimal", "full"]
     },
     {
-      "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",
+      "name": "frontmcp-testing",
+      "category": "testing",
+      "description": "Domain router for testing MCP servers \u2014 unit tests, E2E tests, coverage, and quality assurance. Use when starting any testing task for a FrontMCP application.",
+      "path": "frontmcp-testing",
       "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" }
+      "tags": ["router", "testing", "jest", "e2e", "coverage", "quality", "guide"],
+      "bundle": ["recommended", "full"]
     },
     {
-      "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-config",
+      "category": "config",
+      "description": "Domain router for configuring MCP servers \u2014 transport, HTTP, throttle, elicitation, auth, sessions, and storage. Use when configuring any aspect of a FrontMCP server.",
+      "path": "frontmcp-config",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["auth", "oauth", "security", "session"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "overwrite" }
+      "tags": ["router", "config", "transport", "http", "auth", "session", "redis", "sqlite", "throttle", "guide"],
+      "bundle": ["recommended", "full"]
     },
     {
-      "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",
+      "name": "frontmcp-guides",
+      "category": "guides",
+      "description": "End-to-end examples and best practices for building FrontMCP MCP servers. Use when starting a new project from scratch, learning architectural patterns, or following a complete build walkthrough.",
+      "path": "frontmcp-guides",
       "targets": ["all"],
       "hasResources": true,
-      "tags": ["testing", "jest", "e2e", "quality"],
-      "bundle": ["recommended", "full"],
-      "install": { "destinations": ["project-local"], "mergeStrategy": "skip-existing" }
+      "tags": ["guides", "examples", "best-practices", "architecture", "walkthrough", "end-to-end"],
+      "bundle": ["recommended", "full"]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/skills",
-  "version": "0.0.1",
+  "version": "1.0.0-beta.9",
   "description": "Curated skills catalog for FrontMCP projects",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",

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';
 /**
  * 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,8 @@ exports.VALID_CATEGORIES = [
     'deployment',
     'development',
     'config',
-    'auth',
-    'plugins',
-    'adapters',
     'testing',
+    'guides',
 ];
 /** 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;CACT,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';\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];\n\n/** Valid bundles for manifest validation */\nexport const VALID_BUNDLES: readonly SkillBundle[] = ['recommended', 'minimal', 'full'];\n"]}