Skip to content

Commit c8fb4ce

Browse files
sjnimsclaude
andcommitted
docs(command-development): improve discoverability and future-proof model IDs
Add debug-related trigger phrases to SKILL.md description for better skill discovery when users need help troubleshooting commands. Update model ID examples in frontmatter-reference.md to use generic placeholder format and emphasize shorthand preference, reducing maintenance burden as new models release. Fixes #60 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 99f8e67 commit c8fb4ce

2 files changed

Lines changed: 4 additions & 4 deletions

File tree

plugins/plugin-dev/skills/command-development/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: command-development
3-
description: This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", "SlashCommand tool", "programmatic command invocation", "disable-model-invocation", "prevent Claude from running command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, programmatic invocation control, or command development best practices for Claude Code.
3+
description: This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", "SlashCommand tool", "programmatic command invocation", "disable-model-invocation", "prevent Claude from running command", "debug command", "command debugging", "troubleshoot command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, programmatic invocation control, debugging commands, or command development best practices for Claude Code.
44
---
55

66
# Command Development for Claude Code

plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -135,11 +135,11 @@ allowed-tools: "*"
135135
**Values:**
136136

137137
- Shorthand: `sonnet`, `opus`, `haiku`
138-
- Full model ID: `claude-sonnet-4-5-20250929`, `claude-haiku-4-5-20251001`, etc.
138+
- Full model ID: Format is `claude-<family>-<version>-<date>` (e.g., `claude-sonnet-4-5-20250929`)
139139

140140
Both formats are accepted. Shorthand names use the current default version of each model family.
141141

142-
> **Note:** Model ID examples above reflect December 2025 releases. Anthropic releases new model versions periodically. For current model IDs, consult [Claude Models Overview](https://docs.anthropic.com/en/docs/about-claude/models).
142+
> **Note:** Anthropic releases new model versions periodically. For current model IDs, consult [Claude Models Overview](https://docs.anthropic.com/en/docs/about-claude/models). Prefer shorthand names unless you need a specific version.
143143

144144
**Purpose:** Specify which Claude model executes the command
145145

@@ -447,7 +447,7 @@ allowed-tools: Bash # ❌ Missing command filter
447447
model: gpt4 # ❌ Not a valid Claude model
448448
```
449449

450-
**Fix:** Use shorthand (`sonnet`, `opus`, `haiku`) or full model ID (e.g., `claude-sonnet-4-5-20250929`)
450+
**Fix:** Use shorthand (`sonnet`, `opus`, `haiku`) or full model ID (see [Claude Models Overview](https://docs.anthropic.com/en/docs/about-claude/models))
451451

452452
### Validation Checklist
453453

0 commit comments

Comments
 (0)