skill は、AI agent のための再利用可能な on-demand workflow を package したものです。繰り返し task のための instructions（いつ実行し、どう実行するか）に、必要に応じて agent が task に relevant なときだけ load する optional scripts or resources を加えます。procedure を毎回説明する代わりに、一度教える仕組みです。
skill とは何か
text
skill は、AI agent のための再利用可能な on-demand workflow を package したものです。繰り返し task のための instructions（いつ実行し、どう実行するか）に、必要に応じて agent が task に relevant なときだけ load する optional scripts or resources を加えます。procedure を毎回説明する代わりに、一度教える仕組みです。
SKILL = agent が必要に応じて取り込める self-contained folder:
SKILL.md → metadata + instructions (the TRIGGER + the STEPS)
scripts/ → optional helper scripts the agent runs (e.g. a linter, a generator)
resources/ → optional templates, examples, reference files
→ loaded ONLY when relevant → base context を小さく保ち、workflow を repeatable にする
payoff は progressive disclosure です。agent は短い description から skill が 存在する ことを知り、matching task が来たときだけ full instructions と scripts を取り込みます。したがって多数の skill があっても、毎 conversation を膨らませません。
skill には 3 つの部分があります。trigger（いつ）、steps（どう）、そして helper scripts（tools）です。focused かつ composable にします。kitchen sink ではなく、1 job をよくこなすものにします。
---
name: changelog-entry
description: Add a CHANGELOG entry. Use when finishing a user-facing change.
---
# Add a changelog entry
## Steps
1. Read the latest commits since the last release tag.
2. Categorize each as Added / Changed / Fixed.
3. Prepend a dated section to CHANGELOG.md under [Unreleased].
4. Run `scripts/validate.sh` to check the format.
description が trigger です。agent にいつこの skill を使うかを伝えます。番号付き list が steps、validate.sh が format correctness を enforce する helper script です。skill が小さく single-purpose なので、他の skill と clean に compose できます（例: 別の "release" skill がこれを呼ぶ）。
Skills は agent を、毎回再説明が必要な general assistant から、あなたの recurring procedures を知る assistant に変えます。trigger、steps、scripts を focused で composable な unit に package し、必要なときだけ load することで、institutional knowledge を一度 encode して reliable に再利用できます。repetitive task で一貫した result を得られ、すべての workflow の context cost を毎 request で支払う必要もありません。