Skip to content

Commit 03f2cb4

Browse files
sjnimsclaude
andauthored
docs(command-development): clarify model field accepts full model strings (#57)
## Summary Clarifies that the `model` frontmatter field in slash commands accepts both shorthand values and full model IDs. ## Problem Fixes #49 The command-development skill documentation only showed shorthand model values (`sonnet`, `opus`, `haiku`), but official Claude docs show full model IDs are also valid. This caused potential confusion about accepted formats. ## Solution Updated documentation to explicitly show both formats: - Shorthand: `sonnet`, `opus`, `haiku` - Full model ID: `claude-sonnet-4-5-20250929`, `claude-haiku-4-5-20251001`, etc. Added clarification that shorthand names use the current default version of each model family. ### Alternatives Considered - Only update the reference file: Decided to update both SKILL.md and frontmatter-reference.md for consistency - Use older model IDs from the issue: Updated to use current 4.5 model IDs (as of December 2025) ## Changes - `skills/command-development/references/frontmatter-reference.md`: Updated model field values and validation fix text - `skills/command-development/SKILL.md`: Updated model field type and values ## Testing - [x] Linting passes (`markdownlint`) - [x] Documentation is accurate per official Claude docs --- 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 95999ca commit 03f2cb4

2 files changed

Lines changed: 13 additions & 3 deletions

File tree

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

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,8 @@ allowed-tools: Read, Write, Edit, Bash(git:*)
155155
### model
156156

157157
**Purpose:** Specify model for command execution
158-
**Type:** String (sonnet, opus, haiku)
158+
**Type:** String
159+
**Values:** Shorthand (`sonnet`, `opus`, `haiku`) or full model ID (e.g., `claude-sonnet-4-5-20250929`)
159160
**Default:** Inherits from conversation
160161

161162
```yaml
@@ -170,6 +171,8 @@ model: haiku
170171
- `sonnet` - Standard workflows
171172
- `opus` - Complex analysis
172173

174+
Shorthand names use the current default version of each model family.
175+
173176
### argument-hint
174177

175178
**Purpose:** Document expected arguments for autocomplete

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,14 @@ allowed-tools: "*"
132132
**Type:** String
133133
**Required:** No
134134
**Default:** Inherits from conversation
135-
**Values:** `sonnet`, `opus`, `haiku`
135+
**Values:**
136+
137+
- Shorthand: `sonnet`, `opus`, `haiku`
138+
- Full model ID: `claude-sonnet-4-5-20250929`, `claude-haiku-4-5-20251001`, etc.
139+
140+
Both formats are accepted. Shorthand names use the current default version of each model family.
141+
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).
136143

137144
**Purpose:** Specify which Claude model executes the command
138145

@@ -440,7 +447,7 @@ allowed-tools: Bash # ❌ Missing command filter
440447
model: gpt4 # ❌ Not a valid Claude model
441448
```
442449

443-
**Fix:** Use `sonnet`, `opus`, or `haiku`
450+
**Fix:** Use shorthand (`sonnet`, `opus`, `haiku`) or full model ID (e.g., `claude-sonnet-4-5-20250929`)
444451

445452
### Validation Checklist
446453

0 commit comments

Comments
 (0)