はじめに：AIエージェントに「毎回同じ前提」を説明するのに疲れていませんか？

Claude CodeをはじめとするAIコーディングエージェントは非常に強力で、日々の開発スピードを劇的に引き上げてくれます。しかし、エージェントを使いこなす段階に進むにつれて、多くのエンジニアがひとつのストレスに直面します。「指示の長文化」と「プロンプトコピペのルーティン化」です。

「テスト駆動（TDD）で書いてほしい」「勝手にファイルを大きく書き換えないでほしい」「コードを変更する前にまず設計をレビューしてほしい」――プロジェクトの文脈や固有のルールを維持するために、新しいチャットセッションを立ち上げるたびに毎回長文の前提ルールをプロンプトで指示するのは、エンジニアにとって小さくない指示コスト（手間）になります。

これを解消するために、再利用可能な手順を「スラッシュコマンド」としてAIに直接教え込むアプローチが「Agent Skills（エージェントスキル）」です。例えば、私たちのこのプロジェクトでも /blog-plan や /blog-design といった固有のカスタムスキルを定義し、タスクごとに呼び出して活用しています。

今回は、このエージェントスキルをさらに汎用的なエンジニアリングのワークフローとして体系化し、公開されたことで話題の mattpocock/skills を実際に導入し、実務で使ってみた使用感と、そこから見えてきたAIエージェント活用の本質についてレポートします。

mattpocock/skillsとは何か：AIに「エンジニアの仕事の流れ」を覚えさせる

mattpocock/skills は、TypeScriptの著名な教育者・開発者であるMatt Pocock氏が作成した、AIコーディングエージェントのためのオープンソースのスキルコレクションです（GitHubリポジトリ: github.com/mattpocock/skills）。

このリポジトリの最大の特徴は、単なる「便利なプロンプト集」ではなく、シニアエンジニアが実際の開発プロセスで実践している「手順（型）」が、スラッシュコマンドとして厳密に定義されている点にあります。

提供されている代表的なスキルには、以下のようなものがあります。

  • /grill-with-docs: プロジェクトの CONTEXT.md やADR（Architecture Decision Record）を参照・更新しながら、設計案を実際のコードやドキュメントと突き合わせて「本当にこの設計で動くのか？」をAIに懐疑的かつ徹底的に検証させる（記録が残るタイプの、計画段階での厳格な壁打ち）。まだコードベースがない構想段階では、状態を保存しないシンプル版の /grill-me を使う。
  • /diagnosing-bugs: まず「このバグで確実に赤くなるテスト（tight feedback loop）」を用意することを最優先し、それが揃うまで原因の理論化を許さないバグ診断ループ。再現テストの構築から原因の絞り込み、回帰防止テストの追加までを厳格なステップで実行する。
  • /triage: 大量のGitHub Issuesや外部PRを、カテゴライズ→検証→（必要なら）壁打ちという状態遷移で仕分け、AIエージェントがそのまま着手できる粒度の「対応可能なIssue」に整える。

これらは、開発者が頭の中で意識している「正しいエンジニアリングの手順」そのものをAIのコンテキストに定着させ、再現性のある仕事の流れをコマンド一つで呼び出せるようにしています。

導入レポート：npx追加と「プラグイン化」の違い、最初のハマりどころ

実際に mattpocock/skills を手元の環境に導入してみて得られた、実用的な知見とセットアップの流れを整理します。

インストールの比較と「プラグイン化」の利点

このスキル群を導入する方法は大きく分けて2つあります。

  1. npx でプロジェクトに追加する: npx skills add mattpocock/skills -y などのコマンドを叩き、自分のプロジェクト内にスキルの定義ファイル（Markdown等）を物理的にコピーする方法です。
  2. Claude Codeの「プラグイン」として追加する: グローバルな設定ファイルである ~/.claude.json の plugins フィールドに、該当のGitHubリポジトリを指定する方法です。

実際に両方を試してみた結果、「プラグイン」としてロードする手法が圧倒的に便利であると気づきました。プラグイン化すると、ローカルプロジェクト内にファイルが直接コピーされるのではなく、Claudeのグローバル管理領域からメモリ上へ「読み取り専用 of 参照（readonly）」としてロードされます。これにより、リポジトリ側がアップデートされた際に、Claude Code起動時に自動的に最新のスキル構成がロードされる「自動更新（auto-update）」の恩恵をそのまま受けることができます。メンテナンスの手間がかからないため、プラグイン登録が推奨されます（もし自分好みにスキルをカスタマイズしたい場合は、forkしたリポジトリを指定するか、npxでローカルにコピーすると良いでしょう）。

