TL;DR
- プロンプトのコピペ管理は限界。リポジトリで「スキル」として資産化すべき
.agents/skills/配下の Markdown ファイルでバージョン管理と再利用を実現view_fileツールによる動的なスキルロードが自律的エージェントの鍵
The Pain: コピペプロンプトの限界
「このタスク、先週もChatGPTにお願いしたな…」 そう思って、過去のログからプロンプトを探し出し、コピペして微調整する。 これは非効率ですし、チームで共有することも困難です。なにより、その場しのぎの「使い捨て」になってしまいます。
The Solution: Skill Definition (スキル定義)
プロンプトを「チャット画面に入力するテキスト」ではなく、「実行可能なファイル（Skill）」として定義し、リポジトリで管理します。
Skillファイルの構造
.agents/skills/ ディレクトリ配下に、Markdownファイルとして保存します。
markdown
---
name: code-review-checklist
description: 厳しいテックリードとしてコード品質をチェックするスキル
version: 1.0.0
---
あなたはシニアエンジニアです。以下の観点でコードをレビューしてください。
## 1. Security
- SQLインジェクションの可能性はないか？
- APIキーがハードコードされていないか？
## 2. Performance
- N+1問題が発生していないか？
...
The Implementation: view_file によるロード
エージェントを使う際は、長文のプロンプトを打ち込む代わりに、こう言うだけです。
"code-review-checklist スキルを使って、このファイルをレビューして。"
エージェントは自律的に .agents/skills/code-review-checklist/SKILL.md を読み込み（view_file）、その中の指示に従って振る舞いを切り替えます。
The Takeaway: プロンプトは資産である
プロンプトをファイル化することで、以下のメリットが生まれます。
- Version Control: Gitで変更履歴を追える。
- Reusability: 誰でも同じ品質でタスクを実行できる。
- Modularity: 他のスキルから参照したり、組み合わせたりできる。
次回は、単なるチェックリストを超えて、エージェントに「思考の手順（アルゴリズム）」を教え込む方法について解説します。
参考・一次資料
スキル定義ファイルの設計は、Anthropic の公式ドキュメントが示す Agent Skills / Tool use / プロンプト設計の原則に準拠すると再現性が高まります。
- Anthropic: Agent Skills — スキルの構造と読み込みモデルの公式仕様
- Anthropic: Tool use overview — ツール定義とスキーマ設計の正本
- Anthropic: Prompt engineering overview — 再利用可能な指示文の設計原則
- Claude Code: Skills —
SKILL.mdの運用と配布
References
- プロンプトを「スキル」として資産化する技術（ハブ）
- 複雑な思考プロセスをパッケージ化する：Thought Packaging
- エージェントに「道具」を持たせて自律性を高める
- SDD（Software Design Document）をベースにした開発手法
- Antigravity Awesome Skills の全容
- Skill対Subagent使い分け基準 — Skill 定義した後、Subagent と組み合わせる場面で「どちらを選ぶか」の判断軸を 5軸の比較表で整理
