Commit 118774c
docs(command-development): improve discoverability and future-proof model IDs (#64)
## Summary
- Add debug-related trigger phrases to skill description for better
discoverability
- Update model ID examples to use generic placeholder format
- Add guidance to prefer shorthand names unless specific version needed
## Problem
Fixes #60
The `command-development` skill was missing trigger phrases for
debugging scenarios despite `testing-strategies.md` covering them. Model
ID examples used specific version dates that would become stale as new
models release.
## Solution
Added "debug command", "command debugging", and "troubleshoot command"
trigger phrases to SKILL.md description, along with "debugging commands"
in the guidance topics.
Updated frontmatter-reference.md to:
- Use generic `claude-<family>-<version>-<date>` format with one
concrete example
- Simplify the note to emphasize shorthand preference
- Add link to official docs in the validation section fix
### Alternatives Considered
- Could have removed all specific model ID examples entirely, but
keeping one example helps users understand the format
- Could have updated to new docs.claude.com URL, but the redirect from
docs.anthropic.com works fine
## Changes
- `SKILL.md`: Added debug trigger phrases to description
- `frontmatter-reference.md`: Updated model ID format documentation in 2
locations
## Testing
- [x] markdownlint passes
- [x] Verified Claude models documentation link works (via redirect)
- [x] No syntax errors in YAML frontmatter
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>1 parent 99f8e67 commit 118774c
2 files changed
Lines changed: 4 additions & 4 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| |||
Lines changed: 3 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
135 | 135 | | |
136 | 136 | | |
137 | 137 | | |
138 | | - | |
| 138 | + | |
139 | 139 | | |
140 | 140 | | |
141 | 141 | | |
142 | | - | |
| 142 | + | |
143 | 143 | | |
144 | 144 | | |
145 | 145 | | |
| |||
447 | 447 | | |
448 | 448 | | |
449 | 449 | | |
450 | | - | |
| 450 | + | |
451 | 451 | | |
452 | 452 | | |
453 | 453 | | |
| |||
0 commit comments