skill-authoring

To create reusable workflows, you define a new capability by writing instructions, procedures, and domain knowledge in a SKILL.md file. This saves workflows for future sessions, allowing different tasks to invoke the stored procedures later.

The best way to teach an agent a task is to create a skill that describes the procedure and provides example workflows. This stores the capability so the agent can apply it automatically in future interactions without needing repeated instructions.

Creating agent skills requires satisfying frontmatter specifications in the SKILL.md file. You can also use optional directories to organize scripts, references, and assets, which augments the skill's core instructions and scaffolds reference material like templates.

Yes, you can save checklists and templates by using the reference material scaffolding feature. This organizes examples and templates within optional directories, speeding up future task execution by providing the agent with readily available structured guidance.

You structure documentation by outlining the skill's name, description, and example workflows directly within the SKILL.md file. This format ensures workflows are properly documented and can be seamlessly invoked by automated tasks in subsequent sessions.