Skip to content

docs(command-development): clarify model field accepts full model strings #49

@sjnims

Description

@sjnims

Summary

The command-development skill documents the model frontmatter field with shorthand values, but the official docs show full model strings are also valid. This could be clarified.

Current Documentation

skills/command-development/SKILL.md:156-172:

model: haiku    # Fast, simple commands
model: sonnet   # Standard workflows
model: opus     # Complex analysis

skills/command-development/references/frontmatter-reference.md:96-97:

**Type:** String
**Values:** `sonnet`, `opus`, `haiku`

Official Documentation

The official docs example shows:

model: claude-3-5-haiku-20241022

And states: "Specific model string (see Models overview)"

Suggested Change

Update the frontmatter-reference.md to clarify both formats work:

**Type:** String
**Values:** 
- Shorthand: `sonnet`, `opus`, `haiku`
- Full model ID: `claude-3-5-haiku-20241022`, `claude-sonnet-4-20250514`, etc.

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

Files Affected

  • skills/command-development/references/frontmatter-reference.md
  • Optionally skills/command-development/SKILL.md (model section)

Priority

Low - current documentation works, this is just a clarification.

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions