example-skill

To document a new skill properly, include YAML frontmatter with name and description fields, followed by a markdown body detailing operational instructions. This structure ensures proper skill discovery and activation.

To create a consistent markdown template for onboarding contributors, use a validated example demonstrating proper SKILL.md structure and frontmatter. This provides clear formatting guidance and maintains consistent documentation across new skills.

YAML frontmatter for skill discovery and activation must include the name and description fields. This metadata allows the skill to be properly identified and loaded into the skill catalog for operational use.

You need a standardized documentation template for your skill catalog when a developer or product team creates new skills and requires a clear template to ensure proper formatting, usage documentation, and contributor onboarding.

A limitation of using a basic markdown template for skill documentation is its focus on fundamental structure rather than complex internal design. It serves as a starting point and may require extension for advanced skill reasoning.