@frontmcp/skills 1.1.2 → 1.2.1

package/package.json

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

package/src/manifest.d.ts

@@ -96,6 +96,19 @@ export interface SkillCatalogEntry {
     bundle?: SkillBundle[];
     /** Install configuration for future distribution (optional — not yet used by CLI) */
     install?: SkillInstallConfig;
+    /**
+     * Optional skill quality rating (0..5, one decimal). Surfaced via the
+     * Skills HTTP API for consumers that want to filter by `min-rating` or
+     * sort by quality. Mirrors `SkillMetadata.rating` introduced in v1.2.0.
+     */
+    rating?: number;
+    /**
+     * Other catalog skills this skill depends on (by `name`). Used by the
+     * dependency resolver introduced in v1.2.0 to register dependencies first
+     * during scaffold/install. Aligns with the agentskills Skill Package
+     * Manifest proposal `requires` field.
+     */
+    requires?: string[];
 }
 /**
  * The skills catalog manifest — single source of truth for scaffold and install tooling.

package/src/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/manifest.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA2HH,mDAAmD;AACtC,QAAA,oBAAoB,GAAiC,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;AAExG,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;IACZ,eAAe;IACf,eAAe;CAChB,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  | 'testing'\n  | 'guides'\n  | 'production'\n  | 'extensibility'\n  | 'observability';\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 * Complexity level for a reference example.\n */\nexport type SkillExampleLevel = 'basic' | 'intermediate' | 'advanced';\n\n/**\n * Metadata for a single example file within a reference's examples/ directory.\n */\nexport interface SkillReferenceExampleEntry {\n  /** Example name — matches filename without extension */\n  name: string;\n  /** Short description of what the example demonstrates */\n  description: string;\n  /** Complexity level */\n  level: SkillExampleLevel;\n  /** Searchable tags for the example */\n  tags: string[];\n  /** Concrete APIs or patterns the example demonstrates */\n  features: string[];\n}\n\n/**\n * Metadata for a single reference file within a skill's references/ directory.\n * Extracted from YAML frontmatter or inferred from the markdown heading.\n */\nexport interface SkillReferenceEntry {\n  /** Reference name — matches filename without extension */\n  name: string;\n  /** Short description from frontmatter or first paragraph */\n  description: string;\n  /** Example files for this reference, located in examples/<reference-name>/ */\n  examples?: SkillReferenceExampleEntry[];\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  /** Resolved reference metadata from references/ directory */\n  references?: SkillReferenceEntry[];\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 example levels for manifest validation */\nexport const VALID_EXAMPLE_LEVELS: readonly SkillExampleLevel[] = ['basic', 'intermediate', 'advanced'];\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  'extensibility',\n  'observability',\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;;;AAwIH,mDAAmD;AACtC,QAAA,oBAAoB,GAAiC,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;AAExG,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;IACZ,eAAe;IACf,eAAe;CAChB,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  | 'testing'\n  | 'guides'\n  | 'production'\n  | 'extensibility'\n  | 'observability';\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 * Complexity level for a reference example.\n */\nexport type SkillExampleLevel = 'basic' | 'intermediate' | 'advanced';\n\n/**\n * Metadata for a single example file within a reference's examples/ directory.\n */\nexport interface SkillReferenceExampleEntry {\n  /** Example name — matches filename without extension */\n  name: string;\n  /** Short description of what the example demonstrates */\n  description: string;\n  /** Complexity level */\n  level: SkillExampleLevel;\n  /** Searchable tags for the example */\n  tags: string[];\n  /** Concrete APIs or patterns the example demonstrates */\n  features: string[];\n}\n\n/**\n * Metadata for a single reference file within a skill's references/ directory.\n * Extracted from YAML frontmatter or inferred from the markdown heading.\n */\nexport interface SkillReferenceEntry {\n  /** Reference name — matches filename without extension */\n  name: string;\n  /** Short description from frontmatter or first paragraph */\n  description: string;\n  /** Example files for this reference, located in examples/<reference-name>/ */\n  examples?: SkillReferenceExampleEntry[];\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  /** Resolved reference metadata from references/ directory */\n  references?: SkillReferenceEntry[];\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   * Optional skill quality rating (0..5, one decimal). Surfaced via the\n   * Skills HTTP API for consumers that want to filter by `min-rating` or\n   * sort by quality. Mirrors `SkillMetadata.rating` introduced in v1.2.0.\n   */\n  rating?: number;\n  /**\n   * Other catalog skills this skill depends on (by `name`). Used by the\n   * dependency resolver introduced in v1.2.0 to register dependencies first\n   * during scaffold/install. Aligns with the agentskills Skill Package\n   * Manifest proposal `requires` field.\n   */\n  requires?: string[];\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 example levels for manifest validation */\nexport const VALID_EXAMPLE_LEVELS: readonly SkillExampleLevel[] = ['basic', 'intermediate', 'advanced'];\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  'extensibility',\n  'observability',\n];\n\n/** Valid bundles for manifest validation */\nexport const VALID_BUNDLES: readonly SkillBundle[] = ['recommended', 'minimal', 'full'];\n"]}