diff --git a/.claude/skills/address-pr-comments/SKILL.md b/.claude/skills/address-pr-comments/SKILL.md index ba4f2e370..fbec76c3b 100644 --- a/.claude/skills/address-pr-comments/SKILL.md +++ b/.claude/skills/address-pr-comments/SKILL.md @@ -1,6 +1,6 @@ --- name: address-pr-comments -description: Read PR review comments, evaluate validity, implement fixes, push changes, and reply/resolve threads +description: "Read PR review comments, evaluate validity against bash behaviour, implement fixes, push changes, and reply/resolve threads. Use when the user wants to address pull request feedback, respond to code review comments, fix PR issues, or resolve review threads." argument-hint: "[pr-number|pr-url]" --- diff --git a/.claude/skills/fix-local-tests/SKILL.md b/.claude/skills/fix-local-tests/SKILL.md index ddfc8453a..8b1cc54d8 100644 --- a/.claude/skills/fix-local-tests/SKILL.md +++ b/.claude/skills/fix-local-tests/SKILL.md @@ -1,6 +1,6 @@ --- name: fix-local-tests -description: Fix failing tests by prioritising shell implementation fixes to match bash behaviour +description: "Fix failing tests by diagnosing failures, comparing against bash behaviour, and prioritising shell implementation fixes over test changes. Use when tests fail locally, test output differs from bash, or the user reports broken tests, test failures, or shell compatibility issues." argument-hint: "[test filter or description of failure]" --- @@ -125,7 +125,7 @@ go test -race ./interp/... ./tests/... -v Ensure no regressions were introduced. If new failures appear, repeat from step 1 for those failures. -### 7. Run bash comparison tests +### 8. Run bash comparison tests If any YAML scenarios were touched or any builtin implementation was changed, run the bash comparison tests: diff --git a/.claude/skills/implement-posix-command/SKILL.md b/.claude/skills/implement-posix-command/SKILL.md index b21ce3d8e..c969a2739 100644 --- a/.claude/skills/implement-posix-command/SKILL.md +++ b/.claude/skills/implement-posix-command/SKILL.md @@ -1,6 +1,6 @@ --- name: implement-posix-command -description: Implement a new POSIX command as a builtin in the safe shell interpreter +description: "Implement a new POSIX command as a builtin in the safe shell interpreter. Researches the command spec, implements Go code with flag parsing and sandbox compliance, writes POSIX scenario tests and Go tests, and performs security review. Use when the user asks to add, implement, or create a new shell builtin command, or extend the shell with a new POSIX utility." argument-hint: "" --- diff --git a/.claude/skills/improve-loop/SKILL.md b/.claude/skills/improve-loop/SKILL.md index 1cda1480b..8d60360f6 100644 --- a/.claude/skills/improve-loop/SKILL.md +++ b/.claude/skills/improve-loop/SKILL.md @@ -1,6 +1,6 @@ --- name: improve-loop -description: "Systematically review and improve every shell feature and builtin command. Iterates through each feature/command, runs code-review, fixes issues, and re-reviews until clean." +description: "Systematically review and improve every shell feature and builtin command on a PR. Iterates through each feature/command, runs code-review, fixes issues, and re-reviews until clean. Use when the user wants to audit, review, or improve all shell builtins and features in bulk, or run a comprehensive quality pass on a PR." argument-hint: "[pr-number|pr-url]" --- diff --git a/.claude/skills/improve-test-coverage/SKILL.md b/.claude/skills/improve-test-coverage/SKILL.md index 1ec2d903f..2af0a095c 100644 --- a/.claude/skills/improve-test-coverage/SKILL.md +++ b/.claude/skills/improve-test-coverage/SKILL.md @@ -1,6 +1,6 @@ --- name: improve-test-coverage -description: Improve test coverage for shell features and commands using reference test suites from yash, GNU coreutils, and uutils/coreutils +description: "Improve test coverage for shell features and builtin commands by mining reference test suites (yash, GNU coreutils, uutils/coreutils) for gaps, porting test cases, and generating new scenario tests. Use when the user wants to add tests, find coverage gaps, improve test quality, or port POSIX compliance tests for shell builtins or commands." argument-hint: "[command-name|shell-feature|all]" ---