Skills For Real Engineers 完全ガイド：Matt Pocock のAIエージェントスキル集

Skills For Real Engineers とは

一言で答えると：Skills For Real Engineers（リポジトリ名：Matt Pocock Skills）は、Matt Pocockが公開しているプロフェッショナルエンジニア向けのAIエージェントスキル集であり、Matt Pocockが日頃実践している .claude ディレクトリの運用に由来します。

その位置づけは明確です。vibe coding のおもちゃではなく、「実際にエンジニアリングをする」ための日常ツールボックスです。作者自身、これらのスキルはClaude Code、Codexなどのコーディングエージェントで繰り返し遭遇するよくある失敗モードを直すために作ったと述べています。

GSD・BMADとの違い

GSD、BMAD、Spec-Kitなどの手法は「プロセスを掌握する」ことを目指します。掌握する代わりに、あなたのコントロールも奪い、プロセスに問題が起きると原因を特定しづらくなります。Skills For Real Engineers は逆の路線を取ります。

• 小さく美しい：各スキルが単独で使え、万能フレームワークにしない。
• 組み合わせ可能：必要に応じて選び、自由にカスタマイズして自分のリポジトリに合わせる。
• ハック可能：スキルは自分たちのリポジトリにある普通のファイル。気に入らなければ書き換えればいい。
• モデル非依存：特定のモデルに縛られず、Claude、Codex、Cursorなどで使える。
• エンジニアリング本来の原則：『The Pragmatic Programmer』『Domain-Driven Design』などの古典的エンジニアリング原則に基づき、プロンプトテクニックの寄せ集めではない。

製品の位置づけ

すでに本物のエンジニアリング習慣を持つ開発者向けです。静的型付け、自動テスト、レッド・グリーン・リファクタリングといった現実のフィードバックでエージェントを制約し、「盲目的な飛行」を避けます。スキル集自体はホスティングサービスを提供せず、アーキテクチャを決めることもありません。再利用可能な対話・プロセス用インターフェースを提供するだけです。

主な機能

スキルはスラッシュコマンド形式でエージェントに提供され、主にいくつかのグループに分かれています。

要件のすり合わせ

• /grill-me：高密度の質疑応答セッションにより、コーディング前に要件と判断の分岐を徹底的にすり合わせます。コーディング以外のシーンでも使えます。
• /grill-with-docs：grilling をベースに、プロジェクトの共通言語とアーキテクチャ決定記録（ADR）を一緒に作り上げます。
• /zoom-out：エージェントに局所的なコードから離れ、システム全体の視点で説明するよう求めます。

開発と検証

• /tdd：エージェントにレッド・グリーン・リファクタリングのループを実行させ、垂直スライス単位で機能を構築したり欠陥を修正したりします。
• /diagnose：標準化された診断ループ（再現→最小化→仮説→計装→修正→回帰テスト）です。
• /prototype：動作するターミナルプロトタイプや複数のUIバリアントを素早く作成し、設計を検証します。

タスクと計画

• /triage：状態機械に基づいてIssueをトリアージして割り当てます。カスタムラベル語彙に対応します。
• /to-prd：現在の会話コンテキストを自動的にPRDへとまとめ、GitHub Issueとして提出します。
• /to-issues：計画やPRDを、個別に引き受け可能な垂直スライスのタスクへ分割します。

アーキテクチャとコラボレーション

• /improve-codebase-architecture：CONTEXT.md と ADR に基づいてモジュールを深化させる機会を見つけ、アーキテクチャの泥玉（big ball of mud）を改善します。
• /caveman：通信モードを極限まで圧縮し、技術的な精度を保ったままトークン消費を約75%削減します。
• /handoff：現在のセッションを引き継ぎドキュメントに圧縮し、他のエージェントがシームレスに作業を続けられるようにします。
• /teach：現在のディレクトリを状態を持つ学習スペースとして使い、複数セッションに分けて新しいスキルや概念を教えます。
• /write-a-skill：規定の構造に従って新しいスキルを作成します。段階的な開示（progressive disclosure）とリソースのパッケージ化に対応します。

