@frontmcp/skills 0.0.1

package/catalog/testing/setup-testing/references/test-cli-binary.md

@@ -0,0 +1,48 @@
+# Testing CLI Binary / SEA Build
+
+After building with `frontmcp build --target cli`, test the binary:
+
+```typescript
+import { execSync, spawn } from 'child_process';
+import * as path from 'path';
+
+const BINARY = path.resolve(__dirname, '../dist/my-server');
+
+describe('CLI Binary', () => {
+  it('should start and respond to health check', async () => {
+    const child = spawn(BINARY, [], {
+      env: { ...process.env, PORT: '0' },
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    // Wait for server to start
+    await new Promise<void>((resolve) => {
+      child.stdout.on('data', (data: Buffer) => {
+        if (data.toString().includes('listening')) resolve();
+      });
+    });
+
+    // Test health endpoint
+    const res = await fetch('http://localhost:3001/health');
+    expect(res.ok).toBe(true);
+
+    child.kill();
+  });
+
+  it('should exit with code 0 on --help', () => {
+    const output = execSync(`${BINARY} --help`, { encoding: 'utf-8' });
+    expect(output).toContain('Usage');
+  });
+});
+```
+
+## Testing JS Bundle
+
+```typescript
+describe('JS Bundle', () => {
+  it('should be importable', async () => {
+    const mod = await import('../dist/my-server.cjs.js');
+    expect(mod).toBeDefined();
+  });
+});
+```

package/catalog/testing/setup-testing/references/test-direct-client.md

@@ -0,0 +1,62 @@
+# Testing with Direct Client (No HTTP)
+
+Uses `connect()` or `create()` for in-memory testing without HTTP overhead.
+
+```typescript
+import { create, connectOpenAI } from '@frontmcp/sdk';
+import { tool } from '@frontmcp/sdk';
+import { z } from 'zod';
+
+const AddTool = tool({
+  name: 'add',
+  description: 'Add numbers',
+  inputSchema: { a: z.number(), b: z.number() },
+  outputSchema: { sum: z.number() },
+})((input) => ({ sum: input.a + input.b }));
+
+describe('Direct Client Testing', () => {
+  it('should call tools via create()', async () => {
+    const server = await create({
+      info: { name: 'test', version: '1.0.0' },
+      tools: [AddTool],
+      cacheKey: 'test-direct',
+    });
+
+    const result = await server.callTool('add', { a: 2, b: 3 });
+    expect(result.content[0].text).toContain('5');
+
+    await server.dispose();
+  });
+
+  it('should return OpenAI-formatted tools', async () => {
+    const client = await connectOpenAI({
+      info: { name: 'test', version: '1.0.0' },
+      tools: [AddTool],
+      serve: false,
+    });
+
+    const tools = await client.listTools();
+    // OpenAI format: [{ type: 'function', function: { name, parameters } }]
+    expect(tools[0].type).toBe('function');
+    expect(tools[0].function.name).toBe('add');
+
+    await client.close();
+  });
+
+  it('should return Claude-formatted tools', async () => {
+    const { connectClaude } = await import('@frontmcp/sdk');
+    const client = await connectClaude({
+      info: { name: 'test', version: '1.0.0' },
+      tools: [AddTool],
+      serve: false,
+    });
+
+    const tools = await client.listTools();
+    // Claude format: [{ name, description, input_schema }]
+    expect(tools[0].name).toBe('add');
+    expect(tools[0].input_schema).toBeDefined();
+
+    await client.close();
+  });
+});
+```

package/catalog/testing/setup-testing/references/test-e2e-handler.md

@@ -0,0 +1,51 @@
+# E2E Testing with McpTestClient (HTTP Handler)
+
+Tests the full MCP protocol over HTTP — validates tools, resources, prompts end-to-end.
+
+```typescript
+import { McpTestClient, TestServer } from '@frontmcp/testing';
+import Server from '../src/main';
+
+describe('Server E2E', () => {
+  let client: McpTestClient;
+  let server: TestServer;
+
+  beforeAll(async () => {
+    server = await TestServer.create(Server);
+    client = await server.connect();
+  });
+
+  afterAll(async () => {
+    await client.close();
+    await server.dispose();
+  });
+
+  it('should list all tools', async () => {
+    const { tools } = await client.listTools();
+    expect(tools.length).toBeGreaterThan(0);
+    expect(tools).toContainTool('add_numbers');
+  });
+
+  it('should call a tool and get result', async () => {
+    const result = await client.callTool('add_numbers', { a: 5, b: 3 });
+    expect(result).toBeSuccessful();
+    expect(result.content[0].text).toContain('8');
+  });
+
+  it('should return error for invalid input', async () => {
+    const result = await client.callTool('add_numbers', { a: 'bad' });
+    expect(result.isError).toBe(true);
+  });
+
+  it('should list resources', async () => {
+    const { resources } = await client.listResources();
+    expect(resources.length).toBeGreaterThanOrEqual(0);
+  });
+
+  it('should get a prompt', async () => {
+    const result = await client.getPrompt('summarize', { topic: 'testing' });
+    expect(result.messages).toBeDefined();
+    expect(result.messages.length).toBeGreaterThan(0);
+  });
+});
+```

