claude-agent-skills 1.3.7 → 1.3.8

package/lib/picker.js

@@ -38,12 +38,11 @@ export async function skillPicker({ message, options }) {
   const numCols = Math.max(1, Math.floor((termW - 2) / colW));
   const numRows = Math.ceil(options.length / numCols);
 
-  // Fixed layout heights
-  const HEADER   = 2;
-  const GRID_H   = numRows;
-  const SEP      = 1;
-  const DESC_H   = Math.max(5, Math.min(8, termH - HEADER - GRID_H - SEP - 3));
-  const FOOTER   = 1;
+  // Layout heights — DESC_H is computed dynamically per render from wrapped lines
+  const HEADER = 2;
+  const GRID_H = numRows;
+  const SEP    = 1;
+  const FOOTER = 1;
 
   let cursor = 0;
   const sel  = new Set();
@@ -84,16 +83,14 @@ export async function skillPicker({ message, options }) {
       lines.push(row);
     }
 
-    // Separator + description
-    lines.push(muted('├' + '─'.repeat(Math.min(termW - 2, 78)) + '┤'));
-
+    // Separator + full description — all lines, no cap
     const focused = options[cursor];
     const desc    = focused?.description ?? '';
-    // 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] ?? '';
+    const wrapped = desc ? wordWrap(desc, wrapW) : [''];
+
+    lines.push(muted('├' + '─'.repeat(Math.min(termW - 2, 78)) + '┤'));
+    for (const line of wrapped) {
       lines.push(muted('│ ') + white(line));
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-agent-skills",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "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.7",
+  "version": "1.3.8",
   "skills": [
     "ask-matt",
     "brainstorming",
@@ -108,25 +108,25 @@
   "descriptions": {
     "ask-matt": "You don't remember every skill, so ask.",
     "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…",
+    "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 context shrinks per delegation.",
     "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. 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-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.md`.",
     "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…",
+    "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 `decision: \"block\"` with the formatted stats as the reason. The user sees the numbers immediately.",
+    "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 or restructured. The aim is leverage for callers, locality for maintainers, and testability for everyone.",
     "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 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…",
+    "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 your session's context or history — you construct exactly what they need. This also preserves your own context for coordination work.",
+    "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 the moment they crystallise. (Merely *reading* `CONTEXT.md` for vocabulary is not this skill — that's a one-line habit any skill can do. This skill is for when you're changing the model, not just consuming it.)",
     "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 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 shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For eac…",
+    "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 each question, provide your recommended answer.",
     "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.",
@@ -141,7 +141,7 @@
     "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 reviewer gets precisely crafted context for evaluation — never your session's history. This keeps the reviewer focused on th…",
+    "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 the work product, not your thought process, and preserves your own context for continued work.",
     "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:",
@@ -157,8 +157,8 @@
     "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. **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-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 below serves it.",
+    "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, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.",
     "writing-skills": "**Writing skills IS Test-Driven Development applied to process documentation.**"
   }
 }