テック技報最新号へ →
AIコーディング

スキルは9つの型で棚卸しし、Gotchas 節を育てる（Anthropic 社内の運用から）

Anthropic が社内で使っている数百のスキルを並べると9つの型にまとまる。足りない型を探す目録として使い、書くときは「Claude が知らないこと」「失敗例（Gotchas）」「フォルダ構成」「モデル向けの description」に集中する。

@kgsi · 2026-10-28
#claude-code#skills#hooks#チーム運用

9つの型（足りないものを探すチェックリスト）

  1. ライブラリ・API リファレンス: 社内ライブラリや CLI の正しい使い方と落とし穴（例: billing-lib、社内 CLI の全サブコマンド）
  2. プロダクト検証: Playwright や tmux と組み、動作を確かめる（例: サインアップ→メール確認→オンボーディングを headless で通し各段で状態を検査）。ここに1週間かける価値があるとしている
  3. データ取得・分析: 監視やデータ基盤へのつなぎ方、ダッシュボード ID、正しい結合キー
  4. 業務プロセス・チーム自動化: standup 投稿、チケット作成のスキーマ強制、週次まとめ
  5. 雛形生成: 新しいサービスやマイグレーションの雛形＋よくある落とし穴
  6. コード品質・レビュー: 別の目のサブエージェントに批評させ、指摘が細かい好みだけになるまで回す、など
  7. CI/CD・デプロイ: PR の見守り（flaky の再実行、競合解消、auto-merge）、段階的ロールアウトと自動ロールバック
  8. Runbook: アラートやエラーから調べる手順と報告の型
  9. インフラ運用: 孤立リソースの掃除など、破壊的な操作をガード付きで

良いスキルは1つの型にきれいに収まり、分かりにくいスキルは複数の型にまたがっている。またがるなら分ける。

書き方のコツ

  • 当たり前を書かない: Claude が既に知っていることではなく、普段の考え方から外す情報を書く
  • Gotchas 節がいちばん価値がある: 失敗するたびに追記して育てる。最初は数行と Gotcha 1つでよい
  • スキルはフォルダ: references/api.md、assets/ のテンプレ、scripts/ のヘルパー関数を置き、「どのファイルがあるか」を SKILL.md に書けば必要な時に読む（段階的な開示）。スクリプトを渡すと Claude は組み立てに手番を使える
  • 縛りすぎない: 状況に合わせる余地を残す
  • セットアップは config.json に: 投稿先チャンネルなどを保存し、未設定なら AskUserQuestion で尋ねさせる
  • description はモデル向けの「いつ使うか」: 要約ではない。詳しくは スキルの名前は動名詞形で揃え、description は短い英語で「何を・いつ」
  • データはスキル外の安定した場所に: スキル内のファイルは更新で消えうる。プラグインなら ${CLAUDE_PLUGIN_DATA} を使う
  • 必要な時だけ効く hook: /careful（PreToolUse で rm -rf・DROP TABLE・force-push を止める）、/freeze（特定ディレクトリ以外の Edit/Write を止める）のように、スキルを呼んだセッションだけ有効にする
  • 使われ方を測る: PreToolUse hook でスキルの利用を記録し、思ったほど呼ばれないスキルを見つける

配り方

少人数・少数リポならリポの .claude/skills に置く。規模が大きくなったら社内プラグインマーケットプレイスにし、使われ始めたものを PR でマーケットプレイスに移す。配り方の詳細は チームでスキルを配る：gh skill でピン留め、apm でマニフェスト化、出自で置き場所を分ける、育て方は スキルは「再現性テスト×モデル別の採点」で育てる。詰め込みすぎたら分割する。

出典

X の元の投稿を開く