template-skill

To create a valid skill unit scaffold, define required YAML frontmatter metadata fields like name and description, then write the operational instructions body to ensure your repository skill is discoverable and consistently structured for downstream automation.

The best way to structure repository templates for skill discoverability is to use a standardized SKILL.md format containing mandatory YAML frontmatter metadata alongside a clear instruction body for contextual activation workflows.

YAML frontmatter metadata works for markdown instructions by providing structured discovery fields at the top of the file, allowing automation systems to parse the skill name and description before loading the instruction body into context upon activation.

You do not need a specific repository setup or dependencies to author repository-based skills, as this scaffold only requires writing standard markdown instructions and YAML frontmatter fields directly within your existing repository.

The limitation of using a basic skill scaffold is that it only provides the initial metadata structure and instruction body, requiring you to manually implement all complex automation logic and downstream processing without built-in components.