本物のためのAgent Skills入門
Matt Pocock skills: 小さく合成可能な工程、不 vibe coding。導入、分類、主フロー解説。
vibe coding はデモを出す。本物のエンジニアリングは変化に耐える系を出す。mattpocock/skills ↗(275k star、23k fork、MIT)は実務の小さな合成可能スキル集: grilling、domain modeling、TDD、bug 診断、architecture、triage。
GSD、BMAD、Spec-Kit ではない。あれは工程を奪い control を取る。ここは鋭い単目的ツール。あなたが合成する。どの model でも動く。
なぜあるか: 4失敗モード#
| # | 失敗 | 修正スキル |
|---|---|---|
| 1 | 思った物を作らない | /grill-me、/grill-with-docs |
| 2 | 冗長、jargon 混乱 | GLOSSARY.md共有言語 + ADR |
| 3 | コードが動かない | /tdd、/diagnosing-bugs |
| 4 | 泥団子、エージェント速度でエントロピ | /to-spec、/improve-codebase-architecture |
ELI5: 質問なしで頼むのは図面なしで「家建てて」と言うようなもの。grilling は図面 interview。共有言語は「壁=煉瓦、カーテンでない」の合意。TDD は煉瓦を一枚ずつ検査。architecture review は階を足す前の基礎補修。
30秒導入#
二経路、二哲学。一つ選ぶ——両方は全スキル重複。
# Claude Code: 管理 read-only bundle、自動更新
claude plugins install mattpocock-skills
# セッション内:
/plugin install mattpocock-skills
# Codex 他: 編集可コピー、あなた所有
npx skills@latest add mattpocock/skills
# setup-matt-pocock-skills を必ず含めるbashrepo毎に一回:
/setup-matt-pocock-skills
# 質問: tracker (GitHub / Linear / local)
# 質問: /triage 用ラベル
# 質問: 生成 docs 置場text[!WARNING] plugin と skills.sh 併用は重複。購読(plugin)か fork(skills.sh)か。
[!TIP] いじりたい人: Claude Code でも
npx skills@latest add。repo 内ファイル、背後更新なし。npx skills updateで手動取得。
user-invoked vs model-invoked#
覚える軸は一つ:
- user-invoked(
/grill-me、/implement、/triage…)—あなたが打って起動。統率役。他 user を呼ばない。 - model-invoked(
/tdd、/code-review、/diagnosing-bugs…)—あなたか agent が適合時起動。再利用規律を持つ。
user は model を呼べる、user 同士は呼ばない。
engineering マップ#
user-invoked: /ask-matt、/grill-with-docs、/triage、/improve-codebase-architecture、/to-spec、/to-tickets、/implement、/implement-spec、/wayfinder、/retro
model-invoked: /tdd、/diagnosing-bugs、/research、/domain-modeling、/codebase-design、/code-review、/pr、/prototype、/wizard
productivity マップ#
user: /grill-me、/handoff、/teach、/to-questionnaire、/wait-what
model: /grilling(grill 系背後の質問 primitive)、/writing-for-agents
実践: 機能 slice#
# 1. repo毎一回
/setup-matt-pocock-skills
# 2. コード前 align
/grill-with-docs
# 質問され、用語は GLOSSARY.md、決定は ADR
# 3. spec→ticket
/to-spec
/to-tickets
# 4. 規律 build
/implement
# seam で /tdd、commit 前 /code-reviewtext共有言語の効果実例: 前「filesystem に場所を得た section 内 lesson」→後「materialization cascade」。20語が1語に、毎回、変数・関数・ファイル名も一貫。
cross-agent 注意#
Claude Code、Codex、Cursor、Copilot、Windsurf、Gemini、Cline 対応。注意二つ: OpenCode は installer 未掲載——読む.claude/skillsか.agents/skillsに入れるか copy。user-invoked 旗は Claude Code 規約——無視する agent では model-invocable 化。
使う時、外す時#
| 使う | 外す |
|---|---|
| 規律保持 workflow 欲しい | 自律 framework に任せたい |
SKILL.md 読める | 読めない |
| TDD、ADR、issue 衛生重視 | one-shot 生成だけ |
| 小スキル適応好き | hosted PM 製品要 |
結論#
小さく、合成可、hack 可。/setup-matt-pocock-skillsから、毎機能/grill-with-docs。第2回は grill→TDD→debug 深掘り。