package/catalog/testing/setup-testing/references/test-tool-unit.md

@@ -0,0 +1,41 @@
+# Unit Testing a Tool
+
+```typescript
+import { ToolContext } from '@frontmcp/sdk';
+import { AddTool } from '../tools/add.tool';
+
+describe('AddTool', () => {
+  it('should add two numbers', async () => {
+    // Create mock context
+    const ctx = {
+      get: jest.fn(),
+      tryGet: jest.fn(),
+      fail: jest.fn((err) => {
+        throw err;
+      }),
+      mark: jest.fn(),
+      notify: jest.fn(),
+      respondProgress: jest.fn(),
+    } as unknown as ToolContext;
+
+    const tool = new AddTool();
+    Object.assign(tool, ctx);
+
+    const result = await tool.execute({ a: 2, b: 3 });
+    expect(result).toEqual({ sum: 5 });
+  });
+
+  it('should handle negative numbers', async () => {
+    const tool = new AddTool();
+    const result = await tool.execute({ a: -1, b: -2 });
+    expect(result).toEqual({ sum: -3 });
+  });
+
+  it('should throw on invalid input', async () => {
+    const tool = new AddTool();
+    // Zod validates before execute — test the schema separately
+    const schema = z.object({ a: z.number(), b: z.number() });
+    expect(() => schema.parse({ a: 'not-a-number' })).toThrow();
+  });
+});
+```

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@frontmcp/skills",
+  "version": "0.0.1",
+  "description": "Curated skills catalog for FrontMCP projects",
+  "author": "AgentFront <info@agentfront.dev>",
+  "homepage": "https://docs.agentfront.dev",
+  "license": "Apache-2.0",
+  "keywords": [
+    "skills",
+    "mcp",
+    "agentfront",
+    "frontmcp",
+    "catalog",
+    "agent-skills",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentfront/frontmcp.git",
+    "directory": "libs/skills"
+  },
+  "bugs": {
+    "url": "https://github.com/agentfront/frontmcp/issues"
+  },
+  "main": "./src/index.js",
+  "types": "./index.d.js",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "type": "commonjs"
+}

package/src/index.d.ts

@@ -0,0 +1,3 @@
+export type { SkillCatalogEntry, SkillManifest, SkillTarget, SkillCategory, SkillBundle, SkillDestination, SkillMergeStrategy, SkillInstallConfig, } from './manifest';
+export { VALID_TARGETS, VALID_CATEGORIES, VALID_BUNDLES } from './manifest';
+export { loadManifest, getSkillsByTarget, getSkillsByCategory, getSkillsByBundle, getInstructionOnlySkills, getResourceSkills, resolveSkillPath, } from './loader';

