writing-skills

The required YAML frontmatter for a Claude skill file includes name and description fields. This schema standardizes skill creation to ensure consistent metadata and scalable maintenance across team workflows.

To ensure maintainability, structure a Claude skill using a three-level content model: frontmatter, skill body, and supporting files. Include a dedicated maintenance.md to guide pre-push update checks for consistent quality.

Set up pre-push checks by creating a maintenance.md file that maps skill file paths to review criteria. This maintenance workflow helps teams audit and rewrite skills to sustain quality over time.

Yes, this standardization process applies to teams creating, reviewing, or auditing .claude/skills/* files. It enforces a consistent frontmatter schema and content model to maintain structural quality during team audits.

The three-level content model for Claude skill design consists of YAML frontmatter, the skill body, and supporting files. This structure enforces consistency and scalable maintenance for every skill created.