From cd09535ec78e7d7a8ce9743669dfea5f0ab791f6 Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Mon, 8 Dec 2025 16:51:24 -0500 Subject: [PATCH 1/2] docs(command-development): clarify model field accepts full model strings MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update documentation to clarify that the model frontmatter field accepts both shorthand values (sonnet, opus, haiku) and full model IDs (e.g., claude-sonnet-4-5-20250929, claude-haiku-4-5-20251001). Shorthand names use the current default version of each model family. Fixes #49 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- plugins/plugin-dev/skills/command-development/SKILL.md | 5 ++++- .../references/frontmatter-reference.md | 9 +++++++-- 2 files changed, 11 insertions(+), 3 deletions(-) diff --git a/plugins/plugin-dev/skills/command-development/SKILL.md b/plugins/plugin-dev/skills/command-development/SKILL.md index 127c66d..c418b0a 100644 --- a/plugins/plugin-dev/skills/command-development/SKILL.md +++ b/plugins/plugin-dev/skills/command-development/SKILL.md @@ -155,7 +155,8 @@ allowed-tools: Read, Write, Edit, Bash(git:*) ### model **Purpose:** Specify model for command execution -**Type:** String (sonnet, opus, haiku) +**Type:** String +**Values:** Shorthand (`sonnet`, `opus`, `haiku`) or full model ID (e.g., `claude-sonnet-4-5-20250929`) **Default:** Inherits from conversation ```yaml @@ -170,6 +171,8 @@ model: haiku - `sonnet` - Standard workflows - `opus` - Complex analysis +Shorthand names use the current default version of each model family. + ### argument-hint **Purpose:** Document expected arguments for autocomplete diff --git a/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md b/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md index 82e9688..ca0b4b5 100644 --- a/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md +++ b/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md @@ -132,7 +132,12 @@ allowed-tools: "*" **Type:** String **Required:** No **Default:** Inherits from conversation -**Values:** `sonnet`, `opus`, `haiku` +**Values:** + +- Shorthand: `sonnet`, `opus`, `haiku` +- Full model ID: `claude-sonnet-4-5-20250929`, `claude-haiku-4-5-20251001`, etc. + +Both formats are accepted. Shorthand names use the current default version of each model family. **Purpose:** Specify which Claude model executes the command @@ -440,7 +445,7 @@ allowed-tools: Bash # ❌ Missing command filter model: gpt4 # ❌ Not a valid Claude model ``` -**Fix:** Use `sonnet`, `opus`, or `haiku` +**Fix:** Use shorthand (`sonnet`, `opus`, `haiku`) or full model ID (e.g., `claude-sonnet-4-5-20250929`) ### Validation Checklist From 2bef17b665b143711cc0242ea3dea14a4fcb5aeb Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Mon, 8 Dec 2025 16:58:51 -0500 Subject: [PATCH 2/2] docs(command-development): add note about model ID currency and official docs URL MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add blockquote note directing readers to official Claude docs for current model IDs, since model names evolve with new releases. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../command-development/references/frontmatter-reference.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md b/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md index ca0b4b5..865198b 100644 --- a/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md +++ b/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md @@ -139,6 +139,8 @@ allowed-tools: "*" Both formats are accepted. Shorthand names use the current default version of each model family. +> **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). + **Purpose:** Specify which Claude model executes the command **Examples:**