skill-authoring

You can save reusable agent workflows by authoring a skill package that stores step-by-step procedures in a persistent directory. This captures repeatable processes, like a consistent review workflow, so future sessions can follow the same proven approach without re-creating instructions.

The best way to create a skill for repeatable procedures is to define a SKILL.md file at .agents/skills/your-skill-name/. This file packages your knowledge into a persistent format using YAML frontmatter for name and description, plus a body for the operational steps.

YAML frontmatter works for skill discovery by providing a structured name and description at the top of the SKILL.md file. This metadata allows the agent system to easily find and select the relevant skill when a matching task is requested in future sessions.

No special dependencies are required to start authoring skills. You only need to create a text-based SKILL.md file with proper YAML frontmatter and operational instructions, making it accessible to package knowledge without complex environment setups.

You should package instructions into a skill when you develop a reliable procedure that you need to reuse repeatedly, such as a specific user request handling workflow. It prevents the problem of re-creating useful workflows by saving them persistently across sessions.