クイックサマリー: grill-me は、TypeScript 教育者として著名な Matt Pocock 氏が公開しているエージェントスキルで、コードを1行も書く前に AI があなたへ詳細な質問を浴びせ、仕様の曖昧さを徹底的に潰してくれるツールです。上位版の grill-with-docs は、質問セッションに加えてプロジェクトの「共有言語（ドメインモデル）」を文書化し、CONTEXT.md や ADR（アーキテクチャ決定記録）を自動更新します。Claude Code をはじめ、Codex CLI など複数のコーディングエージェントに対応しています。
grill-me が解決する課題 — 「AIが思った通りに作ってくれない」
AI コーディングで最も頻繁に起こる失敗は、バグでも性能でもなく「認識のズレ（misalignment）」です。指示を出して数分後、出来上がったコードを見て「そういう意味じゃなかった」と気づく——vibe coding を経験した開発者なら誰もが通る道と考えられます。
公式リポジトリの README では、この課題について『達人プログラマー』の一節「誰も自分が何を望んでいるかを正確には知らない」を引用しつつ、解決策は AI に質問させること（grilling session）だと説明されています。作業を始める前に AI があなたを「グリル（尋問）」することで、頭の中にしかなかった要件が言語化されるという発想です。
この記事でわかること:
- grill-me / grill-with-docs で何ができるか、2つの違い
- npx skills を使ったインストールと初期設定の具体的手順
- 実際の開発フロー（仕様策定→実装→テスト）への組み込み方
- 類似スキルとの比較と、導入前に知っておくべき注意点
なお、mattpocock/skills は MIT ライセンスの OSS です。リポジトリは GitHub で約16.6万スター・1.4万フォークを獲得しており（2026年7月時点）、grill-me 単体で約52.2万インストール、grill-with-docs は約43.8万インストールと、エージェントスキルの中でもトップクラスの人気を持ちます。
何ができるか — grill-me と grill-with-docs の違い
対応 CLI は Claude Code / Codex CLI などで、インストーラーの skills.sh がインストール先のコーディングエージェントを選択させてくれる仕組みです。主要機能は次の通りです。
- /grill-me: 変更内容について AI が詳細な質問を連続で投げかける「質問攻めセッション」。X（旧Twitter）では「コードを1行も書く前に40個以上の質問で詰められる」「開発者の間で最もインパクトのあるスキルと言われている」という報告が話題になりました
- /grill-with-docs: grill-me と同じセッションに加えて、プロジェクト固有の用語を定義した「共有言語」を構築し、CONTEXT.md と ADR をその場で更新。README では「このリポジトリで単体では最もクールなテクニックかもしれない」と紹介されています
- 周辺スキルとの連携: 同リポジトリには仕様化の /to-spec、テスト駆動の /tdd、デバッグの /diagnosing-bugs、設計改善の /improve-codebase-architecture などが含まれ、grill 系スキルを起点に組み合わせられます
公式ドキュメントによると、共有言語の整備には副次効果もあります。変数・関数・ファイルの命名が一貫するためエージェントがコードベースを辿りやすくなり、簡潔な語彙で考えられるぶん思考トークンの消費も減るとされています。
インストール・有効化手順（30秒セットアップ）
公式 README の「Quickstart」に従うと、初期設定は次の1コマンドから始まります。
npx skills@latest add mattpocock/skills実行するとインタラクティブな選択画面が表示されるので、以下を選びます。
- インストールしたいスキル（grill-me / grill-with-docs に加えて、/setup-matt-pocock-skills を必ず選択するよう公式が案内しています）
- インストール先のコーディングエージェント（Claude Code、Codex CLI など複数選択可）
Claude Code を選んだ場合、スキル定義（SKILL.md）はプロジェクトの .claude/skills/ 配下に配置されます。続いてエージェント内で初期設定コマンドを実行します。
/setup-matt-pocock-skills公式ドキュメントによると、このセットアップでは次の3点を対話形式で質問されます。
- 使用する Issue トラッカー（GitHub / Linear / ローカルファイル）
- チケットのトリアージに使うラベル（/triage スキルが参照）
- 生成ドキュメント（CONTEXT.md や ADR）の保存先
動作確認は簡単で、Claude Code 上で /grill-me と入力し、変更したい内容を一言伝えるだけです。質問が返ってくれば導入成功です。
設定例 — SKILL.md を自分のチームに合わせて改造する
このリポジトリの設計思想は「小さく、改造しやすく、組み合わせ可能」です。README にも「Hack around with them. Make them your own.（いじり倒して、自分のものにしてほしい）」と明記されており、GSD や BMAD、Spec-Kit のような「プロセス全体を握る」フレームワークとは対照的に、スキル単位での改変が公式に推奨されています。
たとえば質問の観点を自社ドメインに寄せたい場合、.claude/skills/grill-me/SKILL.md を開き、質問方針のセクションに追記します。
# SKILL.md への追記例
- 決済・課金に関わる変更の場合は、必ず冪等性と
リトライ時の二重課金リスクについて質問すること
- 日本語で質問することデフォルトでは質問数に固定の上限はなく、曖昧さが解消されるまで続く設計です。「毎回40問は重い」と感じる場合は、SKILL.md に「質問は最重要の10問に絞る」と書き足す運用も可能で、このカスタマイズ性の高さが OSS スキルならではの利点と考えられます。
grill-me を実際の開発フローに組み込む方法
公式 README が想定する使い方は「変更を加えるたびに毎回使う」です。実務では次のようなパイプラインが組めます。
- 要件の尋問: 新機能に着手する前に
/grill-with-docsを実行。「ユーザーのサブスクリプション解約フローを追加したい」と伝えると、「解約は即時か期間末か」「返金ポリシーは」「解約済みユーザーのデータ保持期間は」といった、実装前に決めておくべき質問が続きます - 仕様化: セッションの結論を
/to-specで仕様書に変換し、/to-ticketsでチケット分割 - 実装とテスト:
/tddスキルで red-green-refactor ループを回しながら実装 - ドキュメントの自動蓄積: grill-with-docs が更新した CONTEXT.md と ADR がそのまま次回セッションの文脈になり、プロジェクトが進むほど質問の精度が上がる好循環が生まれます
職種別のユースケースも見てみましょう。
- SaaS のバックエンド開発者: API の破壊的変更前に grill-me で影響範囲を言語化し、ADR として決定理由を残す
- 受託開発のフリーランス: クライアントの曖昧な要望を grill セッションの質問リストに変換し、そのままヒアリングシートとして流用する
- 社内ツール開発者: ドメイン用語（社内略語や業務フロー名）を grill-with-docs で共有言語化し、後任者や別のAIセッションへの引き継ぎコストを下げる
類似スキル・代替ツールとの比較
「実装前の認識合わせ」を担うツールは他にもあります。主要な選択肢を客観的に比較します。
| ツール名 | 対応CLI | ライセンス | 最終更新 | 特徴 |
|---|---|---|---|---|
| grill-me / grill-with-docs | Claude Code / Codex CLI 等（skills.sh 経由） | MIT | 活発（2026年7月時点で継続更新） | 質問攻めで曖昧さを潰す。with-docs は共有言語と ADR を自動整備。小さく改造しやすい |
| Spec-Kit | Claude Code / Copilot / Gemini CLI 等 | MIT | 公式リポジトリで確認 | 仕様駆動開発の包括フレームワーク。プロセス全体を規定する分、導入は重め |
| BMAD-METHOD | Claude Code / Cursor 等 | OSS（公式リポジトリで確認） | 公式リポジトリで確認 | アナリスト・PM等の役割エージェントで計画を作る重量級手法。チーム開発の型を求める人向け |
README 自身が GSD・BMAD・Spec-Kit を「プロセスを握ることでコントロールを奪い、プロセス内のバグを直しにくくする」と位置付けており、grill 系は既存の自分のワークフローに1コマンドだけ差し込みたい人向けという棲み分けが明確です。逆に、開発プロセス全体を規定してほしいチームには Spec-Kit 系のほうが合うと考えられます。
注意点・制約・セキュリティ
- 時間とトークンの消費: 40問規模の質問に答えるセッションはそれ自体が数十分かかることがあります。1行のタイポ修正のような小変更には過剰で、README も「非自明な変更」での使用を想定しています
- スキルの実体は Markdown: SKILL.md はプロンプト指示書であり、スキル自体が外部サーバーへデータを送信する仕組みはありません。コードの送信先は、あくまで利用中のエージェント（Claude Code なら Anthropic の API）に準じます
- インストーラーの実行権限:
npx skills@latestはサードパーティ製 CLI の実行を伴います。導入前にリポジトリの内容を確認する基本動作は他の npm ツール同様に必要です - 英語ベースの設計: 質問は既定で英語です。日本語で運用したい場合は前述の SKILL.md カスタマイズで対応できますが、公式サポートされた設定項目ではない点に留意してください
- user-invoked スキルの制約: grill-me は「ユーザーが明示的に呼び出す」タイプのスキルで、エージェントが自動発動することはありません。使い忘れると効果はゼロなので、CLAUDE.md に「新機能着手前は /grill-me を提案する」と書いておく運用補強が有効です
まとめ — vibe coding からの卒業に効く1コマンド
- grill-me は「AI に書かせる前に、AI に詰めてもらう」ことで認識のズレを潰すスキル。約52.2万インストールと実績も十分です
- grill-with-docs はさらに共有言語・CONTEXT.md・ADR を自動整備し、使うほどプロジェクトの文脈が濃くなります
- 導入は
npx skills@latest add mattpocock/skillsと/setup-matt-pocock-skillsの2ステップで完了します
「AI の出力の質は、渡した文脈の質で決まる」という原則を、日々のワークフローに強制的に組み込んでくれるのが grill 系スキルの本質です。まずは次の機能開発の着手前に一度試し、質問リストの鋭さを体感してみてください。さらに詳しい仕様や最新の変更履歴は、Claude Code のスキル機構の公式ドキュメントと mattpocock/skills リポジトリの README を参照してください。
コメント