package/src/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSkillPath = exports.getResourceSkills = exports.getInstructionOnlySkills = exports.getSkillsByBundle = exports.getSkillsByCategory = exports.getSkillsByTarget = exports.loadManifest = exports.VALID_BUNDLES = exports.VALID_CATEGORIES = exports.VALID_TARGETS = void 0;
+var manifest_1 = require("./manifest");
+Object.defineProperty(exports, "VALID_TARGETS", { enumerable: true, get: function () { return manifest_1.VALID_TARGETS; } });
+Object.defineProperty(exports, "VALID_CATEGORIES", { enumerable: true, get: function () { return manifest_1.VALID_CATEGORIES; } });
+Object.defineProperty(exports, "VALID_BUNDLES", { enumerable: true, get: function () { return manifest_1.VALID_BUNDLES; } });
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "loadManifest", { enumerable: true, get: function () { return loader_1.loadManifest; } });
+Object.defineProperty(exports, "getSkillsByTarget", { enumerable: true, get: function () { return loader_1.getSkillsByTarget; } });
+Object.defineProperty(exports, "getSkillsByCategory", { enumerable: true, get: function () { return loader_1.getSkillsByCategory; } });
+Object.defineProperty(exports, "getSkillsByBundle", { enumerable: true, get: function () { return loader_1.getSkillsByBundle; } });
+Object.defineProperty(exports, "getInstructionOnlySkills", { enumerable: true, get: function () { return loader_1.getInstructionOnlySkills; } });
+Object.defineProperty(exports, "getResourceSkills", { enumerable: true, get: function () { return loader_1.getResourceSkills; } });
+Object.defineProperty(exports, "resolveSkillPath", { enumerable: true, get: function () { return loader_1.resolveSkillPath; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAWA,uCAA4E;AAAnE,yGAAA,aAAa,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAAE,yGAAA,aAAa,OAAA;AAEvD,mCAQkB;AAPhB,sGAAA,YAAY,OAAA;AACZ,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AACnB,2GAAA,iBAAiB,OAAA;AACjB,kHAAA,wBAAwB,OAAA;AACxB,2GAAA,iBAAiB,OAAA;AACjB,0GAAA,gBAAgB,OAAA","sourcesContent":["export type {\n  SkillCatalogEntry,\n  SkillManifest,\n  SkillTarget,\n  SkillCategory,\n  SkillBundle,\n  SkillDestination,\n  SkillMergeStrategy,\n  SkillInstallConfig,\n} from './manifest';\n\nexport { VALID_TARGETS, VALID_CATEGORIES, VALID_BUNDLES } from './manifest';\n\nexport {\n  loadManifest,\n  getSkillsByTarget,\n  getSkillsByCategory,\n  getSkillsByBundle,\n  getInstructionOnlySkills,\n  getResourceSkills,\n  resolveSkillPath,\n} from './loader';\n"]}

package/src/loader.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Skills catalog loader and filtering helpers.
+ *
+ * Provides functions to query the catalog manifest by target, category, and bundle.
+ *
+ * @module skills/loader
+ */
+import type { SkillCatalogEntry, SkillManifest } from './manifest';
+/**
+ * Load the skills manifest from the catalog directory.
+ *
+ * @param catalogDir - Absolute path to the catalog directory. Defaults to the bundled catalog.
+ * @returns The parsed skills manifest
+ */
+export declare function loadManifest(catalogDir?: string): SkillManifest;
+/**
+ * Filter skills by deployment target.
+ * Returns skills that include the given target or 'all'.
+ */
+export declare function getSkillsByTarget(skills: SkillCatalogEntry[], target: string): SkillCatalogEntry[];
+/**
+ * Filter skills by category.
+ */
+export declare function getSkillsByCategory(skills: SkillCatalogEntry[], category: string): SkillCatalogEntry[];
+/**
+ * Filter skills by bundle membership.
+ */
+export declare function getSkillsByBundle(skills: SkillCatalogEntry[], bundle: string): SkillCatalogEntry[];
+/**
+ * Get only instruction-only skills (no scripts/, references/, or assets/ directories).
+ * These are safe to use with `instructions: { file: ... }` wrappers.
+ */
+export declare function getInstructionOnlySkills(skills: SkillCatalogEntry[]): SkillCatalogEntry[];
+/**
+ * Get only resource-carrying skills (have scripts/, references/, or assets/).
+ * These need full directory loading via `skillDir()`.
+ */
+export declare function getResourceSkills(skills: SkillCatalogEntry[]): SkillCatalogEntry[];
+/**
+ * Resolve the absolute path to a skill directory.
+ *
+ * @param entry - The catalog entry
+ * @param catalogDir - Absolute path to the catalog directory
+ * @returns Absolute path to the skill directory
+ */
+export declare function resolveSkillPath(entry: SkillCatalogEntry, catalogDir?: string): string;

package/src/loader.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Skills catalog loader and filtering helpers.
+ *
+ * Provides functions to query the catalog manifest by target, category, and bundle.
+ *
+ * @module skills/loader
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadManifest = loadManifest;
+exports.getSkillsByTarget = getSkillsByTarget;
+exports.getSkillsByCategory = getSkillsByCategory;
+exports.getSkillsByBundle = getSkillsByBundle;
+exports.getInstructionOnlySkills = getInstructionOnlySkills;
+exports.getResourceSkills = getResourceSkills;
+exports.resolveSkillPath = resolveSkillPath;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("node:path"));
+/**
+ * Load the skills manifest from the catalog directory.
+ *
+ * @param catalogDir - Absolute path to the catalog directory. Defaults to the bundled catalog.
+ * @returns The parsed skills manifest
+ */
+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);
+}
+/**
+ * Filter skills by deployment target.
+ * Returns skills that include the given target or 'all'.
+ */
+function getSkillsByTarget(skills, target) {
+    return skills.filter((s) => s.targets.includes('all') || s.targets.includes(target));
+}
+/**
+ * Filter skills by category.
+ */
+function getSkillsByCategory(skills, category) {
+    return skills.filter((s) => s.category === category);
+}
+/**
+ * Filter skills by bundle membership.
+ */
+function getSkillsByBundle(skills, bundle) {
+    return skills.filter((s) => s.bundle?.includes(bundle));
+}
+/**
+ * Get only instruction-only skills (no scripts/, references/, or assets/ directories).
+ * These are safe to use with `instructions: { file: ... }` wrappers.
+ */
+function getInstructionOnlySkills(skills) {
+    return skills.filter((s) => !s.hasResources);
+}
+/**
+ * Get only resource-carrying skills (have scripts/, references/, or assets/).
+ * These need full directory loading via `skillDir()`.
+ */
+function getResourceSkills(skills) {
+    return skills.filter((s) => s.hasResources);
+}
+/**
+ * Resolve the absolute path to a skill directory.
+ *
+ * @param entry - The catalog entry
+ * @param catalogDir - Absolute path to the catalog directory
+ * @returns Absolute path to the skill directory
+ */
+function resolveSkillPath(entry, catalogDir) {
+    const dir = catalogDir ?? path.resolve(__dirname, '..', 'catalog');
+    return path.resolve(dir, entry.path);
+}
+//# sourceMappingURL=loader.js.map

