Post
JA EN

スキルを書かずにスキルを使う——公式メタスキルで実現するAI委譲の最大化

スキルを書かずにスキルを使う——公式メタスキルで実現するAI委譲の最大化
  • 想定読者: Claude Code、Cursor等のAIコーディングツールを使用する開発者
  • 前提知識: Claude Codeの基本的な使用経験
  • 所要時間: 12分

概要

Claude Codeのスキル機能を活用する方法として、「スキルを自分で書く」アプローチが一般的に紹介されている。しかし、スキル自体を自分で書く必要はない

Anthropicは公式リポジトリでskill-creatorというメタスキルを公開している。このスキルを使えば、「〇〇するスキルを作って」と依頼するだけで、ベストプラクティスに準拠したスキルが生成される。

本記事では、公式skill-creatorをベースに、プロジェクト固有のルールを追加して運用するワークフローを紹介する。

なぜ「スキルを書かない」のか

従来のアプローチの問題

スキル機能のチュートリアルでは、通常以下のような手順が示される:

  1. SKILL.mdの構造を学ぶ
  2. フロントマターの書き方を理解する
  3. Progressive Disclosureを意識して設計する
  4. 自分でSKILL.mdを書く

このアプローチには問題がある:

  • 学習コスト: スキルの設計原則を理解する必要がある
  • 一貫性の欠如: 人間が書くと、スキルごとに品質がばらつく
  • メンテナンス負荷: 更新のたびに設計原則を思い出す必要がある

発想の転換:AIにスキルを書かせる

レビューの観点が変わった——人間チームとAI協業の本質的な違いで述べたように、AI協業では人間の役割が「実行者」から「意図の担保者」に変化している。

スキル作成も同様である。人間が「何をするスキルが欲しいか」を伝え、AIが「どう実装するか」を担当する。

flowchart TB
    subgraph Traditional["従来のアプローチ"]
        direction TB
        T1["スキルの設計原則を学ぶ"]
        T2["SKILL.mdを自分で書く"]
        T3["問題を発見"]
        T4["自分で修正"]
        T1 --> T2 --> T3 --> T4
        T4 -.-> T2
    end

    subgraph Meta["メタスキルアプローチ"]
        direction TB
        M1["公式skill-creatorを導入"]
        M2["『〇〇するスキルを作って』と依頼"]
        M3["AIがスキルを生成"]
        M4["レビューして承認"]
        M1 --> M2 --> M3 --> M4
        M4 -.->|"次のスキル"| M2
    end

公式skill-creatorとは

概要

Anthropicはanthropics/skillsリポジトリで、skill-creatorというメタスキルを公開している1

「skill-creatorは、ユーザーが新しいスキルを作成(または既存のスキルを更新)したいときに使用する」

このスキルには以下が含まれる:

  • スキルの構造とベストプラクティス
  • Progressive Disclosureの設計原則
  • フロントマターの書き方
  • バンドルリソース(scripts/、references/、assets/)の使い分け
  • init_skill.py(スキル初期化スクリプト)
  • package_skill.py(スキルパッケージングスクリプト)

スキル機能自体は、Claude Codeのベストプラクティス2において「ドメイン固有の知識をClaudeに提供する仕組み」として位置づけられている。skill-creatorは、このスキル作成プロセスをAIに委譲するためのメタスキルである。

skill-creatorの設計原則

公式skill-creatorには、以下の重要な原則が含まれている1

1. 簡潔さが最優先

「Claudeはすでに高度であるため、Claudeがまだ持っていない文脈だけを追加する。各情報のトークンコストを正当化できるか検討する」(筆者による日本語訳)

2. 適切な自由度の設定

自由度用途
テキストベース指示複数アプローチが有効な場合
疑似コード/スクリプトパターンが存在し、変動可能
具体的スクリプト操作が脆弱で確実性が必要

3. 段階的情報開示(Progressive Disclosure)

レベル読み込みタイミングサイズ目安
メタデータ常に~100トークン
SKILL.md本体スキル発動時<5,000トークン
バンドルリソース必要に応じて無制限

ワークフロー:公式skill-creatorをベースに運用

ステップ1: 公式skill-creatorの導入

まず、公式リポジトリからskill-creatorを取得する。

1
2
3
4
5
# リポジトリをクローン
git clone https://github.com/anthropics/skills.git

# skill-creatorをプロジェクトにコピー
cp -r skills/skills/skill-creator .claude/skills/

または、Claude Codeに直接依頼する:

1
2
https://github.com/anthropics/skills/tree/main/skills/skill-creator
の内容を読み込んで、.claude/skills/skill-creator/ に配置してください。

ステップ2: プロジェクト固有のスキル設計ルールを追加(任意)

公式skill-creatorはそのままでも使えるが、スキル自体の設計に関するプロジェクト固有ルールがあれば追加できる。

1
2
3
4
5
skill-creatorに以下のルールを追加してください。

- スキル作成・更新時は公式ドキュメントを参照してレビューする
  - https://github.com/anthropics/skills
  - https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices

ステップ3: skill-creatorを使って他のスキルを作成

skill-creatorが導入できたら、以下のように他のスキルを作成できる。

1
2
3
4
5
6
7
記事を執筆するためのスキルを作成してください。

要件:
- エビデンスベースの主張
- 参考資料の明記(信頼性レベル付き)
- 類似記事の検索を最初に実行
- Mermaid図はTB方向を使用

skill-creatorには init_skill.py スクリプトが含まれており、スキル名はケバブケース(例:article-writer)で命名される。保存先を明示的に指定する必要はなく、AIがスキルの目的から適切な名前を判断し、.claude/skills/ に配置する。

