writing-skill-md

What problem does it solve?

This Skill ensures every Skill Unit follows the official SKILL.md format by enforcing the presence of a SKILL.md frontmatter containing a name and a description. It clarifies how to structure and document agent skills for consistent discovery and activation.

Core Features & Use Cases

• Frontmatter validation: Verifies that the root SKILL.md defines required fields like name and description and that the name matches the parent directory.
• Structure guidance: Explains the expected directory layout (skill-name/, SKILL.md) and how to use optional folders (scripts/, references/, assets/).
• Compliance auditing: Used to review existing skills for adherence to the skill-authoring spec and prepare them for activation. Use Case: When creating a new skill, use this guide to ensure the Skill Unit is compliant from the start.

Quick Start

Create a new directory named my-skill with a SKILL.md containing the required frontmatter and a concise description, then add any optional resources as needed.