mattpocock/skills — AIコーディングエージェント向けエンジニアリングスキル集
mattpocock/skills
★ 320,944 ・ Shell ・ MIT
概要
AIを活用したコーディングエージェントの普及に伴い、自然言語による指示だけでソフトウェアを作成する試みが増えています。しかし、エージェント任せの開発では「意図した仕様と異なるものができる」「生成されたコードが正常に動作しない」「コードベースが急激に複雑化して保守不能になる」といった課題に直面することも少なくありません。
mattpocock/skills は、作者のMatt Pocock氏が日々の開発業務で使用している .agents ディレクトリ内の設定を抽出・公開したスキル集です。READMEでは、いわゆる「vibe coding（感覚的なコーディング）」ではなく、ソフトウェア工学の原則に基づいた開発（real engineering）を行うための仕組みであると説明されています。Claude Code、Codex、GitHub Copilot、Gemini CLI、Cursorなど多様なエージェントに対応しており、エージェントとの対話を通じて仕様を詰めるプロセスやテスト駆動開発（TDD）、アーキテクチャの見直しなどを定型化します。
主な特徴
- 認識の齟齬を防ぐ質問セッション（
/grill-me,/grill-with-docs）: エージェント側から開発者に対して詳細な質問を投げかけさせることで、実装前の要件の曖昧さを解消し、目的の整合性を高めます。 - 共有言語とドキュメントの構築支援: ドメイン駆動設計（DDD）の考え方を取り入れ、プロジェクト固有の専門用語や決定事項（ADR）を明文化してエージェントと共有し、冗長な対話や誤認を抑制します。
- テスト駆動開発とバグ診断の枠組み（
/tdd,/diagnosing-bugs）: テストを先に書くRed-Green-Refactorのサイクルをエージェントに促すほか、段階を踏んだ規律あるデバッグ手順を提供します。 - アーキテクチャ劣化への対処（
/to-spec,/improve-codebase-architecture）: 仕様作成時に変更対象のモジュールを確認させたり、コードベースを走査して設計改善の候補箇所を調査・提示させたりします。 - 主要な各種AIエージェントへの広範な対応: Claude Code、Codex、GitHub Copilot、Gemini CLIのほか、
npxコマンドを介してCursorやDevin、Windsurfなど多数の環境に導入できます。
使い方
導入方法は、エージェントのプラグイン機能を利用して自動更新を行う方法と、skills.sh 経由でプロジェクト内に編集可能なファイルとして配置する方法の2種類が用意されています。二重登録を防ぐため、1つのエージェントにつきどちらか一方を選択します。
1. スキルのインストール
利用環境に応じたコマンドを実行します。
Claude Code の場合:
claude plugin install mattpocock-skills@claude-plugins-officialCodex の場合:
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocockGitHub Copilot（CLI および VS Code）の場合:
copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocockCopilot CLI では ~/.copilot/settings.json に設定を追加します。VS Code ではコマンドパレットから Chat: Install Plugin From Source を実行し、リポジトリURL（https://github.com/mattpocock/skills）を指定します。
Gemini CLI の場合:
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivityCursor やその他のエージェント、または直接ファイルを編集したい場合:
npx skills@latest add mattpocock/skills -a2. 初期セットアップ
インストール後、エージェント内で次のコマンドをリポジトリごとに1度実行します。
/setup-matt-pocock-skills実行すると、対話形式で以下の設定が行われます。
- 使用する課題追跡ツール（GitHub、GitLab、ローカルファイルなど）の選択
- チケットのトリアージ時に適用するラベルの設定（
/triageスキルで利用） - 作成される各種ドキュメントの保存場所の指定
セットアップ完了後は、各スキルコマンドを呼び出して利用できます。
技術的なポイント
mattpocock/skills は、特定のAIモデルに依存せず機能するように設計されています。各スキルは小さく、合成可能（composable）かつ現場に合わせて適応させやすい構造となっています。
設計の根底には、従来のソフトウェア工学の名著（『達人プログラマー』『エリック・エヴァンスのドメイン駆動設計』『エクストリーム・プログラミング』『A Philosophy of Software Design』など）で提唱されてきた原則が反映されています。具体的には以下のような設計上の工夫がなされています。
- フィードバックループの短縮: エージェントが単独でコードを書き進めると誤動作を起こしやすいため、静的型付けや自動テスト、ブラウザ確認などを活用したフィードバックを前提とし、
/tddスキルによって失敗するテストの作成から実装、リファクタリングへと進むステップを強制します。 - コンテキスト消費の最適化: エージェントとの対話が長くなるとコンテキストのトークンを大量に消費します。プロジェクト内の用語を定義した glossary を整備させることで、エージェントが簡潔な表現を理解できるようにし、推論にかかるトークン量の削減とファイル・関数命名の一貫性向上を図っています。
- モジュール設計の意識付け: エージェントによる高速なコーディングはソフトウェアの複雑化（エントロピーの増大）を加速させがちです。
/improve-codebase-architectureでは、インターフェースがシンプルで内部機能が充実している「深いモジュール（deep modules）」の設計思想に基づき、リファクタリングの候補箇所を調査します。
注意点
- 自動修正ツールではない点: 例えば
/improve-codebase-architectureはコードベースを走査して候補を提示する「調査（survey）」であり、乱雑になった設計を自動的にすべて解消・救済するものではないと明記されています。 - 更新方式の混在回避: プラグイン方式と手動コピー方式の両方を同一エージェントに導入すると、スキルが重複して登録されてしまいます。どちらか一方の管理方法を選択する必要があります。
- ライセンス: 本リポジトリは MIT ライセンスで提供されており、コードを自由に変更・調整して自身の環境に適用することが推奨されています。
まとめ
mattpocock/skills は、AIコーディングエージェントとの協業において生じがちな要件の食い違いや品質低下、設計の複雑化を防ぐための実践的なスキル集です。エージェントに過度に依存するのではなく、テスト駆動開発やドメイン設計といったソフトウェア開発の基本原則をワークフローに組み込むための実践的なアプローチを提供しています。
