Skills - AIエージェントのための実践的エンジニアリングスキル

1. プロジェクト概要

Skills（Matt Pocock 作）は、AIエージェントの「スキル」のオープンソースコレクションです。再利用可能で構成可能な命令セットであり、Claude Code や Codex などのコーディングエージェントに、高速だが信頼性に欠けるコード生成ではなく、規律ある実践的なソフトウェアエンジニアリング手法を教えます。

2. 背景と位置づけ

Skills は、開発者が AI コーディングエージェントを扱う際に直面する、繰り返し発生する4つの失敗パターンを修正するために作られました。

開発者の意図とエージェントの出力のミスマッチ — grill-me や grill-with-docs などの構造化されたインタビュースキルで緩和します。
プロジェクトの明確性を損なうエージェントの冗長な出力 — 共有ドメイン言語と、エージェントをプロジェクトの用語に基づかせる CONTEXT.md 規約で対処します。
弱いフィードバックループによる壊れたコード — テスト駆動開発（tdd）と構造化デバッグ（diagnosing-bugs）で取り組みます。
エージェント主導の急速な開発によるアーキテクチャの劣化 — improve-codebase-architecture などの設計指向スキルで防止します。

大規模なオールインワンの「エージェントフレームワーク」プロジェクトとは異なり、Skills は意図的に小さく、特定の意見を押し付けません。各スキルは、モノリシックなシステムの一部ではなく、自己完結型で編集可能な Markdown ファイルです。これにより、コレクション全体を読んだり、適応させたり、フォークしたり、チームが必要とするものだけに切り詰めたりすることが容易になり、規範的なワークフロー全体を採用する必要はありません。

3. 機能カテゴリ

🛠️ エンジニアリングスキル — ユーザー起動型（8スキル）: 開発者が明示的にトリガーしてワークフローを調整します。

ask-matt — タスクに適したスキルを見つけるのに役立つルーター
grill-with-docs — プロジェクトのドメインモデルを構築するインタビューセッション
triage — イシューの状態を管理および優先順位付け
improve-codebase-architecture — アーキテクチャの改善案を提示および提案
implement — TDD を組み込んだ機能開発
目的: 一般的な高レベルなエンジニアリングワークフローのための明示的なエントリポイントを開発者に提供します。

🤖 エンジニアリングスキル — モデル起動型（8スキル）: エージェントがタスク中にいつ適用するかを決定します。

tdd — テスト駆動開発ループを強制
diagnosing-bugs — 構造化された仮説駆動型のデバッグ手法
research — 引用元を必要とする調査ワークフロー
domain-modeling — 一貫したプロジェクト用語を強化および維持
code-review — 二軸（正確性 + 仕様準拠）のレビュー基準を適用
目的: 開発者が要求しなくても、エンジニアリングの規律をエージェントのデフォルト動作に直接組み込みます。

📈 生産性スキル — ユーザー起動型（4スキル）: 開発者がトリガーするワークフローヘルパー。

grill-me — 大規模なタスクの前の徹底的な計画インタビュー
handoff — 作業を別のエージェントセッションに引き継ぐための会話サマリーを生成
teach — オンボーディングのためのマルチセッションスキル指導
writing-great-skills — 新しいスキルを作成するためのリファレンスガイド
目的: 計画、オンボーディング、セッション間の継続性を合理化します。

🔁 生産性スキル — モデル起動型（1スキル）: バックグラウンドワークフローのサポート。

grilling — 他のスキルが利用する再利用可能なインタビューループ
目的: 他のインタビュースタイルのスキルが呼び出す共有ビルディングブロックを提供します。

4. 主なハイライト

設計による構成可能性 — すべてのスキルは小さな独立した SKILL.md ファイルであるため、チームは必要なものだけを採用し、残りは自由に編集できます。
二重起動モデル — スキルはユーザー起動型（明示的に要求）とモデル起動型（エージェントが自動的に適用）に分かれており、エージェントの動作を細かく制御できます。
組み込みの TDD 規律 — tdd と implement スキルは、エージェントにコードを書く前にテストを書くよう促し、「弱いフィードバックループによる壊れたコード」という失敗パターンに直接対処します。
推測ではなく構造化デバッグ — diagnosing-bugs と research は、エージェントに自由に推測させるのではなく、仮説を立てて情報源を引用することを要求します。
ドメイン言語への接地 — CONTEXT.md と domain-modeling により、エージェントは一般的な表現ではなく、プロジェクトの実際の用語を使用し続けます。
複数のインストールパス — 管理・自動更新される Claude Code プラグインとして、または Codex やその他のエージェント向けの npx skills による編集可能なファイルとして機能します。

5. 役割別のユースケース

