Skills For Real Engineers - Matt Pocock

Matt Pocockのエージェントスキル集、バイブコーディングではない実戦エンジニアリングのためのツールボックス

このリポジトリは、TypeScript教育者としてよく知られるMatt Pocockが、自身が毎日使っているClaude Code向けのエージェントスキル、つまりスラッシュコマンドと行動規約をまとめて公開したプロジェクトです。スローガンは"Skills For Real Engineers"であり、著者はGSD、BMAD、Spec-Kitのようにプロセス全体を抱え込む方式のフレームワークが開発者のコントロールを奪い、不具合が生じたときの追跡を難しくすると見て、その代案として小さく置き換え可能で、どのモデルとも組み合わせられるツール単位のアプローチを提示しています。実際にコードベースを開いてみると、スキルはskills/配下でengineering、productivity、misc、personal、in-progress、deprecatedといったバケットに分かれており、各スキルは独自のSKILL.mdを持つ独立した単位として管理されています。

• インストール経路のシンプルさ: npx skills@latest add mattpocock/skillsの1行でインストールし、/setup-matt-pocock-skillsでイシュートラッカーの種類、トリアージで使うラベル語彙、ドキュメントの保存場所を一度に設定できるようになっています。リポジトリごとに1回だけ実行すれば、ほかのスキルがその設定を共有します。

• エージェントの失敗モードを4つに整理した設計意図: 1つ目は「望むものを作れない」アラインメント問題で、grill-me、grill-with-docsが意図を最後まで問い詰めるインタビューセッションを強制します。2つ目は「過度に冗長なエージェント」の問題で、ドメイン用語辞典にあたるCONTEXT.mdを作って、トークンの浪費と命名の一貫性の問題を同時に減らします。3つ目は「コードが動かない」問題で、tddがレッド・グリーン・リファクタのループを、diagnoseが再現から回帰テストまでのデバッグループをそれぞれ担います。4つ目は「マッドボール化してしまったコード」で、to-prd、zoom-out、improve-codebase-architectureがモジュール境界とシステム全体の視野を回復する役割を担います。

• 共有言語の扱い方の差別化: 単なるコーディング支援から一歩進み、エージェントと人のあいだの語彙を明示的に一致させることに重点を置いています。例として示されたcourse-video-managerのCONTEXT.mdは、「コース内のセクション内のレッスンがファイルシステム上に居場所を持つ時点の問題」を"materialization cascade"というひと言に圧縮する形で、同じ会話を繰り返すたびにトークンと認知コストの両方を減らすよう設計されています。

• セカンダリスキルの実用性: 日常ワークフロー向けにcaveman（約75パーセントのトークン削減を狙う圧縮応答モード）、write-a-skill（スキル自体を作るメタスキル）がまとめられており、補助ツール群にはgit-guardrails-claude-code（危険なgitコマンドを事前に遮断するフック設定）、setup-pre-commit（Husky+lint-stagedベースの事前コミット構成）などが含まれていて、コード記述以外の領域まで小さなツールに分割して扱っています。

• リポジトリ自体の運用ルール: engineering、productivity、miscに入ったスキルは必ず最上位のREADMEと.claude-plugin/plugin.jsonに登録し、personal、in-progress、deprecatedには登録を禁じるという形で、公開範囲をコードレベルで強制しています。ADRドキュメントが別ディレクトリに存在し、スキルリンク用シェルスクリプトがscripts/に別途置かれている点も、同じ規律の延長線上にあると読めます。

全体としてこのプロジェクトは、「エージェントが勝手に全部やってくれる」という類いの統合自動化からは距離を置き、Pragmatic Programmer、Domain-Driven Design、Extreme Programming、A Philosophy of Software Designのような古典的エンジニアリング原則を、小さく置き換え可能なスラッシュコマンド単位に分解して移し替えた形に近いです。派手なワークフロー自動化ツールを期待したユーザーにはやや地味に見えるかもしれませんが、エージェント時代にもアラインメント、共有言語、フィードバックループ、モジュール設計という基礎を日々の道具へ落とし込もうとする試みという点で、実務に近い肌触りを持っています。