your-skill-name-kebab-case

To create reference documentation for onboarding developers, use a lightweight SKILL.md template with frontmatter containing name and description, supporting optional scripts, references, and assets directories.

Documenting clean-code techniques is best handled by creating concise, shareable reference skills that act as a canonical guide for developers and AI agents without wiring into the pipeline.

Yes, reference documentation requires frontmatter, but only a lightweight structure mandating the name and description fields to enable simple cataloging and consistent discovery across tools.

Yes, you can use a skills catalog to share architect guides and style rules by copying the template into skills/<your-skill-name>/SKILL.md, making it discoverable via frontmatter.

You should not use frontmatter-based reference skills for knowledge sharing when your documentation requires wiring into the pipeline or needs pipeline-specific fields beyond basic cataloging.