From c8fb4ce3b195b8c3eda9ce160a5e47fc5ffa03ba Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Mon, 8 Dec 2025 17:52:04 -0500 Subject: [PATCH] docs(command-development): improve discoverability and future-proof model IDs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- plugins/plugin-dev/skills/command-development/SKILL.md | 2 +- .../command-development/references/frontmatter-reference.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/plugins/plugin-dev/skills/command-development/SKILL.md b/plugins/plugin-dev/skills/command-development/SKILL.md index 415511a..73a607e 100644 --- a/plugins/plugin-dev/skills/command-development/SKILL.md +++ b/plugins/plugin-dev/skills/command-development/SKILL.md @@ -1,6 +1,6 @@ --- name: command-development -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. +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. --- # Command Development for Claude Code 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 865198b..9b18491 100644 --- a/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md +++ b/plugins/plugin-dev/skills/command-development/references/frontmatter-reference.md @@ -135,11 +135,11 @@ allowed-tools: "*" **Values:** - Shorthand: `sonnet`, `opus`, `haiku` -- Full model ID: `claude-sonnet-4-5-20250929`, `claude-haiku-4-5-20251001`, etc. +- Full model ID: Format is `claude---` (e.g., `claude-sonnet-4-5-20250929`) 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). +> **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. **Purpose:** Specify which Claude model executes the command @@ -447,7 +447,7 @@ allowed-tools: Bash # ❌ Missing command filter model: gpt4 # ❌ Not a valid Claude model ``` -**Fix:** Use shorthand (`sonnet`, `opus`, `haiku`) or full model ID (e.g., `claude-sonnet-4-5-20250929`) +**Fix:** Use shorthand (`sonnet`, `opus`, `haiku`) or full model ID (see [Claude Models Overview](https://docs.anthropic.com/en/docs/about-claude/models)) ### Validation Checklist