skill-authoring

To create reusable agent skills, define a new skill using a lowercase hyphenated name and write a SKILL.md file with frontmatter containing a concise description and practical examples. This captures and persists task templates and procedural knowledge for future sessions.

Defining a new skill in SKILL.md requires frontmatter with a clear name and description. This enforces the basic structure needed to capture task templates and workflows, ensuring the agent can properly recognize and apply the skill.

Yes, you can use markdown to organize large skill templates and procedural knowledge. For large Skill units, you can separate extended content and references into distinct files, keeping the main SKILL.md concise while supporting on-demand resources.

The best way to save task workflows is to capture them as reusable skills using the SKILL.md format. By defining a clear name and description, you persist procedural knowledge and templates, reducing repetitive setup each time you start a task.

Yes, skill authoring supports optional scripts, references, and assets to back the skill with on-demand resources. While SKILL.md frontmatter enforces the required name and description, these optional components extend the skill's capabilities.

You need to define a lowercase hyphenated name when creating agent skills to enforce consistent formatting and recognition within the system. This naming convention ensures the SKILL.md frontmatter properly registers the skill for future use.