@katipwork/skills 0.1.0

package/README.md

@@ -0,0 +1,118 @@
+# @katipwork/skills
+
+Curated agent skills with an interactive TUI installer.
+
+## Quickstart
+
+```bash
+npx @katipwork/skills
+```
+
+This launches an interactive TUI where you can:
+1. **Select skills** from the available catalog
+2. **Pick target agents** — Pi, Claude Code, Codex, GitHub Copilot, Hermes, Cursor, OpenCode
+3. **Choose install scope** — project or global
+4. **Choose install method** — symlink (recommended) or copy
+
+## Non-interactive usage
+
+```bash
+# List available skills
+npx @katipwork/skills --list
+
+# Install specific skills to specific agents
+npx @katipwork/skills -i code-review tdd -a pi -a claude-code -y
+
+# Install all skills to all detected agents
+npx @katipwork/skills -i '*' --all-agents -y
+
+# Install globally with symlinks
+npx @katipwork/skills -i code-review --all-agents --global -y
+
+# Copy instead of symlink
+npx @katipwork/skills -i code-review -a pi --copy -y
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--help, -h` | Show help |
+| `--list, -l` | List available skills |
+| `--install, -i <skills...>` | Install specific skills (use `'*'` for all) |
+| `--agent, -a <id>` | Target agent (repeatable) |
+| `--all-agents` | Install to all detected agents |
+| `--global, -g` | Install globally (`~/<agent>/skills/`) |
+| `--copy` | Copy files instead of symlinking |
+| `--yes, -y` | Skip confirmation prompts |
+
+## Supported agents
+
+| ID | Agent | Project path | Global path |
+|----|-------|-------------|-------------|
+| `pi` | Pi | `.pi/skills/` | `~/.pi/agent/skills/` |
+| `claude-code` | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
+| `codex` | Codex | `.agents/skills/` | `~/.codex/skills/` |
+| `github-copilot` | GitHub Copilot | `.agents/skills/` | `~/.copilot/skills/` |
+| `hermes-agent` | Hermes Agent | `.hermes/skills/` | `~/.hermes/skills/` |
+| `cursor` | Cursor | `.agents/skills/` | `~/.cursor/skills/` |
+| `opencode` | OpenCode | `.agents/skills/` | `~/.config/opencode/skills/` |
+
+## How it works
+
+### Symlink mode (recommended)
+
+```
+skills/                    your curated skills
+    ↓ copied
+.agents/skills/<name>/     canonical source of truth
+    ↓ symlinked
+.pi/skills/<name>/         agent picks it up from here
+.claude/skills/<name>/     ...
+```
+
+Single source of truth at `.agents/skills/`. Each agent gets a symlink. Update by re-running the installer.
+
+### Copy mode
+
+```
+skills/                    your curated skills
+    ↓ copied directly
+.pi/skills/<name>/         independent copy
+.claude/skills/<name>/     independent copy
+```
+
+Each agent gets its own independent copy. Use when symlinks aren't supported.
+
+## Adding skills
+
+Add skill directories under `skills/`:
+
+```
+skills/
+├── engineering/
+│   └── my-skill/
+│       ├── SKILL.md        # required: YAML frontmatter + markdown
+│       └── agents/
+│           └── openai.yaml # optional: Codex metadata
+└── productivity/
+    └── another-skill/
+        └── SKILL.md
+```
+
+Each `SKILL.md` must have YAML frontmatter:
+
+```yaml
+---
+name: my-skill
+description: What this skill does and when to use it
+---
+
+# My Skill
+
+Instructions for the agent...
+```
+
+## License
+
+MIT

package/dist/cli.cjs