AIはskill-creatorの知識を使って、ベストプラクティスに準拠したスキルを生成する。

ステップ4: 生成されたスキルをレビュー

AIが生成したスキルをレビューする。確認ポイント:

  • 意図した機能が実装されているか
  • 不要な複雑さが追加されていないか
  • Progressive Disclosureが適用されているか

問題があれば修正を依頼し、問題なければ承認する。

ステップ5: 運用とメンテナンス

スキルを使った作業中に問題を発見したら、その場でスキルの更新を依頼する。

1
引用番号が飛び飛びになっている。連番になるようにスキルを更新して。

作業の文脈があるため、どのスキルを更新すべきか、どのようなルールを追加すべきかはAIが判断できる。後から別のセッションで修正する場合は、問題の詳細を説明する必要があるが、その場であれば最小限の指示で済む。

Claude Code 2.1.0以降、スキルの自動ホットリロードがサポートされている3。更新されたスキルはセッションを再起動せずに即座に反映されるため、この「発見→更新→継続」のサイクルがシームレスに回る。

先進的なユーザーの実践

Superpowersの事例

Jesse Vincent氏は「Superpowers」というワークフローで、同様のアプローチを実践している4

「最初に教えたスキルの一つが『スキルの作り方』だった。これにより、git worktreeワークフローのような機能を追加したいときは、どう動くべきか説明するだけで、Claudeが組み立てて既存のスキルにメモを追加してくれる」

自己改善ループ

skill-creatorも単なるスキルの一つである。他のスキルと同様に、使いながら問題を発見し、更新していく。

flowchart TB
    subgraph Loop["自己改善ループ"]
        direction TB
        L1["スキルを作成"]
        L2["スキルを使って作業"]
        L3["問題を発見"]
        L4["スキルを更新"]
        L1 --> L2 --> L3 --> L4
        L4 -.-> L2
    end

Vincent氏のSuperpowersでは、以下のような自己改善が行われている4

  1. 失敗からの学習: サブエージェントを使ってスキルを「圧力テスト」
  2. 段階的な指示改善: 失敗パターンを発見したら、スキルを更新

実践上の注意点

レビューは省略しない

AIにスキル作成を任せても、レビューは必須である。確認すべき点:

  • 意図した機能が実装されているか
  • 不要な複雑さが追加されていないか
  • 公式ベストプラクティスに準拠しているか

スキルの肥大化を防ぐ

skill-creatorには以下の制約が含まれている:

  • SKILL.md は 500行以下に保つ
  • 詳細は references/ に分離
  • 同じ情報を複数箇所に書かない

プロジェクト固有のルールを追加する際も、この制約を守る。

このブログでの実践

本ブログでは、以下のワークフローを採用している:

  1. 初期構築: 公式skill-creatorを導入し、プロジェクト固有ルールを追加
  2. 記事執筆スキル: skill-creatorを使ってarticle-writerスキルを作成
  3. 継続的改善: 記事執筆中に発見した問題をスキルに反映

例えば、article-writerスキルには以下のルールが蓄積されている:

  • 「Mermaid図はTB方向を使用」(モバイル対応の問題から追加)
  • 「引用番号の連番ルール」(参照の追跡可能性から追加)
  • 「ダークモード対応のスタイルルール」(視認性の問題から追加)

これらはすべて、作業中に発見された問題から、AIに更新を依頼して追加されたルールである。

まとめ

「スキルを書かずにスキルを使う」——このアプローチの本質は、AI委譲の徹底である。

  1. 公式skill-creatorを導入: Anthropicが公開しているメタスキルを活用
  2. プロジェクト固有ルールを追加: 必要に応じてカスタマイズ
  3. スキル作成をAIに委譲: 「何をするスキルが欲しいか」だけ伝える
  4. レビューで品質を担保: 生成されたスキルを確認・承認
  5. メンテナンスもAIに委譲: 問題を発見したら更新を依頼

このワークフローにより、人間は「意図の担保者」という役割に集中できる。スキルの設計原則を暗記する必要はない。公式skill-creatorに蓄積された知識が、すべてのスキル作成に一貫して適用される。

レビューの観点が変わったで述べた「学習の外部化」は、メタスキルによってさらに加速する。人間が学ぶべきは「何を作るか」であり、「どう作るか」はAIに任せればよい。

関連記事

このテーマに関連する他の記事もご覧ください:

参考資料

本文中の引用番号に対応する参考資料を番号順に記載しています。

その他参考資料(本文中で番号引用なし)


引用の正確性について: 本記事で引用した資料は、公式ドキュメントおよび公式リポジトリを中心に構成しています。Claude Codeのスキル機能は2025年10月以降に公開された比較的新しい機能であり、情報は執筆時点(2026年1月)のものです。最新の仕様については公式ドキュメントをご確認ください。

  1. skill-creator - Anthropic (2025). 【信頼性: 高】 ↩︎ ↩︎2

  2. Claude Code Best Practices - Anthropic (2025). スキル機能を含むClaude Code全般のベストプラクティス。【信頼性: 高】 ↩︎

  3. Claude Code Changelog - Anthropic (2025). Version 2.1.0で自動ホットリロード機能が追加。【信頼性: 高】 ↩︎

  4. Superpowers: How I’m using coding agents in October 2025 - Vincent, J. (2025). 【信頼性: 中〜高】 ↩︎ ↩︎2

This post is licensed under CC BY 4.0 by the author.