agent-loadout 1.0.1 → 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

@@ -1729,8 +1729,13 @@ function buildTOC(tools) {
     group.push(tool);
     byPreset.set(tool.preset, group);
   }
-  const allTags = tools.flatMap((t) => t.tags?.slice(0, 2) ?? []);
-  const tagSummary = [...new Set(allTags)].slice(0, 8).join(", ");
+  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 ");
@@ -1741,12 +1746,14 @@ ${entries}`;
   }).join("\n\n");
   return [
     "---",
-    `description: "Installed CLI tools \u2014 ${tagSummary} and more. Read individual files for commands and agent tips."`,
+    `description: "${compactDescription}"`,
     "source: agent-loadout",
     "---",
     "",
     "# Agent Loadout",
     "",
+    "Each file has trusted commands, output formats, and agent-specific tips.",
+    "",
     sections,
     ""
   ].join("\n");
@@ -1774,7 +1781,7 @@ async function writeSkills(tools) {
 
 // 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.1");
+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.1",
+  "version": "1.0.2",
   "description": "One command to load out your terminal for agentic coding",
   "type": "module",
   "bin": {