my-first-skill

A SKILL.md file defines a packaged skill using mandatory YAML frontmatter for name and description alongside an imperative Markdown body. You need this format to author skills, validate OpenSkills loaders, or teach skill packaging best practices.

To structure a SKILL.md file, include mandatory YAML frontmatter containing name and description fields, followed by a Markdown body written in imperative form. This format clarifies progressive disclosure and prevents common formatting mistakes.

Place supplementary documentation in a references directory to demonstrate resource resolution. This directory structure provides deeper guidance and supports progressive disclosure for skill authors and testers using the OpenSkills loader.

Yes, you can use a compact example directory to test OpenSkills loader behavior and validate SKILL.md parsing. This approach demonstrates resource resolution and frontmatter formatting without requiring complex skill packaging.

Common SKILL.md formatting mistakes include omitting mandatory YAML frontmatter fields like name and description, or writing the Markdown body outside the required imperative form. Following progressive disclosure best practices prevents these errors.

No dependencies are required to validate SKILL.md structure. You only need a SKILL.md file with proper YAML frontmatter and an optional references directory to test loader resolution and demonstrate skill packaging.