skill-model-updater について
skill-model-updaterは、スキルファイルとCLAUDE.md内のClaudeモデル参照を管理するエージェントスキルです。最新のモデルIDを調べ、割り当てられたティアを確認し、古い参照の更新や変更のプレビューを行います。
主な機能
- 01最新ClaudeモデルIDの調査
- 02スキルファイルとCLAUDE.mdのモデル確認
- 03ティアを保ったバージョン更新
- 04変更内容のドライラン
活用シーン
- 01スキル内のClaudeモデル参照の確認
- 02Anthropicのモデル公開後のID更新
- 03編集前のモデル変更プレビュー
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ bitwize-music-studio/ claude-ai-music-skills --skill skill-model-updaterインストール後、Claude Code で/skill-model-updaterを入力して読み込まれたか確認します。
詳細
タスク
コマンド:$ARGUMENTS
コマンドに基づいて、次の処理を行います。
- check - 現在のモデルを確認し、すべてのスキルをスキャンして、状況を報告します
- update - 古いモデルを現在のバージョンに更新します
- update --dry-run - 変更を加えずに、更新される内容を表示します
スキルモデルアップデーター
すべてのスキルファイルでモデルを最新の状態に保ち、スキルが最新の Claude モデルを使用するようにします。
ステップ 1:現在のモデルを確認する
スキルを確認または更新する前に、必ず最初に現在のモデル ID を確認してください。
確認方法
-
現在の Anthropic モデルを検索します。
WebSearch: "Anthropic Claude model IDs 2025" OR "Claude API models list current" -
公式ドキュメントを取得します。
WebFetch: https://docs.anthropic.com/en/docs/about-claude/models -
各ティアの現在のモデル ID を抽出します。
- Opus(最も高性能) -
claude-opus-*またはclaude-*-opus-*を探します - Sonnet(バランス型) -
claude-sonnet-*またはclaude-*-sonnet-*を探します - Haiku(高速) -
claude-haiku-*またはclaude-*-haiku-*を探します
- Opus(最も高性能) -
-
日付サフィックス(例:
20250514>20250114)に基づいて、各ティアの最新バージョンを特定します。
出力形式
確認後、次の形式で報告します。
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
短縮エイリアス(常に有効で、現在のモデルに解決されます):
opus→ 現在の Opus モデルsonnet→ 現在の Sonnet モデルhaiku→ 現在の Haiku モデル
ワークフロー
チェックモード
/skill-model-updater check
- 現在のモデルを確認します(上記のステップ 1) - WebSearch/WebFetch Anthropic のドキュメント
- すべての
skills/*/SKILL.mdファイルを Glob で検索します - YAML フロントマターから
model:フィールドを抽出します - 確認した現在のモデルと照合します
- CLAUDE.md を確認します -
${CLAUDE_PLUGIN_ROOT}/CLAUDE.mdをスキャンし、Co-Authored-By: Claudeの行にあるモデル名が最新か確認します - 各スキルと CLAUDE.md の状況を報告します
出力形式:
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
更新モード
/skill-model-updater update
- 現在のモデルを確認します(上記のステップ 1)
- チェックを実行して、古いスキルを特定します
- 古いスキルごとに、次の処理を行います。
- SKILL.md ファイルを読み込みます
model:フィールドを、確認した最新バージョンに更新します- スキルのティアを維持します(opus を sonnet に変更しないでください)
- CLAUDE.md を更新します -
${CLAUDE_PLUGIN_ROOT}/CLAUDE.mdのCo-Authored-By行が古いモデル名を参照している場合、最新のモデル名に更新します - 実施した変更を報告します
出力形式:
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.
ドライランモード
/skill-model-updater update --dry-run
更新モードと同じ処理を行いますが、ファイルは編集せず、変更内容のみを報告します。
モデルの検出ロジック
古いモデルの特定
モデルが次のいずれかに該当する場合、古いモデルです。
- 現行のモデルファミリーの旧バージョンである(例:
claude-sonnet-4-20250114とclaude-sonnet-4-5-20250929) - 非推奨モデルである(例:
claude-3-opus-20240229)
ティアの自動判定
スキルに既存の model: フィールドがあれば、そこからティアを判定します。ハードコードされたティア一覧は必要ありません。
- モデル名に
opusが含まれる場合 → 現在の Opus に更新します - モデル名に
sonnetが含まれる場合 → 現在の Sonnet に更新します - モデル名に
haikuが含まれる場合 → 現在の Haiku に更新します - モデル名が短縮形(
opus、sonnet、haiku)の場合 → 常に最新モデルに解決されるため、そのままにします
これにより、別途対応表を管理することなく、意図されたティアの割り当てを維持できます。
新しいモデルのリリース時
このスキルはモデルを自動的に検出し、既存の割り当てからティアを判定します。
Anthropic が新しいモデルをリリースした場合:
- チェックを実行します -
/skill-model-updater checkで、新しいモデルを自動的に検出します - 変更内容を確認します - 検出されたモデルが正しいことを確認します
- 更新を実行します -
/skill-model-updater updateで変更を反映します
注:ティアの割り当てについては ${CLAUDE_PLUGIN_ROOT}/reference/model-strategy.md に記載されています。このスキルは既存のティアを維持し、バージョン番号のみを更新します。
例:更新サイクル全体
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
エラー処理
モデルフィールドがない場合
SKILL.md に model: フィールドがない場合:
- 「⚠ [skill]: モデルが指定されていません」と報告します
- 手動での判断が必要なため、自動では追加しません
不明なモデル
SKILL.md に認識できないモデルがある場合:
- 「? [skill]: 不明なモデル '[model-id]'」と報告します
- 手動での確認が必要なため、更新しません
無効な YAML
SKILL.md のフロントマターが不正な形式の場合:
- 「✗ [skill]: Invalid YAML frontmatter」として報告してください
- 更新を試みないでください
スコープ
このスキルは次の箇所のモデル参照を更新します:
- すべての
skills/*/SKILL.mdファイル - YAML フロントマターのmodel:フィールド CLAUDE.md- バージョニングセクションのCo-Authored-By: Claude [Model] <[email protected]>行
どちらの場所も、最新の Claude モデル名と同期している必要があります。
覚えておくこと
- 更新前に確認 - 何が変更されるかを常に把握してください
- ティアは自動検出 - スキルは既存のモデルフィールドを読み取り、ティア (opus/sonnet/haiku) を判定します
- 省略形は安全 -
opus、sonnet、haikuは常に現在のバージョンに解決されます - ティアの根拠 - 各スキルがそのティアを使用する理由については
${CLAUDE_PLUGIN_ROOT}/reference/model-strategy.mdを参照してください - CLAUDE.md の共同作成者行 - コミットに使用される現在の最上位ティアのモデル名を反映している必要があります