一般の開発者: grill-me と implement を使用して、曖昧な機能要求を適切にスコープされ、テストでカバーされた実装に変換し、handoff を使用してセッションをまたいで作業を再開します。
プロジェクト/テックリード: improve-codebase-architecture と code-review を使用して、エージェントがより多くのコードを貢献するにつれて、アーキテクチャとレビュー基準の一貫性を維持します。
AIエージェントをコードベースに導入するチーム: setup-matt-pocock-skills、CONTEXT.md、domain-modeling を使用して、エージェントに共有語彙を提供し、初日から出力のミスマッチを減らします。

6. はじめに

必要なものを見つける — リポジトリ内のスキルカタログとカテゴリを参照するか、エージェントセッション内でルータースキルに質問します:

/ask-matt

インストール/統合:

# Claude Code プラグイン（管理・自動更新）
claude plugins install mattpocock-skills
# または Claude Code セッション内で:
/plugin install mattpocock-skills

# Codex およびその他のエージェント（編集可能なローカルファイル）
npx skills@latest add mattpocock/skills

# リポジトリごとの1回限りのセットアップ
/setup-matt-pocock-skills

貢献 — スキルは意図的に小さく、適応が容易です。リポジトリをフォークし、SKILL.md を編集または追加し、writing-great-skills のガイダンスに従ってプルリクエストを開いてください。

7. プロジェクト構造

skills/
├── .agents/            # エージェント設定ファイル
├── .claude-plugin/      # Claude Code プラグイン設定
├── .github/workflows/   # CI ワークフロー
├── docs/                # ドキュメント
├── scripts/             # ビルドおよびユーティリティスクリプト
├── skills/
│   ├── engineering/     # コード中心のスキル（tdd、code-review など）
│   └── productivity/    # 一般的なワークフロースキル（grill-me、handoff など）
├── AGENTS.md            # エージェント向けドキュメント
├── CLAUDE.md            # Claude 固有のセットアップメモ
├── CONTEXT.md           # プロジェクトのドメインモデルと用語
└── LICENSE              # MIT ライセンス

各スキルは専用の SKILL.md を持つ独自のディレクトリに存在し、いつどのように使用すべきかを説明しているため、コレクションの閲覧と拡張が容易です。

8. 関連エコシステム

依存関係: Claude Code（Anthropic のコーディングエージェント CLI）と Codex。これらはスキルが設計された2つの主要なエージェントランタイムです。インストールと更新に使用される skills npm パッケージ/CLI（npx skills）。
補完ツール: カスタムスキル/プラグインの読み込みをサポートする Markdown 駆動のエージェントは、各 SKILL.md が自己完結型の命令セットであるため、原則としてこれらのスキルファイルを利用できます。

9. ライセンス

✅ 個人または商用プロジェクトでコードを使用、変更、再配布できます（MIT ライセンスで許可）。
✅ リポジトリをフォークし、個々のスキルをチームのワークフローに合わせて適応できます。
❌ 再配布するコピーから元の著作権およびライセンス表示を削除しないでください。
ℹ️ MIT ライセンスはソフトウェアを「現状のまま」保証なしで提供します。本番環境で使用する前に、リポジトリ内の LICENSE ファイルで全条件を確認してください。

10. FAQ

Q: これらのスキルを使用するには Claude Code が必要ですか？
A: いいえ — Claude Code ユーザーはプラグインマーケットプレイスからインストールでき、Codex やその他のエージェントユーザーは npx skills@latest add mattpocock/skills で編集可能なファイルをインストールできます。

Q: スキルを最新の状態に保つにはどうすればよいですか？
A: Claude Code プラグインは自動更新されます。手動でインストールしたファイルの場合は、npx skills update を実行してください。

Q: ユーザー起動型とモデル起動型のスキルの違いは何ですか？
A: ユーザー起動型スキルはあなたが明示的にトリガーします（例: /grill-me）。一方、モデル起動型スキル（例: tdd、diagnosing-bugs）は、関連する場合にエージェントが自動的に適用します。

Q: 独自のスキルを作成できますか？
A: はい — リポジトリ内の writing-great-skills スキルで、作成のガイダンスと規約を確認してください。

Q: インストール後に必要なセットアップ手順はありますか？
A: はい — リポジトリごとに /setup-matt-pocock-skills を1回実行して、イシュートラッキング、トリアージラベル、ドキュメントの場所を設定してください。

11. クイックリンク

リポジトリ: https://github.com/mattpocock/skills
ライセンス: https://github.com/mattpocock/skills/blob/main/LICENSE
イシュー: https://github.com/mattpocock/skills/issues
ディスカッション/コミュニティ: リポジトリのイシューとプルリクエスト経由

12. まとめ

Skills は、AI コーディングエージェントを規律あるエンジニアのように動作させるための、軽量で編集可能なツールキットをチームに提供します。コーディング前に計画し、リリース前にテストし、プロジェクトの実際のドメイン言語に基づいて行動します。これは、すでに Claude Code や Codex に依存しており、重厚なフレームワークを採用せずに、より一貫性のあるレビュー可能な出力を求める開発者やテックリードに最適です。