@cockpit-ai/skills 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { ResolvedSkill } from '@cockpit-ai/core';
+
+/**
+ * Load a single skill from a YAML file and resolve it to ResolvedSkill.
+ * Throws on validation errors; returns null if file doesn't exist.
+ */
+declare function loadSkillFromFile(filePath: string): ResolvedSkill;
+/**
+ * Load all skills from a directory (*.yaml, *.yml files).
+ * Skips files that fail to load, collecting errors separately.
+ */
+declare function loadSkillsFromDir(dirPath: string): {
+    skills: ResolvedSkill[];
+    errors: Array<{
+        file: string;
+        error: unknown;
+    }>;
+};
+
+declare class SkillRegistry {
+    private skills;
+    add(skill: ResolvedSkill): void;
+    get(name: string): ResolvedSkill | undefined;
+    has(name: string): boolean;
+    list(): ResolvedSkill[];
+    remove(name: string): boolean;
+    size(): number;
+    /**
+     * Load all skills from one or more directories into the registry.
+     * Returns any load errors encountered.
+     */
+    loadFromDirs(dirs: string[]): Array<{
+        file: string;
+        error: unknown;
+    }>;
+}
+
+/**
+ * Returns the YAML content for a new skill template.
+ */
+declare function defaultSkillTemplate(name: string): string;
+/**
+ * Returns the YAML content for a pre-built "code-review" skill.
+ */
+declare function codeReviewTemplate(): string;
+
+export { SkillRegistry, codeReviewTemplate, defaultSkillTemplate, loadSkillFromFile, loadSkillsFromDir };

package/dist/index.js

