skill model updater
- Repo stars 206
- Author repo claude-ai-music-skills
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @bitwize-music-studio · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- External requests
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Expected Output Format
CURRENT CLAUDE MODELS (discovered)
==================================
Source: docs.anthropic.com/en/docs/about-claude/models
Date checked: [today's date]
Opus: claude-opus-4-5-20251101
Sonnet: claude-sonnet-4-5-20250929
Haiku: claude-haiku-4-5-20251001 Step 1: Discover Current Models
Before checking or updating skills, you MUST first discover current model IDs.
## Your Task
**Command**: $ARGUMENTS
Based on the command:
1. **check** - Discover current models, scan all skills, report status
2. **update** - Update outdated models to current versions
3. **update --dry-run** - Show what would be updated without making changes
---
# Skill Model Updater
You maintain model currency across all skill files, ensuring skills use the latest Claude models.
---
## Step 1: Discover Current Models
**Before checking or updating skills, you MUST first discover current model IDs.**
### Discovery Method
1. **Search for current Anthropic models:**
```
WebSearch: "Anthropic Claude model IDs 2025" OR "Claude API models list current"
```
2. **Fetch official documentation:**
```
WebFetch: https://docs.anthropic.com/en/docs/about-claude/models
```
3. **Extract current model IDs** for each tier:
- **Opus** (most capable) - Look for `claude-opus-*` or `claude-*-opus-*`
- **Sonnet** (balanced) - Look for `claude-sonnet-*` or `claude-*-sonnet-*`
- **Haiku** (fast) - Look for `claude-haiku-*` or `claude-*-haiku-*`
4. **Identify the latest version** of each tier by date suffix (e.g., `20250514` > `20250114`)
### Expected Output Format
After discovery, report:
```
CURRENT CLAUDE MODELS (discovered)
==================================
Source: docs.anthropic.com/en/docs/about-claude/models
Date checked: [today's date]
Opus: claude-opus-4-5-20251101
Sonnet: claude-sonnet-4-5-20250929
Haiku: claude-haiku-4-5-20251001
```
**Shorthand aliases** (always valid, resolve to current):
- `opus` → current opus model
- `sonnet` → current sonnet model
- `haiku` → current haiku model
---
## Workflow
### Check Mode
```bash
/skill-model-updater check
```
1. **Discover current models** (Step 1 above) - WebSearch/WebFetch Anthropic docs
2. Glob for all `skills/*/SKILL.md` files
3. Extract `model:` field from YAML frontmatter
4. Compare against discovered current models
5. **Check CLAUDE.md** - Scan `${CLAUDE_PLUGIN_ROOT}/CLAUDE.md` for `Co-Authored-By: Claude` lines and verify model name is current
6. Report status for each skill and CLAUDE.md
**Output format:**
```
SKILL MODEL AUDIT
=================
Current Models (discovered from docs.anthropic.com):
- Opus: claude-opus-4-5-20251101
- Sonnet: claude-sonnet-4-5-20250929
- Haiku: claude-haiku-4-5-20251001
Skill Status:
✓ lyric-writer: claude-opus-4-5-20251101 (current)
✓ researcher: claude-sonnet-4-5-20250929 (current)
⚠ album-art-director: claude-sonnet-4-20250114 (outdated → claude-sonnet-4-5-20250929)
✓ import-audio: claude-haiku-4-5-20251001 (current)
Summary: 19/20 skills current, 1 needs update
```
### Update Mode
```bash
/skill-model-updater update
```
1. **Discover current models** (Step 1 above)
2. Run check to identify outdated skills
3. For each outdated skill:
- Read the SKILL.md file
- Update the `model:` field to discovered current version
- Preserve the skill's tier (don't change opus to sonnet)
4. **Update CLAUDE.md** - If `Co-Authored-By` line in `${CLAUDE_PLUGIN_ROOT}/CLAUDE.md` references an outdated model name, update it to current
5. Report changes made
**Output format:**
```
SKILL MODEL UPDATE
==================
Models discovered from docs.anthropic.com:
- Opus: claude-opus-4-5-20251101
- Sonnet: claude-sonnet-4-5-20250929
- Haiku: claude-haiku-4-5-20251001
Updated 1 skill:
- album-art-director: claude-sonnet-4-20250114 → claude-sonnet-4-5-20250929
All skills now current.
```
### Dry Run Mode
```bash
/skill-model-updater update --dry-run
```
Same as update but only reports what would change without editing files.
---
## Model Detection Logic
### Identifying Outdated Models
A model is outdated if:
1. It's an older version of a current model family (e.g., `claude-sonnet-4-20250114` vs `claude-sonnet-4-5-20250929`)
2. It's a deprecated model (e.g., `claude-3-opus-20240229`)
### Tier Detection (Auto)
Detect tier from the skill's existing `model:` field - no hardcoded tier list needed:
- If model contains `opus` → update to current opus
- If model contains `sonnet` → update to current sonnet
- If model contains `haiku` → update to current haiku
- If model is shorthand (`opus`, `sonnet`, `haiku`) → leave as-is (always resolves to current)
This preserves deliberate tier assignments without maintaining a separate mapping.
---
## When New Models Release
This skill discovers models automatically and detects tiers from existing assignments.
When Anthropic releases new models:
1. **Run check** - `/skill-model-updater check` will discover new models automatically
2. **Review changes** - Verify discovered models are correct
3. **Run update** - `/skill-model-updater update` to propagate changes
**Note**: Tier assignments are documented in `${CLAUDE_PLUGIN_ROOT}/reference/model-strategy.md`. This skill preserves existing tiers - it only updates version numbers.
---
## Example: Full Update Cycle
```markdown
User: "New Claude models released, update skills"
1. Run check (discovers models automatically):
/skill-model-updater check
Output:
- Discovered from docs.anthropic.com: Opus 4.5, Sonnet 4, Haiku 3.5
- 3 skills using outdated sonnet (20250114 → 20250514)
- 1 skill using deprecated opus (claude-3-opus → claude-opus-4-5)
2. Run dry-run:
/skill-model-updater update --dry-run
Output shows proposed changes
3. Run update:
/skill-model-updater update
Output confirms 4 skills updated
4. Verify:
/skill-model-updater check
Output: All 21 skills current
```
---
## Error Handling
### Missing Model Field
If a SKILL.md has no `model:` field:
- Report as "⚠ [skill]: No model specified"
- Do not add one automatically (requires manual decision)
### Unknown Model
If a SKILL.md has an unrecognized model:
- Report as "? [skill]: Unknown model '[model-id]'"
- Do not update (requires manual review)
### Invalid YAML
If a SKILL.md has malformed frontmatter:
- Report as "✗ [skill]: Invalid YAML frontmatter"
- Do not attempt to update
---
## Scope
This skill updates model references in:
1. **All `skills/*/SKILL.md` files** - The `model:` field in YAML frontmatter
2. **`CLAUDE.md`** - The `Co-Authored-By: Claude [Model] <noreply@anthropic.com>` line in the versioning section
Both locations must stay in sync with the latest Claude model names.
---
## Remember
- **Check before update** - Always know what will change
- **Tiers are auto-detected** - Skill reads existing model field to determine tier (opus/sonnet/haiku)
- **Shorthand is safe** - `opus`, `sonnet`, `haiku` always resolve to current versions
- **Tier rationale** - See `${CLAUDE_PLUGIN_ROOT}/reference/model-strategy.md` for why each skill uses its tier
- **CLAUDE.md co-author line** - Must reflect the current top-tier model name used for commits
Sections and files
Listed in source order.
sections -> Your Task → Step 1: Discover Current Models → Discovery Method → Expected Output Format → Workflow → Check Mode
terms -> Command · check · update · update --dry-run · Before checking or updating skills, you MUST first discover current model IDs. · Search for current Anthropic models · Fetch official documentation · Extract current model IDs
files/cmd -> claude-opus-* · claude-*-opus-* · claude-sonnet-* · claude-*-sonnet-* · claude-haiku-* · claude-*-haiku-* · 20250514 · 20250114
body sha256 -> 9396cdbb464d
Your Task
Command: $ARGUMENTS Based on the command: check - Discover current models, scan all skills, report status update - Update outdated models to current versions update --dry-run - Show what would be updated without making changes
Step 1: Discover Current Models
Before checking or updating skills, you MUST first discover current model IDs.
Discovery Method
Search for current Anthropic models: Fetch official documentation: Extract current model IDs for each tier: Opus (most capable) - Look for
claude-opus-*orclaude-*-opus-*Sonnet (balanced) - Look forclaude-sonnet-*orclaude-*-sonnet-*Expected Output Format
After discovery, report: Shorthand aliases (always valid, resolve to current):
opus→ current opus modelsonnet→ current sonnet modelhaiku→ current haiku modelCheck Mode
Discover current models (Step 1 above) - WebSearch/WebFetch Anthropic docs Glob for all
skills/*/SKILL.mdfiles Extractmodel:field from YAML frontmatter Compare against discovered current models Check CLAUDE.md - Scan${CLAUDE_PLUGIN_ROOT}/CLAUDE.mdforCo-Authored-By: Claudelines and verify model name is current