この記事の目的
Claude Code などのコーディングエージェントで「指示したつもりが、出てきたものが違う」問題を減らすための Skills リポジトリの導入手順と、実際に使って効果があったスキルを整理します。
前提環境
- Claude Code（または Codex、Cursor など
.claude/ディレクトリを読むエージェント） - Node.js
- 実際に開発中のプロジェクト
Skills とは
Matt Pocock 氏が公開した mattpocock/skills は、.claude ディレクトリに配置する Markdown 形式の指示ファイル集です。GitHub Trending で1日に約4,000スターを獲得し、現在77,000スター超。
Skills はモデルの能力を拡張するものではなく、エージェントのタスクへの取り組み方を構造化します。再利用可能なプロンプトの足場のようなものです。
セットアップ手順
1. インストール
npx skills@latest add mattpocock/skills
使いたいスキルを選択します。/setup-matt-pocock-skills は必ず選択してください。
2. 初期設定
エージェント内で実行：
/setup-matt-pocock-skills
以下を聞かれます：
- イシュートラッカーの種類（GitHub / Linear / ローカルファイル）
- トリアージ用ラベル
- ドキュメント保存先
プロジェクトごとに1回だけの設定です。
効果が高かったスキル4選
/grill-with-docs（最重要）
コーディング前にエージェントが詳細な質問をしてきます。何を作るのか、エッジケースは何か、制約は何か。
出力として CONTEXT.md（共有語彙ファイル）が生成されます。プロジェクト固有の用語を正確に定義し、以降のセッションでエージェントがそれを参照します。
あるプロジェクトでは15語の説明が2語のドメイン用語に置き換わり、以降のセッションが短く正確になりました。
/tdd
テスト駆動開発を強制：テスト作成→実装→検証の順序。関数単位の開発に強い。複雑なUI作業ではテスト仕様の事前定義が難しく、逆に遅くなる場合があります。
/diagnose
エラー発生時に推測ではなく構造的な診断を行います。エラーメッセージが根本原因を示していない場合に特に有効。
/caveman
エージェントの出力を極限まで簡潔にします。何をすべきかが明確で、説明が不要な場面向け。
全28スキルの分類
アライメント系： /grill-me, /grill-with-docs, /to-prd, /to-issues
コード品質系： /tdd, /diagnose, /prototype, /triage, /zoom-out
ワークフロー系： /handoff, /write-a-skill, /review（開発中）, /setup-pre-commit
制限事項
- スキルはプロンプトの構造化であり、モデル能力の拡張ではない
-
CONTEXT.mdはプロジェクトの変化に合わせて更新が必要 - 28個のうち、まず
/grill-with-docs、/tdd、/diagnose、/cavemanの4つから始めるのが現実的 - エージェント非依存のため、Claude Code 固有機能（
/goalなど）は利用できない
チームで複数エージェントを使う場合
Skills はエージェントの振る舞いを改善しますが、チームで複数エージェントを運用する段階では、モデルルーティングとコスト管理が次の課題になります。
Claude Code CLI をゲートウェイに接続し、タスクタイプごとにモデルを割り当てるパターンが有効です。EvoLink の Claude Code CLI 連携ガイドにセットアップ手順があります。
参考リンク
Tags: Claude, ClaudeCode, AI, コーディングエージェント