agent-loadout 1.0.0 → 1.0.2

package/README.md

@@ -132,6 +132,12 @@ npx agent-loadout list --json
 
 # Print a generated Brewfile (macOS only)
 npx agent-loadout list --brewfile
+
+# Write missing skill files for installed tools
+npx agent-loadout skills
+
+# Rewrite all skill files (e.g. after upgrading agent-loadout)
+npx agent-loadout skills --force
 ```
 
 ## Brewfile alternative (macOS)
@@ -144,12 +150,24 @@ brew bundle
 
 ## Skills
 
-When you install tools, `agent-loadout` writes skill files to multiple locations:
+When you install tools, `agent-loadout` writes skill files to:
 
-- `~/.claude/skills/` — for Claude Code
+- `~/.claude/skills/agent-loadout/` — auto-discovered by Claude Code
 - `~/.agent-loadout/skills/` — generic copy for other agents
 
-Each skill is a focused playbook — what the tool does, trusted commands, gotchas — so your AI agent knows how to use it effectively.
+Each skill is a focused playbook: what the tool does, trusted commands, output formats, and gotchas. A `SKILL.md` index is also written, with every installed tool and its primary use case packed into the frontmatter — so your agent sees the full inventory in its system prompt on every session without loading individual files.
+
+### Syncing skills
+
+Skills are written automatically after `install`. To write or refresh them independently:
+
+```sh
+# Write skills for any installed tools that don't have one yet
+npx agent-loadout skills
+
+# Rewrite skill files for all installed tools
+npx agent-loadout skills --force
+```
 
 ## Requirements
 

package/dist/index.js

@@ -83,7 +83,7 @@ import { mkdir } from "fs/promises";
 var BASE_DIR = join(homedir(), ".agent-loadout");
 var GENERIC_SKILLS = join(BASE_DIR, "skills");
 var SKILL_TARGETS = {
-  claude: join(homedir(), ".claude", "skills")
+  claude: join(homedir(), ".claude", "skills", "agent-loadout")
 };
 var paths = {
   base: BASE_DIR,
@@ -1636,7 +1636,6 @@ Agents verifying domain setups, debugging DNS issues, or checking propagation ge
 `.trim();
 
 // src/skills.ts
-var PREFIX = "agent-loadout";
 var SKILL_CONTENT = {
   rg: rg_default,
   fd: fd_default,
@@ -1690,7 +1689,7 @@ var SKILL_CONTENT = {
   doggo: doggo_default
 };
 function skillFilename(toolId) {
-  return `${PREFIX}-${toolId}.md`;
+  return `${toolId}.md`;
 }
 function buildFrontmatter(tool) {
   const lines = [
@@ -1723,6 +1722,42 @@ async function findToolsMissingSkills(toolIds, dir = paths.skillTargets.claude)
   );
   return results.filter((id) => id !== null);
 }
+function buildTOC(tools) {
+  const byPreset = /* @__PURE__ */ new Map();
+  for (const tool of tools) {
+    const group = byPreset.get(tool.preset) ?? [];
+    group.push(tool);
+    byPreset.set(tool.preset, group);
+  }
+  const compactDescription = PRESETS.filter((p) => byPreset.has(p.id)).map((preset) => {
+    const entries = (byPreset.get(preset.id) ?? []).map((t) => {
+      const use = (t.tags?.[0] ?? t.description).replace(/ /g, "-");
+      return `${t.id}(${use})`;
+    }).join(" ");
+    return `${preset.name}: ${entries}`;
+  }).join(" | ");
+  const sections = PRESETS.filter((p) => byPreset.has(p.id)).map((preset) => {
+    const entries = (byPreset.get(preset.id) ?? []).map((t) => {
+      const uses = (t.tags ?? []).slice(0, 4).join(" \xB7 ");
+      return `- **[${t.name}](./${skillFilename(t.id)})** \u2014 ${uses}`;
+    }).join("\n");
+    return `## ${preset.name}
+${entries}`;
+  }).join("\n\n");
+  return [
+    "---",
+    `description: "${compactDescription}"`,
+    "source: agent-loadout",
+    "---",
+    "",
+    "# Agent Loadout",
+    "",
+    "Each file has trusted commands, output formats, and agent-specific tips.",
+    "",
+    sections,
+    ""
+  ].join("\n");
+}
 async function writeSkills(tools) {
   await ensureSkillDirs();
   const allDirs = [...Object.values(paths.skillTargets), paths.genericSkills];
@@ -1737,12 +1772,16 @@ async function writeSkills(tools) {
     }
     written++;
   }
+  const toc = buildTOC(tools.filter((t) => SKILL_CONTENT[t.id]));
+  for (const dir of allDirs) {
+    await writeFile3(join2(dir, "SKILL.md"), toc);
+  }
   return written;
 }
 
 // src/index.ts
 var program = new Command();
-program.name("agent-loadout").description("One command to load out your terminal for agentic coding").version("1.0.0");
+program.name("agent-loadout").description("One command to load out your terminal for agentic coding").version("1.0.2");
 process.on("SIGINT", () => {
   console.log(chalk10.dim("\n  Cancelled."));
   process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-loadout",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "One command to load out your terminal for agentic coding",
   "type": "module",
   "bin": {