共通言語の仕組み

CONTEXT.md を通じてプロジェクトの用語体系を確立するのが、このスキル集の中で作者が最も重視する手段です。作者が観察したのは次のような現象です。エージェントは通常、プロジェクトにいきなり放り込まれ、業界用語を推測しながら作業します。その結果、本来1語で説明できることを20語使って表現してしまいます。

例を挙げると、「コース内のセクションにあるレッスンが made real（実体化）される」という表現を「materialization cascade に問題がある」と言い換えるだけで、説明コストを大幅に省けます。しかもこの簡潔さはセッションを重ねるごとに複利のように効いてきます。共通言語には他にも次のようなメリットがあります。変数・関数・ファイルの命名が一貫する。エージェントにとってコードベースをナビゲートしやすくなる。エージェントの思考に使うトークンも少なくなる。

Skills For Real Engineers の使い方

導入経路は2つあり、それぞれ異なる哲学に対応しています。どちらか一方だけを選んでください。

経路1：Claude Code プラグイン

• スキル一式が管理された読み取り専用パッケージとしてインストールされ、作者がリリースすると自動更新されます。「フォークする」のではなく「購読する」イメージです。
• Claude Code の公式マーケットプレイスに登録済みで、事前にソースを追加する必要はなく、アップデートは自動で届きます。
• ネイティブの Codex プラグインはロードマップにあります（.agents/adr/0002-ship-as-a-claude-code-plugin.md を参照）。

経路2：skills インストーラー

npx skills@latest add mattpocock/skills を実行し、対象のエージェントを選択して /setup-matt-pocock-skills にチェックを入れます。インストーラーでは、どのスキルを取得するか、どのコーディングエージェントにインストールするかを選べます。スキルは普通のファイルとしてリポジトリに書き込まれ、あなたが所有・編集でき、背後で自動更新されることはありません。最新の変更を取り込むときは npx skills update を実行します。

注意：両方の経路を同時にインストールすると、すべてのスキルが2つずつ存在することになります。

初期化と日常のリズム

1. エージェントで /setup-matt-pocock-skills を一度実行します。リポジトリごとに一度実行してください。次のことを尋ねられます：どのIssueトラッカーを使うか（GitHub、Linear、またはローカルファイル）。トリアージ時にどんなラベルを付けるか（/triage はこのラベルに依存します）。生成したドキュメントをどこに保存するか。
2. 変更の前には毎回、/grill-me か /grill-with-docs で要件をすり合わせます。
3. 開発中は /tdd で品質を確保します。
4. バグに遭遇したら /diagnose で標準化された診断を開始します。
5. アーキテクチャのメンテナンスとして、定期的に /improve-codebase-architecture を実行し、コードの腐敗を防ぎます。

インストールと設定は全体で約30秒で完了します。IssueトラッカーとしてGitHub、Linear、ローカルファイルに対応しています。

適したシーン

• 要件のすり合わせと計画：プロジェクト開始時や機能変更の前に、/grill-me または /grill-with-docs でエージェントに高密度の質問を重ね、要件・判断の分岐・ドメイン用語を完全に揃えます。
• テスト駆動開発：コード品質を保証したいときは、/tdd でエージェントにレッド・グリーン・リファクタリングのループを実行させ、垂直スライス単位で機能構築や欠陥修正を進め、変更のたびに自動テストで守ります。
• 複雑なバグ診断：再現が難しい性能低下や論理的な欠陥に直面したら、/diagnose で診断ループ全体を回します。
• アーキテクチャの継続的ガバナンス：大規模・長期保守のコードベースで /improve-codebase-architecture を定期的に実行し、CONTEXT.md と ADR に基づいてモジュール深化の機会を見つけ、エージェントによる腐敗の加速を防ぎます。
• セッションをまたぐ協働：/handoff でセッションを圧縮し、/caveman でトークンを削減します。長いタスクや、複数人・複数エージェントのリレーに適しています。

利点

