Skip to content

docs(command-development): improve discoverability and future-proof model ID examples #60

@sjnims

Description

@sjnims

Summary

Two minor documentation improvements for the command-development skill:

  1. Missing "debug" trigger phrase - The skill description doesn't include "debug command" or "command debugging" despite testing-strategies.md covering debugging scenarios
  2. Model ID examples may become stale - Specific model IDs like claude-sonnet-4-5-20250929 are used in examples

Issue 1: Missing Trigger Phrase

Current Description

description: This skill should be used when the user asks to "create a slash command", "add a command", ... or command development best practices for Claude Code.

Suggested Addition

Add trigger phrases:

  • "debug command"
  • "command debugging"
  • "troubleshoot command"

This improves skill discoverability when users need help debugging their commands.

Issue 2: Model ID Examples

Location

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

Current

model: sonnet   # or full model ID like claude-sonnet-4-5-20250929

Suggested

The existing note is good:

Note: Model ID examples above reflect December 2025 releases. Anthropic releases new model versions periodically. For current model IDs, consult Claude Models Overview.

Consider:

  1. Using placeholder format: claude-<family>-<version>-<date>
  2. Or simply noting "see official docs for current IDs"

This prevents examples from appearing outdated as new models release.

Acceptance Criteria

  • Add "debug command", "command debugging", "troubleshoot command" to SKILL.md description
  • Review model ID examples in frontmatter-reference.md for future-proofing
  • Ensure link to official Claude models documentation is present and correct

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions