Skill Authoring

Skills are on-demand procedures. AGENTS.md holds durable invariants; documentation holds reference material; permissions and checks enforce deterministic rules.

Decide whether to create a skill

Delete content that is inferable, duplicated, obsolete, or too generic to change behavior. Create a skill only when a recurring task needs instructions that should not load for unrelated work. Existing data files do not prove that their authoring workflow is still active. Check current use and deletion history before creating or restoring a skill.

Use three layers:

1. name and description: metadata shown in the skill tool.
2. SKILL.md: the procedure needed whenever the skill is loaded.
3. Referenced files or scripts: optional detail loaded or executed only when required.