@@ -0,0 +1,152 @@
+// src/loader.ts
+import { readdirSync, existsSync } from "fs";
+import { join, extname } from "path";
+import {
+  loadConfig,
+  ConfigLoadError,
+  ConfigValidationError,
+  SkillDefinitionSchema
+} from "@cockpit-ai/core";
+function loadSkillFromFile(filePath) {
+  const raw = loadConfig(filePath, SkillDefinitionSchema);
+  return {
+    name: raw.name,
+    version: raw.version,
+    description: raw.description,
+    trigger: raw.trigger ?? [],
+    prompt: raw.prompt,
+    tools: raw.tools ?? [],
+    sourcePath: filePath,
+    adapterConfig: raw.adapters ?? {}
+  };
+}
+function loadSkillsFromDir(dirPath) {
+  if (!existsSync(dirPath)) {
+    return { skills: [], errors: [] };
+  }
+  const skills = [];
+  const errors = [];
+  for (const entry of readdirSync(dirPath, { withFileTypes: true })) {
+    if (!entry.isFile()) continue;
+    const ext = extname(entry.name);
+    if (ext !== ".yaml" && ext !== ".yml") continue;
+    const filePath = join(dirPath, entry.name);
+    try {
+      skills.push(loadSkillFromFile(filePath));
+    } catch (err) {
+      if (err instanceof ConfigLoadError || err instanceof ConfigValidationError) {
+        errors.push({ file: filePath, error: err });
+      } else {
+        throw err;
+      }
+    }
+  }
+  return { skills, errors };
+}
+
+// src/registry.ts
+var SkillRegistry = class {
+  skills = /* @__PURE__ */ new Map();
+  add(skill) {
+    this.skills.set(skill.name, skill);
+  }
+  get(name) {
+    return this.skills.get(name);
+  }
+  has(name) {
+    return this.skills.has(name);
+  }
+  list() {
+    return [...this.skills.values()];
+  }
+  remove(name) {
+    return this.skills.delete(name);
+  }
+  size() {
+    return this.skills.size;
+  }
+  /**
+   * Load all skills from one or more directories into the registry.
+   * Returns any load errors encountered.
+   */
+  loadFromDirs(dirs) {
+    const allErrors = [];
+    for (const dir of dirs) {
+      const { skills, errors } = loadSkillsFromDir(dir);
+      for (const skill of skills) {
+        this.add(skill);
+      }
+      allErrors.push(...errors);
+    }
+    return allErrors;
+  }
+};
+
+// src/templates/default.ts
+function defaultSkillTemplate(name) {
+  return `name: ${name}
+version: 1.0.0
+description: ${name} skill
+
+# Triggers that activate this skill (for tools that support slash commands)
+trigger:
+  - "/${name}"
+
+# The prompt sent to the AI when this skill is triggered
+prompt: |
+  Describe what this skill should do.
+  Add detailed instructions here.
+
+# Tools the AI is allowed to use (leave empty for no restriction)
+tools:
+  - read
+  - grep
+  - glob
+
+# Per-adapter overrides (optional)
+adapters:
+  claude-code:
+    type: command    # creates .claude/commands/${name}.md
+  cursor:
+    type: rule       # creates .cursor/rules/${name}.mdc
+    alwaysApply: false
+`;
+}
+function codeReviewTemplate() {
+  return `name: code-review
+version: 1.0.0
+description: Comprehensive code review
+
+trigger:
+  - "/review"
+  - "review"
+
+prompt: |
+  Review the provided code thoroughly:
+
+  1. **Bugs & Edge Cases** \u2014 identify logic errors, unhandled cases, off-by-one errors
+  2. **Performance** \u2014 flag inefficient algorithms, unnecessary re-renders, N+1 queries
+  3. **Security** \u2014 check for injection, XSS, auth issues, sensitive data exposure
+  4. **Readability** \u2014 suggest clearer names, simpler logic, better structure
+  5. **Tests** \u2014 note missing test coverage for critical paths
+
+  Provide specific, actionable feedback with line references where possible.
+
+tools:
+  - read
+  - grep
+  - glob
+
+adapters:
+  claude-code:
+    type: command
+`;
+}
+export {
+  SkillRegistry,
+  codeReviewTemplate,
+  defaultSkillTemplate,
+  loadSkillFromFile,
+  loadSkillsFromDir
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts","../src/registry.ts","../src/templates/default.ts"],"sourcesContent":["import { readdirSync, existsSync } from \"node:fs\";\nimport { join, extname, basename } from \"node:path\";\nimport {\n  loadConfig,\n  ConfigLoadError,\n  ConfigValidationError,\n  SkillDefinitionSchema,\n  type ResolvedSkill,\n  type AdapterName,\n} from \"@cockpit-ai/core\";\n\n// ─── Skill Loader ──────────────────────────────────────────────────────────\n\n/**\n * Load a single skill from a YAML file and resolve it to ResolvedSkill.\n * Throws on validation errors; returns null if file doesn't exist.\n */\nexport function loadSkillFromFile(filePath: string): ResolvedSkill {\n  const raw = loadConfig(filePath, SkillDefinitionSchema);\n\n  return {\n    name: raw.name,\n    version: raw.version,\n    description: raw.description,\n    trigger: raw.trigger ?? [],\n    prompt: raw.prompt,\n    tools: raw.tools ?? [],\n    sourcePath: filePath,\n    adapterConfig: (raw.adapters ?? {}) as Partial<Record<AdapterName, { type?: string; alwaysApply?: boolean }>>,\n  };\n}\n\n/**\n * Load all skills from a directory (*.yaml, *.yml files).\n * Skips files that fail to load, collecting errors separately.\n */\nexport function loadSkillsFromDir(dirPath: string): {\n  skills: ResolvedSkill[];\n  errors: Array<{ file: string; error: unknown }>;\n} {\n  if (!existsSync(dirPath)) {\n    return { skills: [], errors: [] };\n  }\n\n  const skills: ResolvedSkill[] = [];\n  const errors: Array<{ file: string; error: unknown }> = [];\n\n  for (const entry of readdirSync(dirPath, { withFileTypes: true })) {\n    if (!entry.isFile()) continue;\n    const ext = extname(entry.name);\n    if (ext !== \".yaml\" && ext !== \".yml\") continue;\n\n    const filePath = join(dirPath, entry.name);\n    try {\n      skills.push(loadSkillFromFile(filePath));\n    } catch (err) {\n      if (err instanceof ConfigLoadError || err instanceof ConfigValidationError) {\n        errors.push({ file: filePath, error: err });\n      } else {\n        throw err;\n      }\n    }\n  }\n\n  return { skills, errors };\n}\n","import { type ResolvedSkill } from \"@cockpit-ai/core\";\nimport { loadSkillsFromDir } from \"./loader.js\";\n\n// ─── Skill Registry ────────────────────────────────────────────────────────\n\nexport class SkillRegistry {\n  private skills = new Map<string, ResolvedSkill>();\n\n  add(skill: ResolvedSkill): void {\n    this.skills.set(skill.name, skill);\n  }\n\n  get(name: string): ResolvedSkill | undefined {\n    return this.skills.get(name);\n  }\n\n  has(name: string): boolean {\n    return this.skills.has(name);\n  }\n\n  list(): ResolvedSkill[] {\n    return [...this.skills.values()];\n  }\n\n  remove(name: string): boolean {\n    return this.skills.delete(name);\n  }\n\n  size(): number {\n    return this.skills.size;\n  }\n\n  /**\n   * Load all skills from one or more directories into the registry.\n   * Returns any load errors encountered.\n   */\n  loadFromDirs(dirs: string[]): Array<{ file: string; error: unknown }> {\n    const allErrors: Array<{ file: string; error: unknown }> = [];\n\n    for (const dir of dirs) {\n      const { skills, errors } = loadSkillsFromDir(dir);\n      for (const skill of skills) {\n        this.add(skill);\n      }\n      allErrors.push(...errors);\n    }\n\n    return allErrors;\n  }\n}\n","/**\n * Returns the YAML content for a new skill template.\n */\nexport function defaultSkillTemplate(name: string): string {\n  return `name: ${name}\nversion: 1.0.0\ndescription: ${name} skill\n\n# Triggers that activate this skill (for tools that support slash commands)\ntrigger:\n  - \"/${name}\"\n\n# The prompt sent to the AI when this skill is triggered\nprompt: |\n  Describe what this skill should do.\n  Add detailed instructions here.\n\n# Tools the AI is allowed to use (leave empty for no restriction)\ntools:\n  - read\n  - grep\n  - glob\n\n# Per-adapter overrides (optional)\nadapters:\n  claude-code:\n    type: command    # creates .claude/commands/${name}.md\n  cursor:\n    type: rule       # creates .cursor/rules/${name}.mdc\n    alwaysApply: false\n`;\n}\n\n/**\n * Returns the YAML content for a pre-built \"code-review\" skill.\n */\nexport function codeReviewTemplate(): string {\n  return `name: code-review\nversion: 1.0.0\ndescription: Comprehensive code review\n\ntrigger:\n  - \"/review\"\n  - \"review\"\n\nprompt: |\n  Review the provided code thoroughly:\n\n  1. **Bugs & Edge Cases** — identify logic errors, unhandled cases, off-by-one errors\n  2. **Performance** — flag inefficient algorithms, unnecessary re-renders, N+1 queries\n  3. **Security** — check for injection, XSS, auth issues, sensitive data exposure\n  4. **Readability** — suggest clearer names, simpler logic, better structure\n  5. **Tests** — note missing test coverage for critical paths\n\n  Provide specific, actionable feedback with line references where possible.\n\ntools:\n  - read\n  - grep\n  - glob\n\nadapters:\n  claude-code:\n    type: command\n`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@cockpit-ai/skills",
+  "version": "0.1.0",
+  "description": "Cockpit skill loader and registry",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "yaml": "^2.4.0",
+    "@cockpit-ai/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}