writing-great-skills

汇总编写高质量 agent skills 的词汇与原则，提升可预测性与一致性。

为编写和编辑 agent skills 提供一套词汇与原则，目的是让技能更可预测、更一致。适合在创建或改写 skills 时参考，帮助定义调用方式、行为期望和文档风格。核心强调可预测性——让 agent 每次走同样的流程，而不是盲目追求同样输出。

A skill exists to wrangle determinism out of a stochastic system. **Predictability** — the agent taking the same _process_ every run, not producing the same output — is the root virtue; every lever below serves it.

**Bold terms** are defined in [`GLOSSARY.md`](GLOSSARY.md); look them up there for the full meaning.

## Invocation

Two choices, trading different costs:

- A **model-invoked** skill keeps a **description**, so the agent can fire it autonomously _and_ other skills can reach it (you can still type its name too). It contributes to **context load** — the description sits in the window every turn. Mechanics: omit `disable-model-invocation`, and write a model-facing description with