セットアップ時のハマりどころと対処法

プラグインとして登録した後、最初に行うのが初期化コマンドです。

setup-matt-pocock-skills

このコマンドを実行することで必要な準備が整いますが、私の環境では初回セットアップ後に triage スキルがコマンド一覧に現れず、呼び出せないという認識エラーに遭遇しました。

これは、Claude Codeのセッション初期化時における、スキル定義のキャッシュ読み込みやファイルパス認識の同期ラグが原因であると推測されます。このエラーに対しては、setup-matt-pocock-skills をもう一度明示的に再実行することで、Claude Code側の内部キャッシュが強制リフレッシュされ、パスが正しく再マッピングされて正常に認識されるようになりました。

もし導入後に一部のスキルが動かない場合は、慌てずにセットアップコマンドを再実行してみてください。無事にセットアップが完了した後は、まず ask-matt コマンドを起点にして、やりたいことを入力していく流れになります。（詳しい使い方は、ask-matt/SKILL.md に整理されています）。

設計思想の深掘り：自律自動化と真逆を行く「disable-model-invocation: true」とコンテキスト管理

この mattpocock/skills を使っていて最も深く納得させられたのが、その設計思想です。このスキル群に定義されている設定を見ると、ほぼすべてのスキルで以下の仕様が有効になっています。

disable-model-invocation: true

これは、 「LLM（モデル側）の自律的な判断によって、このスキルを勝手に呼び出すことを禁止する」 という意味です。

世の中のAIエージェントのトレンドは「目的を一つ与えれば、あとは裏でAIが勝手に考えて全自動で終わらせてくれる」という全自動化に向かいがちです。しかし、実際の業務でこれをやると致命的な問題が発生します。

AIエージェントが「自分で考え、ツールを実行し、エラーが出たら勝手にリトライを繰り返す」という自律ループを回し続けると、不要なログ出力やファイルの度重なる再読み込み履歴がチャットセッション内に凄まじい勢いで蓄積されていきます。その結果、セッションの「コンテキスト窓（Context Window）」が一気に肥大化し、 「あと一歩で完了するはずだったのに、最後の最後でコンテキスト容量制限（Out of Memory）に達してクラッシュする」 という最悪の手戻りが発生します。この罠に捕まり、別窓の新しいセッションで最初からやり直す羽目になった経験があるエンジニアは少なくないはずです。

実業務におけるAIエージェント運用において、「いかにコンテキストを肥大化させず、適正に管理・分割するか」は生産性に直結する死活問題です。

disable-model-invocation: true によって自律呼び出しを縛ることは、AIに勝手な試行錯誤ループを回させないための防壁になります。人間が主体となって適切なタイミングでコマンド（スキル）を叩き、ステップごとにAIの思考と実装を制御する。そして必要に応じて人間が会話セッションを切り替え、状態を整理しながら進める。

この「人間の手によるインテリジェントなコンテキスト管理」を前提とした設計こそが、コンテキスト破綻を防ぎ、AIを「放置型おもちゃ」から「リアルなエンジニアの信頼できる道具」にするための、極めて実用的で合理的な設計思想なのです。

まとめ：こだわりのないエンジニアこそ、この「仕事の流れ」に乗るべき

「AIをどう使いこなすか」のプロンプトをゼロから模索し、自分だけの秘伝のタレを作るのは時間がかかります。もし、自分の仕事の進め方やワークフローに強いこだわりがないのであれば、Matt Pocock氏らが構築した「洗練されたエンジニアリングの型」に身を委ね、このスキル群の仕事の流れに乗ってみるのが、AI協働時代の最もスマートな生産性向上の近道です。

私たちMeetsourceでも、AIを単に「全自動で放置する」のではなく、「人間が最終確認を行うチェックポイント（ハードゲート）を設ける」など、人間が主体的に制御する安全なAI Operations（AIと人間の安全な協働）を提唱し、業務プロセスの設計・自動化支援を行っています。

AIエージェントのカスタムスキル構築による実務の自動化や、安全なプロセスのコード化についてのご相談は、こちらのコンタクトフォームからお気軽にお問い合わせください。