skill-authoring

You save reusable agent instructions by creating a skill directory with a root SKILL.md file containing YAML frontmatter and a markdown body. This captures repeatable workflows persistently for future sessions.

Creating a knowledge base of repeatable procedures requires defining a skill directory under .agents/skills/ with a SKILL.md file. This file uses YAML frontmatter for metadata and markdown for operational instructions.

YAML frontmatter for skill authoring requires a concise name and description to make the skill discoverable. You place this metadata at the root of a SKILL.md file before writing the markdown instruction body.

You need to define future behavior when you find yourself repeatedly redoing useful instructions and decision procedures. Capturing these as a skill provides durable, persistent instructions you can invoke later.

Yes, you can include project-specific paths, conventions, and links to other skills in the markdown instruction body. This enables project-context awareness and allows you to build larger compositional workflows.

A limitation of using a SKILL.md file is that it requires manual YAML frontmatter and markdown authoring to define behavior safely. It serves as a static text instruction set rather than an executable automated script.