Skills

概要

Skill（スキル）は、特定のタスクのやり方をAIコーディングエージェントに教える、パッケージ化された一連の指示とリソースです。すべての会話で自分の流儀を説明し直すのではなく、それを一度だけSkillとして書きます（短い説明に加えて手順、例、補助ファイル）。そしてエージェントは、そのタスクが出てきたときに必要に応じてそれをロードします。状況がマッチしたときにエージェントが取り出すレシピのようなものだと考えてください。

強み

ノウハウを一度捉えて再利用するため、すべてのプロンプトで同じセットアップを繰り返さなくて済む。
関連するときだけロードされるため、それ以外のときはエージェントのコンテキストを散らかさない。
プレーンで読みやすいファイル（通常はMarkdown）なので、書く・レビューする・gitでバージョン管理するのが容易。
チームやプロジェクトをまたいで共有でき、全員が同じ信頼できる手順を持てる。

トレードオフ

古かったり曖昧だったりするSkillはエージェントを誤った方向に導きかねず、ドキュメントと同様にメンテナンスが必要。
重複するSkillが多すぎると、どれが当てはまるのか混乱しかねない。
エージェントがタスクを認識して取り込んだときにのみ役立つ。
それはガイダンスであって保証ではなく、エージェントは依然として筋書きから外れることがある。

使いどころ

特定のルールを伴う繰り返し可能な手順 — デプロイの手順、コードスタイルのチェックリスト、ドメイン固有のフォーマットなど、そうでなければ毎回チャットに貼り付けることになるもの — があるときに、Skillを使いましょう。

バイブコーディングとの相性

Skillは、ありふれたアシスタントをあなたのアシスタントに変える手段です。プロジェクトが望む物事の進め方 — 命名、テスト、操作の順序 — をエンコードすれば、エージェントは自動的にそれに従います。各Skillを狭く保ち、明確に名付けることで、エージェントがいつ呼び出すべきかを正確に把握できるようにしましょう。

---
name: ship-checklist
description: Steps to take before shipping any change to production.
---

1. Run the test suite and confirm it passes.
2. Bump the version in package.json.
3. Update CHANGELOG.md with a one-line summary.
4. Commit, push, then deploy.