• 軽量で組み合わせ可能：重厚なフレームワークを排し、各スキルが単独で使え、自由にカスタマイズできます。
• モデル非依存：Claude、Codex、Cursorなどで使えます。
• エンジニアリング本来の原則：プロンプトテクニックではなく、古典的なエンジニアリング原則に基づいています。
• 共通言語の仕組み：CONTEXT.md がエージェントのコミュニケーションコストとトークン消費を大幅に削減します。
• フィードバックループ：静的型付け、自動テスト、レッド・グリーン・リファクタリングなど、現実のフィードバックを重視します。
• 改造しやすい：skills 経路では、スキルはリポジトリ内の編集可能なファイルです。

制約・注意点

• これはスキル集であり、エンドツーエンドのプロセスマネージャーではありません。共通言語やADRの規律を持たないチームは、CONTEXT.md と決定記録を自分たちで維持する必要があります。
• /triage のラベル体系は初期化時の設定に依存します。設定が不適切だとトリアージの効果に影響します。
• 2つのインストール経路は排他的で、混在させるとスキルが重複します。
• ネイティブのCodexプラグインはまだロードマップ上にあり、Codexユーザーは現時点ではスキルファイルのインストール経路を使います。
• 具体的なサポート範囲、コマンドの詳細、更新のペースは変わることがあります。

価格・利用可否の確認について

今回の事実資料には、価格・購読料・ライセンス条件に関する情報は一切含まれていません。そのため推測はしません。有料かどうか、ライセンス形態、利用可能なインストール経路、最新バージョンの状態については、製品公式サイト https://github.com/mattpocock/skills と、お使いのエージェントの公式プラグインマーケットページで直接確認してから判断してください。

よくある質問（FAQ）

特定のモデルに縛られますか？

いいえ。公式の説明ではモデル非依存で、Claude、Codex、Cursorなどで使用できます。

インストールすればすぐ使えますか？

初期化が必要です。エージェントで /setup-matt-pocock-skills を一度実行し、Issueトラッカー、トリアージ用ラベル、ドキュメント保存ディレクトリを設定してください。その後、/triage などのスキルがあなたの設定に従って動作します。

プラグインとインストーラーはどちらを選ぶべき？

作者の更新についていき、読み取り専用の管理パッケージを受け入れるなら Claude Code プラグイン。ファイルを所有・改造し、更新のタイミングを自分でコントロールしたいなら npx skills@latest add mattpocock/skills です。両方は同時にインストールしないでください。

GSD・BMAD とは競合しますか？

作者の設計意図は、代替となる考え方を提供することです。GSD、BMAD、Spec-Kit はプロセスを掌握することで助けになりますが、その代わりにコントロールを奪い、プロセス内の問題を解決しにくくします。このスキル集は小さく美しく、組み合わせ可能で、ハック可能な路線を選びます。併用するかどうかは、チームの規律次第です。

最初に試す価値が最も高いスキルは？

作者は、/grill-with-docs がこのリポジトリ全体で最も強力なテクニックかもしれないと述べています。それは高密度の質疑応答セッションであると同時に、AIと共通言語を作り上げ、説明しにくい判断をADRに記録するのを助けます。

代替案

• GSD、BMAD、Spec-Kit：開発プロセスを掌握しようとする重厚なフレームワーク。コントロールは少なく、プロセスの問題を特定しにくい。
• 一泽 Eze 氏が公開しているオープンソースの Agent Skill：インターネットの使い方を考えることに焦点を当てる。
• Jesse Vincent 氏が公開しているオープンソースの Agentic スキルフレームワークとソフトウェア開発手法プラグイン。
• AI コーディングアシスタント専用に設計されたオープンソースの AI デザイン Skill。
• 一般的なやり方：自分たちで .claude やプロジェクトレベルのスキルファイルを維持し、チームの習慣に合わせて組み立てる。

一次情報

• 製品公式サイトとリポジトリ：https://github.com/mattpocock/skills

このスキル集の変更や、作者が新しく作ったスキルを追いかけたい場合は、約60,000人の開発者が購読している作者のニュースレターに登録できます。