package/src/loader.js.map

@@ -0,0 +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"]}

package/src/manifest.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Skills catalog manifest types.
+ *
+ * Defines the contract between the catalog, scaffold tooling, and future installer.
+ *
+ * @module skills/manifest
+ */
+/**
+ * Supported deployment targets for skill filtering.
+ */
+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';
+/**
+ * Bundle membership for curated scaffold presets.
+ */
+export type SkillBundle = 'recommended' | 'minimal' | 'full';
+/**
+ * Install destination types for future provider wiring.
+ */
+export type SkillDestination = 'project-local' | '.claude/skills' | 'codex' | 'gemini';
+/**
+ * Merge strategy when installing a skill that already exists at the destination.
+ */
+export type SkillMergeStrategy = 'overwrite' | 'skip-existing';
+/**
+ * Install configuration for a catalog skill.
+ */
+export interface SkillInstallConfig {
+    /** Where this skill can be installed */
+    destinations: SkillDestination[];
+    /** How to handle existing skills at the destination */
+    mergeStrategy: SkillMergeStrategy;
+    /** Other skills this depends on (by name) */
+    dependencies?: string[];
+}
+/**
+ * A single entry in the skills catalog manifest.
+ *
+ * This is the core contract connecting SKILL.md files to scaffolding,
+ * future installation, and provider-specific destinations.
+ */
+export interface SkillCatalogEntry {
+    /** Unique skill name — matches SKILL.md frontmatter `name` */
+    name: string;
+    /** Skill category for organization */
+    category: SkillCategory;
+    /** Short description */
+    description: string;
+    /** Path to the skill directory, relative to catalog/ */
+    path: string;
+    /** Deployment targets this skill applies to */
+    targets: SkillTarget[];
+    /** Whether the skill has scripts/, references/, or assets/ directories */
+    hasResources: boolean;
+    /** Target-specific storage defaults (e.g., { node: 'redis-docker', vercel: 'vercel-kv' }) */
+    storageDefault?: Record<string, string>;
+    /** Tags for secondary filtering and search */
+    tags: string[];
+    /** Bundle membership for scaffold presets */
+    bundle?: SkillBundle[];
+    /** Install configuration for future distribution */
+    install: SkillInstallConfig;
+}
+/**
+ * The skills catalog manifest — single source of truth for scaffold and install tooling.
+ */
+export interface SkillManifest {
+    /** Manifest schema version */
+    version: 1;
+    /** All catalog skills */
+    skills: SkillCatalogEntry[];
+}
+/** Valid deployment targets for manifest validation */
+export declare const VALID_TARGETS: readonly SkillTarget[];
+/** Valid categories for manifest validation */
+export declare const VALID_CATEGORIES: readonly SkillCategory[];
+/** Valid bundles for manifest validation */
+export declare const VALID_BUNDLES: readonly SkillBundle[];

package/src/manifest.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Skills catalog manifest types.
+ *
+ * Defines the contract between the catalog, scaffold tooling, and future installer.
+ *
+ * @module skills/manifest
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_BUNDLES = exports.VALID_CATEGORIES = exports.VALID_TARGETS = void 0;
+/** Valid deployment targets for manifest validation */
+exports.VALID_TARGETS = ['node', 'vercel', 'lambda', 'cloudflare', 'all'];
+/** Valid categories for manifest validation */
+exports.VALID_CATEGORIES = [
+    'setup',
+    'deployment',
+    'development',
+    'config',
+    'auth',
+    'plugins',
+    'adapters',
+    'testing',
+];
+/** Valid bundles for manifest validation */
+exports.VALID_BUNDLES = ['recommended', 'minimal', 'full'];
+//# sourceMappingURL=manifest.js.map

package/src/manifest.js.map

@@ -0,0 +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"]}