本記事は、Claude Codeの開発に携わるAnthropicのThariq Shihipar（@trq212）氏がXに投稿した内容をもとに作成しています。原文はこちらをご参照ください → https://x.com/trq212
そもそも「スキル」って何？
Claude Codeを使っていると、「スキル」という言葉が出てきます。でも、これが何なのかピンとこない方も多いと思います。
一言で言うと、スキルとは「Claude Codeに覚えさせたい知識・手順・ルールをまとめたフォルダ」です。
たとえば、あなたの会社には独自の業務フローがあったり、使い慣れたツールがあったりしますよね。そういった「社内の常識」をスキルとして作っておくと、Claude Codeが最初からその知識を持った状態で仕事を始めてくれます。
「ただのメモ帳ではない」という意味
よくある誤解が「スキル＝テキストファイル（メモ）」というものです。確かにスキルの中心はMarkdown形式（テキスト）の説明ファイルですが、スキルの正体はフォルダです。
テキストの説明に加えて、スクリプト（自動処理プログラム）、テンプレートファイル、参照資料、データなど、Claude Codeが仕事に使えるあらゆるものを格納できます。
料理本に例えると分かりやすいです。レシピカードが1枚あるだけでも料理はできますが、一流の料理本には「よくある失敗」「食材の代替案」「調理動画」まで揃っていますよね。スキルも同じで、情報が豊かなほど仕事の質が上がります。
Anthropicの社内では数百個のスキルが稼働している
Thariq氏によると、Anthropicの社内ではClaude Codeのスキルが数百個稼働しているそうです。そのスキルを分析した結果、内容は次の9つのカテゴリに分けられることが分かりました。
自分の組織で「何のスキルが必要か」を考えるときの参考になります。
1. ライブラリ・API参照型
自社独自のシステムや、Claude Codeが苦手なツールの使い方を教えるスキルです。「どう使うか」だけでなく「やってはいけないこと（落とし穴）」を含めておくのがポイントです。
- 社内の請求システムの仕様と注意事項
- 社内CLIツール（コマンドラインツール）の操作マニュアル
- 自社のデザインシステムに合わせたUI作成ルール
2. 動作確認・テスト型
作ったものが本当に正しく動いているかを確認するスキルです。Playwrightという自動テストツールなどと組み合わせて使います。
エンジニアが1週間かけて磨き込む価値があるほど、このカテゴリのスキルは費用対効果が高いとThariq氏は言います。
- 新規登録フローをブラウザ自動操作で一通りテストするスキル
- 決済画面をテスト用のカードで操作し、処理状態を確認するスキル
3. データ取得・分析型
社内のデータベースや分析ダッシュボードに接続して情報を取得するスキルです。認証情報や特定のダッシュボードIDなども含めておけます。
4. 業務プロセス自動化型
繰り返し発生する定型業務をワンコマンドで自動化するスキルです。スタンドアップ（朝の進捗報告）の自動投稿や、チケット作成後の関係者への通知などに使われます。
5. コードひな形生成型
特定のフレームワーク（アプリ開発の骨組み）や繰り返し使うコードパターンを自動生成するスキルです。コードだけでは表現しにくい「命名規則」「設計方針」といった自然言語のルールも含められます。
6. コード品質・レビュー型
コードの品質基準を守り、レビューを支援するスキルです。別のAIエージェントが「第三者の目」でコードを批評し、修正を繰り返させる「adversarial review（批判的レビュー）」という技法も含みます。
7. CI/CD・デプロイ型
CI/CDとはコードのテスト・確認・本番環境への反映を自動化する仕組みのことです。このカテゴリのスキルは、その一連の作業を支援します。PRの監視から、テスト失敗時の再実行、本番リリースまでを自動化できます。
※ PR（プルリクエスト）＝コードの変更をチームに提案・確認してもらう作業
8. ランブック（障害対応手順）型
システム障害が起きたとき、Slackのアラートやエラーメッセージを入力として受け取り、調査手順を自動的に進めて報告書を生成するスキルです。いわば「AIが代わりに障害対応の初動を担当する」イメージです。
9. インフラ運用型
サーバーや環境の定期メンテナンスを安全に自動化するスキルです。誤操作を防ぐガードレール（安全装置）を付けた設計が求められます。
スキルを上手に作るコツ
カテゴリが分かったら、次は「どう書けばいいか」ですよね。Thariq氏が共有している実践的なコツをまとめます。
「当たり前のこと」は書かない
Claude Codeはコーディングについての知識をすでに大量に持っています。スキルに書くべきは「Claude Codeが知らないこと」「普通のやり方ではなく、あなたの組織独自のルール」に絞りましょう。
Anthropicの社内でも、フロントエンドデザインのスキルは「Interフォントと紫グラデーションを避ける」という、Claude特有の癖を補正するために作られたそうです。
「落とし穴セクション」を最初に作る
スキルの中で最も価値があるのは「よくある失敗事例（Gotchas）」を集めたセクションです。実際に使い始めてClaudeが失敗したポイントを、その都度ここに追記していくのが正しい育て方です。
最初は2〜3行しかなくても問題ありません。使いながら育てていくのがスキルの本来の姿です。
スキルをフォルダとして設計する
my-skill/
├── SKILL.md # 全体の説明
├── references/
│ └── api.md # 詳細なAPI仕様（必要時だけ参照）
├── assets/
│ └── template.md # 出力テンプレート
└── scripts/
└── fetch_data.py # データ取得スクリプト
こうしてフォルダ構造を設計しておくと、Claude Codeは必要な情報を必要なときだけ読み込みます。全情報を最初から渡す必要がなく、処理が効率的になります。
descriptionフィールドは「トリガー説明」として書く
スキルのdescription（説明）フィールドは、人間向けの概要ではありません。「どんな状況でこのスキルを使うか」をClaude Codeに伝えるための文章です。Claude Codeはセッション開始時に全スキルのdescriptionを読んで、どのスキルを使うか判断しています。
「セットアップ情報」の保存先を決めておく
スタンドアップ投稿スキルなら「どのSlackチャンネルに投稿するか」を最初に決める必要がありますよね。そういった設定情報はconfig.jsonファイルに保存するのが定番のパターンです。ファイルがなければClaude Codeがユーザーに質問し、答えをファイルに保存する流れにしておくと便利です。
チームでスキルを共有する2つの方法
小規模チームはリポジトリに入れる
Gitリポジトリ（チームでコードを管理する場所）の.claude/skills/フォルダにスキルを入れておけば、チーム全員が使えます。シンプルで導入コストが低い方法です。
ただし、スキルが増えるほどClaude Codeのコンテキスト（考える際の前提情報）も膨らむため、スキルの数が多くなってきたら次の方法への移行を検討します。
大規模チームは社内マーケットプレイスを作る
Claude Codeにはプラグインマーケットプレイスの仕組みがあり、スキルを中央リポジトリで管理して各メンバーが必要なものだけインストールできます。
社内での運用ルールとして、Thariq氏のチームはこんな流れを採用しています。
- 試作スキルをサンドボックスフォルダに置く
- Slackなどで「こんなスキル作ったので試してみて」と共有
- 十分な利用実績が出たらマーケットプレイスに正式登録
- 品質が低いスキルや重複したスキルは審査ではじく
「オンデマンドフック」という応用技
スキルには、そのスキルが呼ばれた間だけ有効になるフック（自動的に動く処理）を設定できます。
たとえば：
/carefulスキル：rm -rf（全ファイル削除）やDROP TABLE（データベースのテーブル削除）などの危険な操作を自動ブロック。本番環境の作業時だけ有効にする/freezeスキル：特定フォルダ以外へのファイル編集を禁止。デバッグ中に「ついでに直してしまう」のを防ぐ
こういった「特定の状況でだけ必要な安全装置」をスキルとして作っておくと、日常的な作業の邪魔をせずに使えます。
まとめ
スキルは、Claude Codeに「あなたの組織の知識」を覚えさせるための仕組みです。
最初から完璧に作ろうとしなくて大丈夫です。Thariq氏も「ほとんどのスキルは数行の指示と1つの落とし穴から始まった。Claude Codeが新しい失敗をするたびに、みんなが書き足していった」と言っています。
使いながら育てる、という感覚で取り組むのが正解です。
コメント