@@ -0,0 +1,669 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/tui.ts
+var import_prompts = require("@inquirer/prompts");
+var import_picocolors = __toESM(require("picocolors"), 1);
+
+// src/agents.ts
+var import_node_os = require("os");
+var import_node_path = require("path");
+var import_node_fs = require("fs");
+var home = (0, import_node_os.homedir)();
+var AGENTS = [
+  {
+    id: "pi",
+    displayName: "Pi",
+    projectSkillsDir: ".pi/skills",
+    globalSkillsDir: (0, import_node_path.join)(home, ".pi/agent/skills"),
+    detectInstalled: () => (0, import_node_fs.existsSync)((0, import_node_path.join)(home, ".pi/agent"))
+  },
+  {
+    id: "claude-code",
+    displayName: "Claude Code",
+    projectSkillsDir: ".claude/skills",
+    globalSkillsDir: (0, import_node_path.join)(home, ".claude/skills"),
+    detectInstalled: () => (0, import_node_fs.existsSync)((0, import_node_path.join)(home, ".claude"))
+  },
+  {
+    id: "codex",
+    displayName: "Codex",
+    projectSkillsDir: ".agents/skills",
+    globalSkillsDir: (0, import_node_path.join)(home, ".codex/skills"),
+    detectInstalled: () => (0, import_node_fs.existsSync)((0, import_node_path.join)(home, ".codex"))
+  },
+  {
+    id: "github-copilot",
+    displayName: "GitHub Copilot",
+    projectSkillsDir: ".agents/skills",
+    globalSkillsDir: (0, import_node_path.join)(home, ".copilot/skills"),
+    detectInstalled: () => (0, import_node_fs.existsSync)((0, import_node_path.join)(home, ".copilot"))
+  },
+  {
+    id: "hermes-agent",
+    displayName: "Hermes Agent",
+    projectSkillsDir: ".hermes/skills",
+    globalSkillsDir: (0, import_node_path.join)(home, ".hermes/skills"),
+    detectInstalled: () => (0, import_node_fs.existsSync)((0, import_node_path.join)(home, ".hermes"))
+  },
+  {
+    id: "cursor",
+    displayName: "Cursor",
+    projectSkillsDir: ".agents/skills",
+    globalSkillsDir: (0, import_node_path.join)(home, ".cursor/skills"),
+    detectInstalled: () => (0, import_node_fs.existsSync)((0, import_node_path.join)(home, ".cursor"))
+  },
+  {
+    id: "opencode",
+    displayName: "OpenCode",
+    projectSkillsDir: ".agents/skills",
+    globalSkillsDir: (0, import_node_path.join)(home, ".config/opencode/skills"),
+    detectInstalled: () => (0, import_node_fs.existsSync)((0, import_node_path.join)(home, ".config/opencode"))
+  }
+];
+function getAgent(id) {
+  return AGENTS.find((a) => a.id === id);
+}
+function detectInstalledAgents() {
+  return AGENTS.filter((a) => a.detectInstalled());
+}
+
+// src/skills.ts
+var import_node_fs2 = require("fs");
+var import_promises = require("fs/promises");
+var import_node_path2 = require("path");
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+  const data = {};
+  for (const line of match[1].split("\n")) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    const key = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).trim();
+    if (key && value) data[key] = value;
+  }
+  return { data };
+}
+function getSkillsRoot() {
+  const bundledPath = (0, import_node_path2.join)(__dirname, "..", "skills");
+  if ((0, import_node_fs2.existsSync)(bundledPath)) return bundledPath;
+  return (0, import_node_path2.join)(process.cwd(), "skills");
+}
+async function discoverSkills() {
+  const skillsRoot = getSkillsRoot();
+  const skills = [];
+  if (!(0, import_node_fs2.existsSync)(skillsRoot)) {
+    return skills;
+  }
+  async function walk(dir, category = "") {
+    let entries;
+    try {
+      entries = await (0, import_promises.readdir)(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+      const fullPath = (0, import_node_path2.join)(dir, entry.name);
+      const skillMdPath = (0, import_node_path2.join)(fullPath, "SKILL.md");
+      if ((0, import_node_fs2.existsSync)(skillMdPath)) {
+        try {
+          const content = (0, import_node_fs2.readFileSync)(skillMdPath, "utf-8");
+          const parsed = parseFrontmatter(content);
+          if (parsed && parsed.data.name) {
+            skills.push({
+              name: parsed.data.name,
+              description: parsed.data.description || "",
+              dirPath: fullPath,
+              category: category || (0, import_node_path2.basename)((0, import_node_path2.dirname)(fullPath))
+            });
+          }
+        } catch {
+        }
+      } else {
+        const subCategory = category ? `${category}/${entry.name}` : entry.name;
+        await walk(fullPath, category || entry.name);
+      }
+    }
+  }
+  await walk(skillsRoot);
+  return skills.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// src/installer.ts
+var import_promises2 = require("fs/promises");
+var import_node_path3 = require("path");
+var import_node_os2 = require("os");
+var home2 = (0, import_node_os2.homedir)();
+function getCanonicalDir(global, cwd) {
+  const base = global ? home2 : cwd || process.cwd();
+  return (0, import_node_path3.join)(base, ".agents", "skills");
+}
+function getAgentSkillsDir(agent, global, cwd) {
+  const base = global ? home2 : cwd || process.cwd();
+  return global ? agent.globalSkillsDir : (0, import_node_path3.join)(base, agent.projectSkillsDir);
+}
+async function resolveParentSymlinks(p) {
+  const d = (0, import_node_path3.dirname)(p);
+  const b = (0, import_node_path3.basename)(p);
+  try {
+    return (0, import_node_path3.join)(await (0, import_promises2.realpath)(d), b);
+  } catch {
+    return p;
+  }
+}
+async function createSymlink(target, linkPath) {
+  try {
+    const resolvedTarget = (0, import_node_path3.resolve)(target);
+    const resolvedLinkPath = (0, import_node_path3.resolve)(linkPath);
+    try {
+      const [realTrg, realLnk] = await Promise.all([
+        (0, import_promises2.realpath)(resolvedTarget),
+        (0, import_promises2.realpath)(resolvedLinkPath)
+      ]);
+      if (realTrg === realLnk) return true;
+    } catch {
+    }
+    const realTgtWithParent = await resolveParentSymlinks(target);
+    const realLnkWithParent = await resolveParentSymlinks(linkPath);
+    if (realTgtWithParent === realLnkWithParent) return true;
+    try {
+      const stats = await (0, import_promises2.lstat)(linkPath);
+      if (stats.isSymbolicLink()) {
+        const existing = await (0, import_promises2.readlink)(linkPath);
+        if ((0, import_node_path3.resolve)((0, import_node_path3.dirname)(linkPath), existing) === resolvedTarget) return true;
+        await (0, import_promises2.rm)(linkPath);
+      } else {
+        await (0, import_promises2.rm)(linkPath, { recursive: true });
+      }
+    } catch {
+    }
+    const linkDir = (0, import_node_path3.dirname)(linkPath);
+    await (0, import_promises2.mkdir)(linkDir, { recursive: true });
+    const realLinkDir = await resolveParentSymlinks(linkDir);
+    const relPath = (0, import_node_path3.relative)(realLinkDir, target);
+    await (0, import_promises2.symlink)(relPath, linkPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function copyDir(src, dest) {
+  await (0, import_promises2.mkdir)(dest, { recursive: true });
+  await (0, import_promises2.cp)(src, dest, {
+    recursive: true,
+    dereference: true,
+    filter: (srcPath) => {
+      const name = (0, import_node_path3.basename)(srcPath);
+      return name !== ".git" && name !== "node_modules";
+    }
+  });
+}
+async function installSkill(skill, agent, options = {}) {
+  const isGlobal = options.global ?? false;
+  const cwd = options.cwd ?? process.cwd();
+  const mode = options.mode ?? "symlink";
+  const skillName = skill.name;
+  const canonicalDir = (0, import_node_path3.join)(getCanonicalDir(isGlobal, cwd), skillName);
+  const agentDir = (0, import_node_path3.join)(getAgentSkillsDir(agent, isGlobal, cwd), skillName);
+  try {
+    if (mode === "copy") {
+      await (0, import_promises2.rm)(agentDir, { recursive: true, force: true });
+      await copyDir(skill.dirPath, agentDir);
+      return { skill: skillName, agent: agent.id, success: true, path: agentDir, mode: "copy" };
+    }
+    await (0, import_promises2.rm)(canonicalDir, { recursive: true, force: true });
+    await copyDir(skill.dirPath, canonicalDir);
+    if (agent.projectSkillsDir === ".agents/skills" && !isGlobal) {
+      return {
+        skill: skillName,
+        agent: agent.id,
+        success: true,
+        path: canonicalDir,
+        mode: "symlink"
+      };
+    }
+    const ok = await createSymlink(canonicalDir, agentDir);
+    if (!ok) {
+      await (0, import_promises2.rm)(agentDir, { recursive: true, force: true });
+      await copyDir(skill.dirPath, agentDir);
+    }
+    return {
+      skill: skillName,
+      agent: agent.id,
+      success: true,
+      path: ok ? agentDir : agentDir,
+      mode: "symlink"
+    };
+  } catch (err) {
+    return {
+      skill: skillName,
+      agent: agent.id,
+      success: false,
+      path: agentDir,
+      mode,
+      error: err instanceof Error ? err.message : "Unknown error"
+    };
+  }
+}
+async function installSkills(skills, agents, options = {}) {
+  const results = [];
+  for (const skill of skills) {
+    for (const agent of agents) {
+      results.push(await installSkill(skill, agent, options));
+    }
+  }
+  return results;
+}
+
+// src/tui.ts
+function spinner(message) {
+  const frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+  let i = 0;
+  let running = true;
+  const timer = setInterval(() => {
+    process.stderr.write(`\r${frames[i++ % frames.length]} ${message}`);
+  }, 80);
+  return {
+    succeed(text) {
+      clearInterval(timer);
+      process.stderr.write(`\r${import_picocolors.default.green("\u2713")} ${text}
+`);
+      running = false;
+    },
+    fail(text) {
+      clearInterval(timer);
+      process.stderr.write(`\r${import_picocolors.default.red("\u2717")} ${text}
+`);
+      running = false;
+    },
+    stop() {
+      clearInterval(timer);
+      process.stderr.write("\r" + " ".repeat(message.length + 4) + "\r");
+      running = false;
+    }
+  };
+}
+var theme = {
+  style: {
+    highlight: (text) => import_picocolors.default.cyan(text)
+  }
+};
+async function selectSkills(skills) {
+  if (skills.length === 0) {
+    console.log(import_picocolors.default.yellow("No skills found in skills/ directory."));
+    return [];
+  }
+  const choices = skills.map((s) => ({
+    name: `${import_picocolors.default.bold(s.name)} ${import_picocolors.default.dim(`\u2014 ${s.description}`)}`,
+    value: s
+  }));
+  choices.unshift({
+    name: import_picocolors.default.italic("Select all skills"),
+    value: "__all__"
+  });
+  const selected = await (0, import_prompts.checkbox)({
+    message: "Select skills to install:",
+    choices,
+    pageSize: 15,
+    loop: false,
+    theme: {
+      ...theme,
+      helpMode: "auto"
+    }
+  });
+  if (selected.some((s) => s === "__all__")) {
+    return skills;
+  }
+  return selected;
+}
+async function selectAgents() {
+  const detected = detectInstalledAgents();
+  const detectedIds = new Set(detected.map((a) => a.id));
+  const choices = AGENTS.map((a) => ({
+    name: detectedIds.has(a.id) ? `${a.displayName} ${import_picocolors.default.green("(detected)")}` : a.displayName,
+    value: a,
+    checked: detectedIds.has(a.id)
+  }));
+  return (0, import_prompts.checkbox)({
+    message: "Select target agents:",
+    choices,
+    pageSize: 12,
+    loop: false,
+    theme: {
+      ...theme,
+      helpMode: "auto"
+    },
+    validate: (answer) => {
+      if (answer.length === 0) return "Select at least one agent.";
+      return true;
+    }
+  });
+}
+async function selectScope() {
+  return (0, import_prompts.select)({
+    message: "Install scope:",
+    choices: [
+      {
+        name: `${import_picocolors.default.bold("Project")} \u2014 install to ./<agent>/skills/ (shared with your team)`,
+        value: false
+      },
+      {
+        name: `${import_picocolors.default.bold("Global")} \u2014 install to ~/<agent>/skills/ (available everywhere)`,
+        value: true
+      }
+    ],
+    default: false
+  });
+}
+async function selectMode() {
+  return (0, import_prompts.select)({
+    message: "Install method:",
+    choices: [
+      {
+        name: `${import_picocolors.default.bold("Symlink")} ${import_picocolors.default.green("(recommended)")} \u2014 single source of truth at .agents/skills/, symlinked to agent dirs. Easy updates.`,
+        value: "symlink"
+      },
+      {
+        name: `${import_picocolors.default.bold("Copy")} \u2014 independent copies for each agent. Use when symlinks aren't supported.`,
+        value: "copy"
+      }
+    ],
+    default: "symlink"
+  });
+}
+async function confirmInstallation(skills, agents, global, mode) {
+  console.log("\n" + import_picocolors.default.cyan("\u2500\u2500\u2500 Installation summary \u2500\u2500\u2500"));
+  console.log(import_picocolors.default.white(`  Skills:  ${import_picocolors.default.bold(skills.map((s) => s.name).join(", "))}`));
+  console.log(import_picocolors.default.white(`  Agents:  ${import_picocolors.default.bold(agents.map((a) => a.displayName).join(", "))}`));
+  console.log(import_picocolors.default.white(`  Scope:   ${import_picocolors.default.bold(global ? "Global" : "Project")}`));
+  console.log(import_picocolors.default.white(`  Method:  ${import_picocolors.default.bold(mode === "symlink" ? "Symlink (canonical at .agents/skills/)" : "Copy")}`));
+  console.log("");
+  return (0, import_prompts.confirm)({
+    message: "Proceed with installation?",
+    default: true
+  });
+}
+function printResults(results) {
+  const succeeded = results.filter((r) => r.success);
+  const failed = results.filter((r) => !r.success);
+  console.log("");
+  if (succeeded.length > 0) {
+    console.log(import_picocolors.default.green(`\u2713 ${succeeded.length} skill(s) installed successfully:`));
+    for (const r of succeeded) {
+      console.log(import_picocolors.default.dim(`  ${r.skill} \u2192 ${r.agent} (${r.mode}) \u2192 ${r.path}`));
+    }
+  }
+  if (failed.length > 0) {
+    console.log(import_picocolors.default.red(`\u2717 ${failed.length} skill(s) failed:`));
+    for (const r of failed) {
+      console.log(import_picocolors.default.red(`  ${r.skill} \u2192 ${r.agent}: ${r.error}`));
+    }
+  }
+  if (succeeded.length > 0) {
+    console.log("");
+    console.log(import_picocolors.default.cyan("Tip:"));
+    console.log(import_picocolors.default.dim("  Skills are installed. Restart your agent for changes to take effect."));
+    console.log(import_picocolors.default.dim("  To update, re-run this installer or git pull + re-link."));
+  }
+}
+async function runTui() {
+  console.log("");
+  console.log(import_picocolors.default.bold(import_picocolors.default.cyan("@katipwork/skills")));
+  console.log(import_picocolors.default.dim("Curated agent skills installer"));
+  console.log("");
+  const discoverSpinner = spinner("Discovering skills...");
+  let skills;
+  try {
+    skills = await discoverSkills();
+    discoverSpinner.succeed(`Found ${skills.length} skill(s).`);
+  } catch (err) {
+    discoverSpinner.fail("Failed to discover skills.");
+    console.error(err);
+    process.exit(1);
+  }
+  if (skills.length === 0) {
+    console.log(import_picocolors.default.yellow("No skills found. Add SKILL.md files under skills/ and try again."));
+    process.exit(0);
+  }
+  const selectedSkills = await selectSkills(skills);
+  if (selectedSkills.length === 0) {
+    console.log(import_picocolors.default.yellow("No skills selected. Exiting."));
+    process.exit(0);
+  }
+  const selectedAgents = await selectAgents();
+  const global = await selectScope();
+  const mode = await selectMode();
+  const confirmed = await confirmInstallation(selectedSkills, selectedAgents, global, mode);
+  if (!confirmed) {
+    console.log(import_picocolors.default.yellow("Installation cancelled."));
+    process.exit(0);
+  }
+  const installSpinner = spinner("Installing skills...");
+  let results;
+  try {
+    results = await installSkills(selectedSkills, selectedAgents, { global, mode });
+    installSpinner.stop();
+  } catch (err) {
+    installSpinner.fail("Installation failed.");
+    console.error(err);
+    process.exit(1);
+  }
+  printResults(results);
+  if (results.some((r) => !r.success)) {
+    process.exit(1);
+  }
+}
+
+// src/cli-args.ts
+var import_picocolors2 = __toESM(require("picocolors"), 1);
+function showHelp() {
+  console.log(`
+${import_picocolors2.default.bold(import_picocolors2.default.cyan("@katipwork/skills"))} \u2014 Curated agent skills installer
+
+${import_picocolors2.default.bold("Usage:")}
+  npx @katipwork/skills               Interactive TUI (default)
+  npx @katipwork/skills --list        List available skills
+  npx @katipwork/skills --install <skills...> [options]
+
+${import_picocolors2.default.bold("Options:")}
+  --help, -h          Show this help
+  --list, -l          List available skills and exit
+  --install, -i       Install specific skills (followed by skill names)
+  --agent, -a         Target agent(s): pi, claude-code, codex, github-copilot,
+                      hermes-agent, cursor, opencode (can repeat)
+  --all-agents        Install to all detected agents
+  --global, -g        Install globally (~/<agent>/skills/)
+  --copy              Copy files instead of symlinking
+  --yes, -y           Skip confirmation prompt
+
+${import_picocolors2.default.bold("Examples:")}
+  npx @katipwork/skills
+  npx @katipwork/skills --list
+  npx @katipwork/skills -i code-review tdd -a pi -a claude-code -y
+  npx @katipwork/skills -i '*' --all-agents --global
+
+${import_picocolors2.default.bold("Agents:")}
+  ${AGENTS.map((a) => `${a.id} (${a.displayName})`).join(", ")}
+
+${import_picocolors2.default.dim("Source: https://github.com/katipwork/skills")}
+`);
+}
+function parseArgs(args2) {
+  const result = {
+    help: false,
+    list: false,
+    install: [],
+    agents: [],
+    allAgents: false,
+    global: false,
+    copy: false,
+    yes: false
+  };
+  let i = 0;
+  while (i < args2.length) {
+    const arg = args2[i];
+    switch (arg) {
+      case "--help":
+      case "-h":
+        result.help = true;
+        break;
+      case "--list":
+      case "-l":
+        result.list = true;
+        break;
+      case "--install":
+      case "-i":
+        i++;
+        while (i < args2.length && !args2[i].startsWith("-")) {
+          result.install.push(args2[i]);
+          i++;
+        }
+        i--;
+        break;
+      case "--agent":
+      case "-a":
+        i++;
+        while (i < args2.length && !args2[i].startsWith("-")) {
+          result.agents.push(args2[i]);
+          i++;
+        }
+        i--;
+        break;
+      case "--all-agents":
+        result.allAgents = true;
+        break;
+      case "--global":
+      case "-g":
+        result.global = true;
+        break;
+      case "--copy":
+        result.copy = true;
+        break;
+      case "--yes":
+      case "-y":
+        result.yes = true;
+        break;
+      default:
+        if (!arg.startsWith("-")) {
+          result.install.push(arg);
+        }
+    }
+    i++;
+  }
+  return result;
+}
+async function runCli(rawArgs) {
+  const args2 = parseArgs(rawArgs);
+  if (args2.help) {
+    showHelp();
+    process.exit(0);
+  }
+  if (args2.list) {
+    const skills = await discoverSkills();
+    if (skills.length === 0) {
+      console.log(import_picocolors2.default.yellow("No skills found."));
+    } else {
+      console.log(import_picocolors2.default.bold(`Available skills (${skills.length}):
+`));
+      for (const s of skills) {
+        console.log(`  ${import_picocolors2.default.bold(import_picocolors2.default.cyan(s.name))}`);
+        console.log(`    ${import_picocolors2.default.dim(s.description)}`);
+        console.log(`    category: ${s.category}`);
+        console.log("");
+      }
+    }
+    process.exit(0);
+  }
+  if (args2.install.length > 0) {
+    const allSkills = await discoverSkills();
+    let skillsToInstall = allSkills;
+    if (!args2.install.includes("*")) {
+      skillsToInstall = allSkills.filter(
+        (s) => args2.install.some((name) => s.name === name)
+      );
+      const notFound = args2.install.filter(
+        (name) => !allSkills.some((s) => s.name === name)
+      );
+      if (notFound.length > 0) {
+        console.log(import_picocolors2.default.yellow(`Warning: skills not found: ${notFound.join(", ")}`));
+      }
+    }
+    if (skillsToInstall.length === 0) {
+      console.log(import_picocolors2.default.red("No matching skills found to install."));
+      process.exit(1);
+    }
+    let agentsToUse = args2.agents.map((id) => getAgent(id)).filter((a) => !!a);
+    if (args2.allAgents) {
+      agentsToUse = AGENTS;
+    }
+    if (agentsToUse.length === 0) {
+      console.log(import_picocolors2.default.red("No agents specified. Use --agent <id> or --all-agents."));
+      process.exit(1);
+    }
+    const mode = args2.copy ? "copy" : "symlink";
+    console.log(import_picocolors2.default.cyan("\n\u2500\u2500\u2500 Installing \u2500\u2500\u2500"));
+    console.log(`  Skills: ${import_picocolors2.default.bold(skillsToInstall.map((s) => s.name).join(", "))}`);
+    console.log(`  Agents: ${import_picocolors2.default.bold(agentsToUse.map((a) => a.displayName).join(", "))}`);
+    console.log(`  Scope:  ${import_picocolors2.default.bold(args2.global ? "Global" : "Project")}`);
+    console.log(`  Method: ${import_picocolors2.default.bold(mode)}`);
+    console.log("");
+    const results = await installSkills(skillsToInstall, agentsToUse, {
+      global: args2.global,
+      mode
+    });
+    const succeeded = results.filter((r) => r.success);
+    const failed = results.filter((r) => !r.success);
+    if (succeeded.length > 0) {
+      console.log(import_picocolors2.default.green(`\u2713 ${succeeded.length} installed successfully`));
+    }
+    if (failed.length > 0) {
+      console.log(import_picocolors2.default.red(`\u2717 ${failed.length} failed`));
+      for (const r of failed) {
+        console.log(import_picocolors2.default.red(`  ${r.skill} \u2192 ${r.agent}: ${r.error}`));
+      }
+      process.exit(1);
+    }
+    process.exit(0);
+  }
+  showHelp();
+}
+
+// src/cli.ts
+var args = process.argv.slice(2);
+if (args.length > 0) {
+  runCli(args).catch((err) => {
+    console.error("Error:", err.message);
+    process.exit(1);
+  });
+} else {
+  runTui().catch((err) => {
+    console.error("Unexpected error:", err);
+    process.exit(1);
+  });
+}
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tui.ts","../src/agents.ts","../src/skills.ts","../src/installer.ts","../src/cli-args.ts","../src/cli.ts"],"sourcesContent":["import { search, checkbox, select, confirm } from '@inquirer/prompts';\nimport pc from 'picocolors';\nimport { AGENTS, detectInstalledAgents, type AgentConfig } from './agents.js';\nimport { discoverSkills, type SkillMeta } from './skills.js';\nimport { installSkills, type InstallMode, type InstallResult } from './installer.js';\n\n// ─── simple spinner ────────────────────────────────────────────\n\nfunction spinner(message: string) {\n  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\n  let i = 0;\n  let running = true;\n  const timer = setInterval(() => {\n    process.stderr.write(`\\r${frames[i++ % frames.length]} ${message}`);\n  }, 80);\n  return {\n    succeed(text: string) {\n      clearInterval(timer);\n      process.stderr.write(`\\r${pc.green('✓')} ${text}\\n`);\n      running = false;\n    },\n    fail(text: string) {\n      clearInterval(timer);\n      process.stderr.write(`\\r${pc.red('✗')} ${text}\\n`);\n      running = false;\n    },\n    stop() {\n      clearInterval(timer);\n      process.stderr.write('\\r' + ' '.repeat(message.length + 4) + '\\r');\n      running = false;\n    },\n  };\n}\n\n// ─── theme helpers ──────────────────────────────────────────────\n\nconst theme = {\n  style: {\n    highlight: (text: string) => pc.cyan(text),\n  },\n};\n\n// ─── steps ──────────────────────────────────────────────────────\n\nasync function selectSkills(skills: SkillMeta[]): Promise<SkillMeta[]> {\n  if (skills.length === 0) {\n    console.log(pc.yellow('No skills found in skills/ directory.'));\n    return [];\n  }\n\n  const choices = skills.map((s) => ({\n    name: `${pc.bold(s.name)} ${pc.dim(`— ${s.description}`)}`,\n    value: s,\n  }));\n\n  // Add a \"select all\" option\n  choices.unshift({\n    name: pc.italic('Select all skills'),\n    value: '__all__' as unknown as SkillMeta,\n  });\n\n  const selected = await checkbox({\n    message: 'Select skills to install:',\n    choices,\n    pageSize: 15,\n    loop: false,\n    theme: {\n      ...theme,\n      helpMode: 'auto',\n    },\n  });\n\n  // Handle \"select all\"\n  if (selected.some((s: SkillMeta | string) => (s as unknown as string) === '__all__')) {\n    return skills;\n  }\n\n  return selected as SkillMeta[];\n}\n\nasync function selectAgents(): Promise<AgentConfig[]> {\n  const detected = detectInstalledAgents();\n  const detectedIds = new Set(detected.map((a) => a.id));\n\n  const choices = AGENTS.map((a) => ({\n    name: detectedIds.has(a.id)\n      ? `${a.displayName} ${pc.green('(detected)')}`\n      : a.displayName,\n    value: a,\n    checked: detectedIds.has(a.id),\n  }));\n\n  return checkbox({\n    message: 'Select target agents:',\n    choices,\n    pageSize: 12,\n    loop: false,\n    theme: {\n      ...theme,\n      helpMode: 'auto',\n    },\n    validate: (answer) => {\n      if (answer.length === 0) return 'Select at least one agent.';\n      return true;\n    },\n  });\n}\n\nasync function selectScope(): Promise<boolean> {\n  return select({\n    message: 'Install scope:',\n    choices: [\n      {\n        name: `${pc.bold('Project')} — install to ./<agent>/skills/ (shared with your team)`,\n        value: false,\n      },\n      {\n        name: `${pc.bold('Global')} — install to ~/<agent>/skills/ (available everywhere)`,\n        value: true,\n      },\n    ],\n    default: false,\n  });\n}\n\nasync function selectMode(): Promise<InstallMode> {\n  return select({\n    message: 'Install method:',\n    choices: [\n      {\n        name: `${pc.bold('Symlink')} ${pc.green('(recommended)')} — single source of truth at .agents/skills/, symlinked to agent dirs. Easy updates.`,\n        value: 'symlink',\n      },\n      {\n        name: `${pc.bold('Copy')} — independent copies for each agent. Use when symlinks aren't supported.`,\n        value: 'copy',\n      },\n    ],\n    default: 'symlink',\n  });\n}\n\nasync function confirmInstallation(\n  skills: SkillMeta[],\n  agents: AgentConfig[],\n  global: boolean,\n  mode: InstallMode,\n): Promise<boolean> {\n  console.log('\\n' + pc.cyan('─── Installation summary ───'));\n  console.log(pc.white(`  Skills:  ${pc.bold(skills.map((s) => s.name).join(', '))}`));\n  console.log(pc.white(`  Agents:  ${pc.bold(agents.map((a) => a.displayName).join(', '))}`));\n  console.log(pc.white(`  Scope:   ${pc.bold(global ? 'Global' : 'Project')}`));\n  console.log(pc.white(`  Method:  ${pc.bold(mode === 'symlink' ? 'Symlink (canonical at .agents/skills/)' : 'Copy')}`));\n  console.log('');\n\n  return confirm({\n    message: 'Proceed with installation?',\n    default: true,\n  });\n}\n\nfunction printResults(results: InstallResult[]): void {\n  const succeeded = results.filter((r) => r.success);\n  const failed = results.filter((r) => !r.success);\n\n  console.log('');\n  if (succeeded.length > 0) {\n    console.log(pc.green(`✓ ${succeeded.length} skill(s) installed successfully:`));\n    for (const r of succeeded) {\n      console.log(pc.dim(`  ${r.skill} → ${r.agent} (${r.mode}) → ${r.path}`));\n    }\n  }\n  if (failed.length > 0) {\n    console.log(pc.red(`✗ ${failed.length} skill(s) failed:`));\n    for (const r of failed) {\n      console.log(pc.red(`  ${r.skill} → ${r.agent}: ${r.error}`));\n    }\n  }\n\n  // Post-install hints\n  if (succeeded.length > 0) {\n    console.log('');\n    console.log(pc.cyan('Tip:'));\n    console.log(pc.dim('  Skills are installed. Restart your agent for changes to take effect.'));\n    console.log(pc.dim('  To update, re-run this installer or git pull + re-link.'));\n  }\n}\n\n// ─── main ───────────────────────────────────────────────────────\n\nexport async function runTui(): Promise<void> {\n  console.log('');\n  console.log(pc.bold(pc.cyan('@katipwork/skills')));\n  console.log(pc.dim('Curated agent skills installer'));\n  console.log('');\n\n  // 1. Discover skills\n  const discoverSpinner = spinner('Discovering skills...');\n  let skills: SkillMeta[];\n  try {\n    skills = await discoverSkills();\n    discoverSpinner.succeed(`Found ${skills.length} skill(s).`);\n  } catch (err) {\n    discoverSpinner.fail('Failed to discover skills.');\n    console.error(err);\n    process.exit(1);\n  }\n\n  if (skills.length === 0) {\n    console.log(pc.yellow('No skills found. Add SKILL.md files under skills/ and try again.'));\n    process.exit(0);\n  }\n\n  // 2. Select skills\n  const selectedSkills = await selectSkills(skills);\n  if (selectedSkills.length === 0) {\n    console.log(pc.yellow('No skills selected. Exiting.'));\n    process.exit(0);\n  }\n\n  // 3. Select agents\n  const selectedAgents = await selectAgents();\n\n  // 4. Scope\n  const global = await selectScope();\n\n  // 5. Mode\n  const mode = await selectMode();\n\n  // 6. Confirm\n  const confirmed = await confirmInstallation(selectedSkills, selectedAgents, global, mode);\n  if (!confirmed) {\n    console.log(pc.yellow('Installation cancelled.'));\n    process.exit(0);\n  }\n\n  // 7. Install\n  const installSpinner = spinner('Installing skills...');\n  let results: InstallResult[];\n  try {\n    results = await installSkills(selectedSkills, selectedAgents, { global, mode });\n    installSpinner.stop();\n  } catch (err) {\n    installSpinner.fail('Installation failed.');\n    console.error(err);\n    process.exit(1);\n  }\n\n  printResults(results);\n\n  if (results.some((r) => !r.success)) {\n    process.exit(1);\n  }\n}\n","import { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport { existsSync } from 'node:fs';\n\nconst home = homedir();\n\nexport interface AgentConfig {\n  /** CLI flag value, e.g. \"claude-code\" */\n  id: string;\n  /** Human-readable label */\n  displayName: string;\n  /** Relative path from project root for project-scoped installs */\n  projectSkillsDir: string;\n  /** Absolute path for global installs */\n  globalSkillsDir: string;\n  /** Quick check if agent is installed */\n  detectInstalled: () => boolean;\n}\n\nexport type AgentId = (typeof AGENTS)[number]['id'];\n\n/**\n * All supported coding agents.\n * Each has a project-skills dir (relative to CWD) and a global-skills dir (absolute).\n */\nexport const AGENTS: AgentConfig[] = [\n  {\n    id: 'pi',\n    displayName: 'Pi',\n    projectSkillsDir: '.pi/skills',\n    globalSkillsDir: join(home, '.pi/agent/skills'),\n    detectInstalled: () => existsSync(join(home, '.pi/agent')),\n  },\n  {\n    id: 'claude-code',\n    displayName: 'Claude Code',\n    projectSkillsDir: '.claude/skills',\n    globalSkillsDir: join(home, '.claude/skills'),\n    detectInstalled: () => existsSync(join(home, '.claude')),\n  },\n  {\n    id: 'codex',\n    displayName: 'Codex',\n    projectSkillsDir: '.agents/skills',\n    globalSkillsDir: join(home, '.codex/skills'),\n    detectInstalled: () => existsSync(join(home, '.codex')),\n  },\n  {\n    id: 'github-copilot',\n    displayName: 'GitHub Copilot',\n    projectSkillsDir: '.agents/skills',\n    globalSkillsDir: join(home, '.copilot/skills'),\n    detectInstalled: () => existsSync(join(home, '.copilot')),\n  },\n  {\n    id: 'hermes-agent',\n    displayName: 'Hermes Agent',\n    projectSkillsDir: '.hermes/skills',\n    globalSkillsDir: join(home, '.hermes/skills'),\n    detectInstalled: () => existsSync(join(home, '.hermes')),\n  },\n  {\n    id: 'cursor',\n    displayName: 'Cursor',\n    projectSkillsDir: '.agents/skills',\n    globalSkillsDir: join(home, '.cursor/skills'),\n    detectInstalled: () => existsSync(join(home, '.cursor')),\n  },\n  {\n    id: 'opencode',\n    displayName: 'OpenCode',\n    projectSkillsDir: '.agents/skills',\n    globalSkillsDir: join(home, '.config/opencode/skills'),\n    detectInstalled: () => existsSync(join(home, '.config/opencode')),\n  },\n];\n\n/** Lookup agent config by id */\nexport function getAgent(id: string): AgentConfig | undefined {\n  return AGENTS.find((a) => a.id === id);\n}\n\n/** Detect which agents are installed on this machine */\nexport function detectInstalledAgents(): AgentConfig[] {\n  return AGENTS.filter((a) => a.detectInstalled());\n}\n","import { readFileSync, existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { join, basename, dirname } from 'node:path';\n\n// In CJS, __dirname is a global pointing to the directory of the current file.\n// After build, __dirname is dist/ and skills/ is at ../skills.\ndeclare const __dirname: string;\n\nexport interface SkillMeta {\n  /** Skill name from SKILL.md frontmatter */\n  name: string;\n  /** Description from SKILL.md frontmatter */\n  description: string;\n  /** Path to the skill directory on disk */\n  dirPath: string;\n  /** Which category/bucket the skill lives in, e.g. \"engineering\" */\n  category: string;\n}\n\n/**\n * Parse YAML frontmatter from a SKILL.md file.\n * Minimal parser that handles `---` delimited frontmatter.\n */\nfunction parseFrontmatter(content: string): { data: Record<string, string> } | null {\n  const match = content.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---/);\n  if (!match) return null;\n\n  const data: Record<string, string> = {};\n  for (const line of match[1].split('\\n')) {\n    const colonIdx = line.indexOf(':');\n    if (colonIdx === -1) continue;\n    const key = line.slice(0, colonIdx).trim();\n    const value = line.slice(colonIdx + 1).trim();\n    if (key && value) data[key] = value;\n  }\n  return { data };\n}\n\n/**\n * Find the skills/ directory.\n * When built: dist/ → ../skills\n * When running from source (tsx): src/ → ../skills\n * When installed globally: <package>/dist/ → ../skills\n */\nfunction getSkillsRoot(): string {\n  // dist/ → ../skills (bundled case)\n  const bundledPath = join(__dirname, '..', 'skills');\n  if (existsSync(bundledPath)) return bundledPath;\n\n  // CWD fallback\n  return join(process.cwd(), 'skills');\n}\n\n/**\n * Discover all skills under skills/.\n * Skills can be at skills/<name>/SKILL.md or skills/<category>/<name>/SKILL.md.\n */\nexport async function discoverSkills(): Promise<SkillMeta[]> {\n  const skillsRoot = getSkillsRoot();\n  const skills: SkillMeta[] = [];\n\n  if (!existsSync(skillsRoot)) {\n    return skills;\n  }\n\n  async function walk(dir: string, category: string = ''): Promise<void> {\n    let entries;\n    try {\n      entries = await readdir(dir, { withFileTypes: true });\n    } catch {\n      return;\n    }\n\n    for (const entry of entries) {\n      if (!entry.isDirectory()) continue;\n      if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;\n\n      const fullPath = join(dir, entry.name);\n      const skillMdPath = join(fullPath, 'SKILL.md');\n\n      if (existsSync(skillMdPath)) {\n        // This is a skill directory (has SKILL.md)\n        try {\n          const content = readFileSync(skillMdPath, 'utf-8');\n          const parsed = parseFrontmatter(content);\n          if (parsed && parsed.data.name) {\n            skills.push({\n              name: parsed.data.name,\n              description: parsed.data.description || '',\n              dirPath: fullPath,\n              category: category || basename(dirname(fullPath)),\n            });\n          }\n        } catch {\n          // skip broken skills\n        }\n      } else {\n        // Recurse into subdirectories (category level)\n        const subCategory = category ? `${category}/${entry.name}` : entry.name;\n        await walk(fullPath, category || entry.name);\n      }\n    }\n  }\n\n  await walk(skillsRoot);\n  return skills.sort((a, b) => a.name.localeCompare(b.name));\n}\n","import { existsSync } from 'node:fs';\nimport {\n  mkdir,\n  cp,\n  symlink,\n  rm,\n  readlink,\n  lstat,\n  realpath,\n  stat,\n} from 'node:fs/promises';\nimport { join, relative, dirname, resolve, basename } from 'node:path';\nimport { homedir } from 'node:os';\nimport type { AgentConfig } from './agents.js';\nimport type { SkillMeta } from './skills.js';\n\nconst home = homedir();\n\nexport type InstallMode = 'symlink' | 'copy';\n\nexport interface InstallResult {\n  skill: string;\n  agent: string;\n  success: boolean;\n  path: string;\n  mode: InstallMode;\n  error?: string;\n}\n\n/** Canonical skills directory: .agents/skills/ */\nexport function getCanonicalDir(global: boolean, cwd?: string): string {\n  const base = global ? home : cwd || process.cwd();\n  return join(base, '.agents', 'skills');\n}\n\nfunction getAgentSkillsDir(agent: AgentConfig, global: boolean, cwd?: string): string {\n  const base = global ? home : cwd || process.cwd();\n  return global ? agent.globalSkillsDir : join(base, agent.projectSkillsDir);\n}\n\n/**\n * Resolve a symlink's parent directory to its real path.\n * Handles the case where e.g. ~/.claude/skills is a symlink to ~/.agents/skills.\n */\nasync function resolveParentSymlinks(p: string): Promise<string> {\n  const d = dirname(p);\n  const b = basename(p);\n  try {\n    return join(await realpath(d), b);\n  } catch {\n    return p;\n  }\n}\n\n/**\n * Create a symlink at `linkPath` pointing to `target`.\n * Returns true on success, false if fallback to copy is needed.\n */\nasync function createSymlink(target: string, linkPath: string): Promise<boolean> {\n  try {\n    const resolvedTarget = resolve(target);\n    const resolvedLinkPath = resolve(linkPath);\n\n    // If they resolve to the same physical path, skip\n    try {\n      const [realTrg, realLnk] = await Promise.all([\n        realpath(resolvedTarget),\n        realpath(resolvedLinkPath),\n      ]);\n      if (realTrg === realLnk) return true;\n    } catch {\n      // paths may not exist yet — continue\n    }\n\n    // Check parent symlinks\n    const realTgtWithParent = await resolveParentSymlinks(target);\n    const realLnkWithParent = await resolveParentSymlinks(linkPath);\n    if (realTgtWithParent === realLnkWithParent) return true;\n\n    // Remove existing link/dir at target\n    try {\n      const stats = await lstat(linkPath);\n      if (stats.isSymbolicLink()) {\n        const existing = await readlink(linkPath);\n        if (resolve(dirname(linkPath), existing) === resolvedTarget) return true;\n        await rm(linkPath);\n      } else {\n        await rm(linkPath, { recursive: true });\n      }\n    } catch {\n      // Doesn't exist — fine\n    }\n\n    const linkDir = dirname(linkPath);\n    await mkdir(linkDir, { recursive: true });\n\n    const realLinkDir = await resolveParentSymlinks(linkDir);\n    const relPath = relative(realLinkDir, target);\n\n    await symlink(relPath, linkPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Recursively copy a directory, skipping .git and node_modules.\n */\nasync function copyDir(src: string, dest: string): Promise<void> {\n  await mkdir(dest, { recursive: true });\n\n  // Use cp with recursive\n  await cp(src, dest, {\n    recursive: true,\n    dereference: true,\n    filter: (srcPath) => {\n      const name = basename(srcPath);\n      return name !== '.git' && name !== 'node_modules';\n    },\n  });\n}\n\n/**\n * Install a single skill for a single agent.\n */\nexport async function installSkill(\n  skill: SkillMeta,\n  agent: AgentConfig,\n  options: {\n    global?: boolean;\n    cwd?: string;\n    mode?: InstallMode;\n  } = {},\n): Promise<InstallResult> {\n  const isGlobal = options.global ?? false;\n  const cwd = options.cwd ?? process.cwd();\n  const mode = options.mode ?? 'symlink';\n\n  const skillName = skill.name;\n  const canonicalDir = join(getCanonicalDir(isGlobal, cwd), skillName);\n  const agentDir = join(getAgentSkillsDir(agent, isGlobal, cwd), skillName);\n\n  try {\n    if (mode === 'copy') {\n      // Copy directly to agent directory\n      await rm(agentDir, { recursive: true, force: true });\n      await copyDir(skill.dirPath, agentDir);\n      return { skill: skillName, agent: agent.id, success: true, path: agentDir, mode: 'copy' };\n    }\n\n    // Symlink mode: copy to canonical, then symlink from agent dir\n    await rm(canonicalDir, { recursive: true, force: true });\n    await copyDir(skill.dirPath, canonicalDir);\n\n    // For agents that share the universal .agents/skills dir, canonical is already correct\n    if (agent.projectSkillsDir === '.agents/skills' && !isGlobal) {\n      // Already installed at canonical location, nothing to symlink\n      return {\n        skill: skillName,\n        agent: agent.id,\n        success: true,\n        path: canonicalDir,\n        mode: 'symlink',\n      };\n    }\n\n    const ok = await createSymlink(canonicalDir, agentDir);\n    if (!ok) {\n      // Fallback to copy\n      await rm(agentDir, { recursive: true, force: true });\n      await copyDir(skill.dirPath, agentDir);\n    }\n\n    return {\n      skill: skillName,\n      agent: agent.id,\n      success: true,\n      path: ok ? agentDir : agentDir,\n      mode: 'symlink',\n    };\n  } catch (err) {\n    return {\n      skill: skillName,\n      agent: agent.id,\n      success: false,\n      path: agentDir,\n      mode,\n      error: err instanceof Error ? err.message : 'Unknown error',\n    };\n  }\n}\n\n/**\n * Install multiple skills for multiple agents.\n */\nexport async function installSkills(\n  skills: SkillMeta[],\n  agents: AgentConfig[],\n  options: {\n    global?: boolean;\n    cwd?: string;\n    mode?: InstallMode;\n  } = {},\n): Promise<InstallResult[]> {\n  const results: InstallResult[] = [];\n  for (const skill of skills) {\n    for (const agent of agents) {\n      results.push(await installSkill(skill, agent, options));\n    }\n  }\n  return results;\n}\n","import pc from 'picocolors';\nimport { AGENTS, getAgent } from './agents.js';\nimport { discoverSkills } from './skills.js';\nimport { installSkills } from './installer.js';\n\nfunction showHelp(): void {\n  console.log(`\n${pc.bold(pc.cyan('@katipwork/skills'))} — Curated agent skills installer\n\n${pc.bold('Usage:')}\n  npx @katipwork/skills               Interactive TUI (default)\n  npx @katipwork/skills --list        List available skills\n  npx @katipwork/skills --install <skills...> [options]\n\n${pc.bold('Options:')}\n  --help, -h          Show this help\n  --list, -l          List available skills and exit\n  --install, -i       Install specific skills (followed by skill names)\n  --agent, -a         Target agent(s): pi, claude-code, codex, github-copilot,\n                      hermes-agent, cursor, opencode (can repeat)\n  --all-agents        Install to all detected agents\n  --global, -g        Install globally (~/<agent>/skills/)\n  --copy              Copy files instead of symlinking\n  --yes, -y           Skip confirmation prompt\n\n${pc.bold('Examples:')}\n  npx @katipwork/skills\n  npx @katipwork/skills --list\n  npx @katipwork/skills -i code-review tdd -a pi -a claude-code -y\n  npx @katipwork/skills -i '*' --all-agents --global\n\n${pc.bold('Agents:')}\n  ${AGENTS.map((a) => `${a.id} (${a.displayName})`).join(', ')}\n\n${pc.dim('Source: https://github.com/katipwork/skills')}\n`);\n}\n\ninterface ParsedArgs {\n  help: boolean;\n  list: boolean;\n  install: string[];\n  agents: string[];\n  allAgents: boolean;\n  global: boolean;\n  copy: boolean;\n  yes: boolean;\n}\n\nfunction parseArgs(args: string[]): ParsedArgs {\n  const result: ParsedArgs = {\n    help: false,\n    list: false,\n    install: [],\n    agents: [],\n    allAgents: false,\n    global: false,\n    copy: false,\n    yes: false,\n  };\n\n  let i = 0;\n  while (i < args.length) {\n    const arg = args[i];\n    switch (arg) {\n      case '--help':\n      case '-h':\n        result.help = true;\n        break;\n      case '--list':\n      case '-l':\n        result.list = true;\n        break;\n      case '--install':\n      case '-i':\n        i++;\n        while (i < args.length && !args[i].startsWith('-')) {\n          result.install.push(args[i]);\n          i++;\n        }\n        i--; // compensate for loop increment\n        break;\n      case '--agent':\n      case '-a':\n        i++;\n        while (i < args.length && !args[i].startsWith('-')) {\n          result.agents.push(args[i]);\n          i++;\n        }\n        i--;\n        break;\n      case '--all-agents':\n        result.allAgents = true;\n        break;\n      case '--global':\n      case '-g':\n        result.global = true;\n        break;\n      case '--copy':\n        result.copy = true;\n        break;\n      case '--yes':\n      case '-y':\n        result.yes = true;\n        break;\n      default:\n        // Treat as skill name if not a flag\n        if (!arg.startsWith('-')) {\n          result.install.push(arg);\n        }\n    }\n    i++;\n  }\n\n  return result;\n}\n\nexport async function runCli(rawArgs: string[]): Promise<void> {\n  const args = parseArgs(rawArgs);\n\n  if (args.help) {\n    showHelp();\n    process.exit(0);\n  }\n\n  if (args.list) {\n    const skills = await discoverSkills();\n    if (skills.length === 0) {\n      console.log(pc.yellow('No skills found.'));\n    } else {\n      console.log(pc.bold(`Available skills (${skills.length}):\\n`));\n      for (const s of skills) {\n        console.log(`  ${pc.bold(pc.cyan(s.name))}`);\n        console.log(`    ${pc.dim(s.description)}`);\n        console.log(`    category: ${s.category}`);\n        console.log('');\n      }\n    }\n    process.exit(0);\n  }\n\n  // Install mode\n  if (args.install.length > 0) {\n    const allSkills = await discoverSkills();\n    let skillsToInstall = allSkills;\n\n    // Filter by requested names unless '*' is specified\n    if (!args.install.includes('*')) {\n      skillsToInstall = allSkills.filter((s) =>\n        args.install.some((name) => s.name === name),\n      );\n      const notFound = args.install.filter(\n        (name) => !allSkills.some((s) => s.name === name),\n      );\n      if (notFound.length > 0) {\n        console.log(pc.yellow(`Warning: skills not found: ${notFound.join(', ')}`));\n      }\n    }\n\n    if (skillsToInstall.length === 0) {\n      console.log(pc.red('No matching skills found to install.'));\n      process.exit(1);\n    }\n\n    // Resolve agents\n    let agentsToUse = args.agents\n      .map((id) => getAgent(id))\n      .filter((a): a is NonNullable<typeof a> => !!a);\n\n    if (args.allAgents) {\n      // Use all agents\n      agentsToUse = AGENTS;\n    }\n\n    if (agentsToUse.length === 0) {\n      console.log(pc.red('No agents specified. Use --agent <id> or --all-agents.'));\n      process.exit(1);\n    }\n\n    const mode = args.copy ? 'copy' : 'symlink';\n\n    console.log(pc.cyan('\\n─── Installing ───'));\n    console.log(`  Skills: ${pc.bold(skillsToInstall.map((s) => s.name).join(', '))}`);\n    console.log(`  Agents: ${pc.bold(agentsToUse.map((a) => a.displayName).join(', '))}`);\n    console.log(`  Scope:  ${pc.bold(args.global ? 'Global' : 'Project')}`);\n    console.log(`  Method: ${pc.bold(mode)}`);\n    console.log('');\n\n    const results = await installSkills(skillsToInstall, agentsToUse, {\n      global: args.global,\n      mode,\n    });\n\n    const succeeded = results.filter((r) => r.success);\n    const failed = results.filter((r) => !r.success);\n\n    if (succeeded.length > 0) {\n      console.log(pc.green(`✓ ${succeeded.length} installed successfully`));\n    }\n    if (failed.length > 0) {\n      console.log(pc.red(`✗ ${failed.length} failed`));\n      for (const r of failed) {\n        console.log(pc.red(`  ${r.skill} → ${r.agent}: ${r.error}`));\n      }\n      process.exit(1);\n    }\n    process.exit(0);\n  }\n\n  // No recognized mode — show help\n  showHelp();\n}\n","// Shebang is added by tsup banner at build time.\nimport { runTui } from './tui.js';\nimport { runCli } from './cli-args.js';\n\n// If CLI arguments are provided (beyond just the binary), run in non-interactive mode.\n// Otherwise, launch the TUI.\nconst args = process.argv.slice(2);\n\nif (args.length > 0) {\n  runCli(args).catch((err) => {\n    console.error('Error:', err.message);\n    process.exit(1);\n  });\n} else {\n  runTui().catch((err) => {\n    console.error('Unexpected error:', err);\n    process.exit(1);\n  });\n}\n"],"mappings":"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","names":["import_node_fs","import_node_path","import_promises","import_node_path","import_node_os","home","pc","import_picocolors","pc","args"]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@katipwork/skills",
+  "version": "0.1.0",
+  "description": "Curated agent skills with an interactive TUI installer",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/katipwork/skills.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "@katipwork/skills": "./dist/cli.cjs",
+    "skills": "./dist/cli.cjs"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.cjs"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.6.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  },
+  "packageManager": "npm@10.9.4"
+}

package/skills/engineering/code-review/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: code-review
+description: Review changes since a fixed point (commit, branch, or tag) along two axes — Standards (does the code follow this repo's conventions?) and Spec (does it match the originating issue/PRD?). Use when reviewing a branch, PR, or work-in-progress changes.
+---
+
+Review changes between `HEAD` and a fixed point the user supplies.
+
+## Process
+
+1. **Pin the fixed point** — ask the user for a commit SHA, branch, tag, or `main`. Resolve it and confirm the diff is non-empty.
+
+2. **Identify the spec** — look for issue references in commit messages (`#123`, `Closes #45`), PRD files under `docs/` or `specs/`, or ask the user.
+
+3. **Review on two axes in parallel:**
+   - **Standards** — does the diff follow documented coding conventions?
+   - **Spec** — does it implement what was asked?
+   
+   Run both as sub-agents so they don't pollute each other's context.
+
+4. **Report** — present findings under `## Standards` and `## Spec` headings. Keep axes separate — a change can pass one and fail the other.

package/skills/engineering/code-review/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Code Review"
+  short_description: "Review a diff on standards and spec"

package/skills/engineering/diagnosing-bugs/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: diagnosing-bugs
+description: Systematic diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose," "debug this," or reports something broken, throwing, failing, or slow.
+---
+
+## Diagnosis Loop
+
+Follow this cycle until the root cause is identified:
+
+### 1. Reproduce
+- Confirm the bug is reproducible.
+- Find the minimal reproduction steps.
+- Note the exact observed vs expected behavior.
+
+### 2. Isolate
+- Bisect the codebase — when did this start?
+- Narrow the scope: which module, function, or line?
+- Use `git bisect` for regressions.
+
+### 3. Hypothesize
+- Propose a specific root-cause hypothesis.
+- Design a test or probe that would confirm or refute it.
+
+### 4. Test
+- Run the probe (log, breakpoint, test).
+- If confirmed → fix. If refuted → return to step 3.
+
+### Guidelines
+- **One hypothesis at a time.** Don't shotgun-debug.
+- **Read the error message** — it often contains the answer.
+- **Check recent changes first** — most bugs come from the last change.
+- **Don't guess and check** — each probe should be deliberate.

package/skills/engineering/diagnosing-bugs/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Diagnosing Bugs"
+  short_description: "Systematic diagnosis for bugs and performance issues"

package/skills/engineering/tdd/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: tdd
+description: Test-driven development loop. Write a failing test first, then implement the minimal code to make it pass, then refactor. Use when building features or fixing bugs test-first, or when the user mentions "red-green-refactor".
+---
+
+## Red-Green-Refactor Loop
+
+### 1. Red — Write a failing test
+- Write the smallest test that captures the desired behavior.
+- The test must fail before any implementation code exists.
+- Use the project's existing test framework and conventions.
+
+### 2. Green — Make it pass
+- Write the **minimum** code to make the test pass.
+- Don't over-engineer — no refactoring, no "future-proofing."
+- If the test still fails, diagnose and fix the implementation.
+
+### 3. Refactor
+- Clean up both test and production code.
+- Remove duplication, improve names, extract helpers.
+- Run tests to confirm nothing broke.
+
+### Guidelines
+- **Test behavior, not implementation.** Avoid coupling tests to internal details.
+- **One assertion per test** where practical.
+- **Tests are documentation** — name them clearly.
+- **Fast feedback** — keep tests quick; mock external dependencies.

package/skills/engineering/tdd/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "TDD"
+  short_description: "Test-driven development with red-green-refactor loop"

package/skills/productivity/grilling/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: grilling
+description: Grill the user relentlessly about a plan, decision, or idea to stress-test their thinking. Use when the user wants to pressure-test an idea, or mentions "grill me," "stress test," or "poke holes in this."
+---
+
+## Grilling Session
+
+The goal is to find flaws, gaps, and unstated assumptions in the user's plan — not to be contrarian but to make the plan stronger.
+
+### Rules
+1. **Ask one question at a time.** Let the user answer before moving to the next.
+2. **Probe the edges.** What happens at scale? Under failure? With bad data?
+3. **Challenge assumptions.** "What makes you sure that...?"
+4. **Surface trade-offs.** "If you optimize for X, what happens to Y?"
+5. **Don't offer solutions yet.** The grilling phase is for finding problems.
+
+### Areas to probe
+- **Scope:** What's in and out? What's the MVP vs nice-to-have?
+- **Failure modes:** What breaks? What's the rollback plan?
+- **Dependencies:** What does this depend on? What depends on this?
+- **Alternatives:** What else did you consider? Why was this chosen?
+- **Success criteria:** How will you know it worked?
+
+### End condition
+Stop when the user says "that's enough" or when you've asked 5-8 questions without finding new gaps.

package/skills/productivity/grilling/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Grilling"
+  short_description: "Relentlessly question a plan to find gaps and assumptions"

package/skills/productivity/handoff/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: handoff
+description: Create a structured handoff document summarizing current work, decisions made, and next steps. Use when the user wants to hand off work to another developer or agent, or save context before switching tasks.
+---
+
+## Handoff Document
+
+Create a concise document that captures everything the next person (human or agent) needs to continue the work.
+
+### Structure
+
+1. **What we're building** — one sentence on the goal.
+2. **Current state** — what's done, what's in progress, what's blocked.
+3. **Key decisions** — what was chosen, why, and what alternatives were considered.
+4. **Files to look at** — the 3-5 most important files.
+5. **Next steps** — the immediate next action, clearly scoped.
+6. **Gotchas** — surprising constraints, workarounds, or known issues.
+
+### Guidelines
+- Write for someone with context about the project but not this specific task.
+- Be honest about what's messy or incomplete.
+- Don't bury the lede — put the most important info first.

package/skills/productivity/handoff/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Handoff"
+  short_description: "Create a structured handoff document for context transfer"

package/skills/productivity/prototype/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: prototype
+description: Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
+---
+
+## Throwaway Prototyping
+
+The prototype exists to answer **one question**. It should be built as fast as possible and thrown away after the question is answered.
+
+### 1. Define the question
+- What exactly are we trying to learn?
+- What would a "yes" or "no" answer look like?
+
+### 2. Build the minimum
+- Only the code needed to answer the question.
+- No error handling, no tests, no polish.
+- Fake anything that isn't the thing being tested.
+
+### 3. Run the experiment
+- Exercise the prototype with the specific scenario.
+- Record what happened.
+
+### 4. Decide
+- Question answered? → Report findings, throw away code.
+- Question not answered? → Refine the prototype or the question.
+
+### Red flags (abort)
+- "Let me just add one more feature..."
+- "This prototype is actually pretty good, maybe we should..."
+- More than 30 minutes spent on the prototype.
+
+**Reminder:** The prototype is garbage by design. The value is the learning, not the code.

package/skills/productivity/prototype/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Prototype"
+  short_description: "Build a throwaway prototype to answer one design question"