claude-agent-skills 1.3.6 → 1.3.7

package/lib/picker.js

@@ -42,9 +42,8 @@ export async function skillPicker({ message, options }) {
   const HEADER   = 2;
   const GRID_H   = numRows;
   const SEP      = 1;
-  const DESC_H   = Math.max(4, Math.min(8, termH - HEADER - GRID_H - SEP - 3));
+  const DESC_H   = Math.max(5, Math.min(8, termH - HEADER - GRID_H - SEP - 3));
   const FOOTER   = 1;
-  const TOTAL    = HEADER + GRID_H + SEP + DESC_H + FOOTER;
 
   let cursor = 0;
   const sel  = new Set();
@@ -90,7 +89,9 @@ export async function skillPicker({ message, options }) {
 
     const focused = options[cursor];
     const desc    = focused?.description ?? '';
-    const wrapped = desc ? wordWrap(desc, termW - 6) : [];
+    // Cap wrap at 72 chars so descriptions always break into multiple lines
+    const wrapW   = Math.min(termW - 6, 72);
+    const wrapped = desc ? wordWrap(desc, wrapW) : [];
     for (let i = 0; i < DESC_H; i++) {
       const line = wrapped[i] ?? '';
       lines.push(muted('│ ') + white(line));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-agent-skills",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "description": "Install and manage Pavi's Claude Code agent skills",
   "license": "MIT",
   "type": "module",

package/skills.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "name": "claude-agent-skills",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "skills": [
     "ask-matt",
     "brainstorming",
@@ -107,58 +107,58 @@
   },
   "descriptions": {
     "ask-matt": "You don't remember every skill, so ask.",
-    "brainstorming": "Help turn ideas into fully formed designs and specs through natural collaborativ",
-    "cavecrew": "Cavecrew = three subagent presets that emit caveman output. Same job as Anthropi",
+    "brainstorming": "Help turn ideas into fully formed designs and specs through natural collaborative dialogue.",
+    "cavecrew": "Cavecrew = three subagent presets that emit caveman output. Same job as Anthropic defaults (`Explore`, edit-style agents, reviewer); difference is the tool-result they return is compressed, so main c…",
     "caveman": "Respond terse like smart caveman. All technical substance stay. Only fluff die.",
-    "caveman-commit": "Write commit messages terse and exact. Conventional Commits format. No fluff. Wh",
-    "caveman-compress": "Compress natural language files (CLAUDE.md, todos, preferences) into caveman-spe",
-    "caveman-help": "Display this reference card when invoked. One-shot — do NOT change mode, write f",
-    "caveman-review": "Write code review comments terse and actionable. One line per finding. Location,",
-    "caveman-stats": "This skill is delivered by `hooks/caveman-stats.js` (read by `hooks/caveman-mode",
-    "codebase-design": "Design **deep modules**: a lot of behaviour behind a small interface, placed at ",
-    "council": "You are the orchestrator. Dispatch three Haiku subagents in parallel — each",
+    "caveman-commit": "Write commit messages terse and exact. Conventional Commits format. No fluff. Why over what.",
+    "caveman-compress": "Compress natural language files (CLAUDE.md, todos, preferences) into caveman-speak to reduce input tokens. Compressed version overwrites original. Human-readable backup saved as `<filename>.original.…",
+    "caveman-help": "Display this reference card when invoked. One-shot — do NOT change mode, write flag files, or persist anything. Output in caveman style.",
+    "caveman-review": "Write code review comments terse and actionable. One line per finding. Location, problem, fix. No throat-clearing.",
+    "caveman-stats": "This skill is delivered by `hooks/caveman-stats.js` (read by `hooks/caveman-mode-tracker.js` on `/caveman-stats`). The model does not need to do anything when this skill fires — the hook returns `dec…",
+    "codebase-design": "Design **deep modules**: a lot of behaviour behind a small interface, placed at a clean seam, testable through that interface. Use this language and these principles wherever code is being designed o…",
+    "council": "You are the orchestrator. Dispatch three Haiku subagents in parallel — each a council member giving an independent perspective — then synthesize their responses into a unified recommendation.",
     "diagnosing-bugs": "A discipline for hard bugs. Skip phases only when explicitly justified.",
-    "dispatching-parallel-agents": "You delegate tasks to specialized agents with isolated context. By precisely cra",
-    "domain-modeling": "Actively build and sharpen the project's domain model as you design. This is the",
-    "edit-article": "1. First, divide the article into sections based on its headings. Think about th",
+    "dispatching-parallel-agents": "You delegate tasks to specialized agents with isolated context. By precisely crafting their instructions and context, you ensure they stay focused and succeed at their task. They should never inherit…",
+    "domain-modeling": "Actively build and sharpen the project's domain model as you design. This is the *active* discipline — challenging terms, inventing edge-case scenarios, and writing the glossary and decisions down th…",
+    "edit-article": "1. First, divide the article into sections based on its headings. Think about the main points you want to make during those sections.",
     "executing-plans": "Load plan, review critically, execute all tasks, report when complete.",
-    "finishing-a-development-branch": "Guide completion of development work by presenting clear options and handling ch",
-    "git-guardrails-claude-code": "Sets up a PreToolUse hook that intercepts and blocks dangerous git commands befo",
+    "finishing-a-development-branch": "Guide completion of development work by presenting clear options and handling chosen workflow.",
+    "git-guardrails-claude-code": "Sets up a PreToolUse hook that intercepts and blocks dangerous git commands before Claude executes them.",
     "grill-me": "Run a `/grilling` session.",
     "grill-with-docs": "Run a `/grilling` session, using the `/domain-modeling` skill.",
-    "grilling": "Interview me relentlessly about every aspect of this plan until we reach a share",
-    "handoff": "Write a handoff document summarising the current conversation so a fresh agent c",
-    "i-am-dumb": "The user wants something explained in extreme detail. They are not",
+    "grilling": "Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For eac…",
+    "handoff": "Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace.",
+    "i-am-dumb": "The user wants something explained in extreme detail. They are not actually dumb — they just want the full picture without assumptions about what they already know.",
     "implement": "Implement the work described by the user in the PRD or issues.",
-    "improve-codebase-architecture": "Surface architectural friction and propose **deepening opportunities** — refacto",
-    "migrate-to-shoehorn": "`shoehorn` lets you pass partial data in tests while keeping TypeScript happy. I",
+    "improve-codebase-architecture": "Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.",
+    "migrate-to-shoehorn": "`shoehorn` lets you pass partial data in tests while keeping TypeScript happy. It replaces `as` assertions with type-safe alternatives.",
     "obsidian-vault": "`/mnt/d/Obsidian Vault/AI Research/`",
-    "ponytail": "You are a lazy senior developer. Lazy means efficient, not careless. You have",
-    "ponytail-audit": "Scan the entire repository for over-engineering. Produce a ranked list of",
-    "ponytail-debt": "Scan the codebase for `ponytail:` comments and report them as a debt ledger.",
-    "ponytail-gain": "Display this scoreboard when invoked. One-shot: do NOT change mode, write flag",
-    "ponytail-help": "Display this reference card when invoked. One-shot, do NOT change mode,",
-    "ponytail-review": "Review the diff or codebase for over-engineering only. Goal: make the code",
-    "prototype": "A prototype is **throwaway code that answers a question**. The question decides ",
+    "ponytail": "You are a lazy senior developer. Lazy means efficient, not careless. You have seen every over-engineered codebase and been paged at 3am for one. The best code is the code never written.",
+    "ponytail-audit": "Scan the entire repository for over-engineering. Produce a ranked list of findings by impact. Apply no changes — report only unless user explicitly requests fixes.",
+    "ponytail-debt": "Scan the codebase for `ponytail:` comments and report them as a debt ledger. Read-only by default — make no changes unless explicitly asked.",
+    "ponytail-gain": "Display this scoreboard when invoked. One-shot: do NOT change mode, write flag files, or persist anything.",
+    "ponytail-help": "Display this reference card when invoked. One-shot, do NOT change mode, write flag files, or persist anything.",
+    "ponytail-review": "Review the diff or codebase for over-engineering only. Goal: make the code shorter. Report findings as one line each. Apply no fixes unless explicitly asked.",
+    "prototype": "A prototype is **throwaway code that answers a question**. The question decides the shape.",
     "receiving-code-review": "Code review requires technical evaluation, not emotional performance.",
-    "requesting-code-review": "Dispatch a code reviewer subagent to catch issues before they cascade. The revie",
-    "resolving-merge-conflicts": "1. **See the current state** of the merge/rebase. Check git history, and the con",
-    "scaffold-exercises": "Create exercise directory structures that pass `pnpm ai-hero-cli internal lint`,",
+    "requesting-code-review": "Dispatch a code reviewer subagent to catch issues before they cascade. The reviewer gets precisely crafted context for evaluation — never your session's history. This keeps the reviewer focused on th…",
+    "resolving-merge-conflicts": "1. **See the current state** of the merge/rebase. Check git history, and the conflicting files.",
+    "scaffold-exercises": "Create exercise directory structures that pass `pnpm ai-hero-cli internal lint`, then commit with `git commit`.",
     "setup-matt-pocock-skills": "Scaffold the per-repo configuration that the engineering skills assume:",
-    "setup-pre-commit": "- **Husky** pre-commit hook",
-    "subagent-driven-development": "Execute plan by dispatching a fresh implementer subagent per task, a task review",
-    "systematic-debugging": "Random fixes waste time and create new bugs. Quick patches mask underlying issue",
-    "tdd": "**Core principle**: Tests should verify behavior through public interfaces, not ",
-    "teach": "The user has asked you to teach them something. This is a stateful request - the",
+    "setup-pre-commit": "- **Husky** pre-commit hook - **lint-staged** running Prettier on all staged files - **Prettier** config (if missing) - **typecheck** and **test** scripts in the pre-commit hook",
+    "subagent-driven-development": "Execute plan by dispatching a fresh implementer subagent per task, a task review (spec compliance + code quality) after each, and a broad whole-branch review at the end.",
+    "systematic-debugging": "Random fixes waste time and create new bugs. Quick patches mask underlying issues.",
+    "tdd": "**Core principle**: Tests should verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't.",
+    "teach": "The user has asked you to teach them something. This is a stateful request - they intend to learn the topic over multiple sessions.",
     "test-driven-development": "Write the test first. Watch it fail. Write minimal code to pass.",
-    "to-issues": "Break a plan into independently-grabbable issues using vertical slices (tracer b",
-    "to-prd": "This skill takes the current conversation context and codebase understanding and",
-    "triage": "Move issues on the project issue tracker through a small state machine of triage",
-    "using-git-worktrees": "Ensure work happens in an isolated workspace. Prefer your platform's native work",
-    "using-superpowers": "<SUBAGENT-STOP>",
+    "to-issues": "Break a plan into independently-grabbable issues using vertical slices (tracer bullets).",
+    "to-prd": "This skill takes the current conversation context and codebase understanding and produces a PRD. Do NOT interview the user — just synthesize what you already know.",
+    "triage": "Move issues on the project issue tracker through a small state machine of triage roles.",
+    "using-git-worktrees": "Ensure work happens in an isolated workspace. Prefer your platform's native worktree tools. Fall back to manual git worktrees only when no native tool is available.",
+    "using-superpowers": "<SUBAGENT-STOP> If you were dispatched as a subagent to execute a specific task, skip this skill. </SUBAGENT-STOP>",
     "verification-before-completion": "Claiming work is complete without verification is dishonesty, not efficiency.",
-    "writing-great-skills": "A skill exists to wrangle determinism out of a stochastic system. **Predictabili",
-    "writing-plans": "Write comprehensive implementation plans assuming the engineer has zero context ",
+    "writing-great-skills": "A skill exists to wrangle determinism out of a stochastic system. **Predictability** — the agent taking the same _process_ every run, not producing the same output — is the root virtue; every lever b…",
+    "writing-plans": "Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, cod…",
     "writing-skills": "**Writing skills IS Test-Driven Development applied to process documentation.**"
   }
 }