writing-skills

To validate SKILL.md frontmatter, locate the frontmatter block and check for required fields like name, tagline, and description. This Skill scans repository directories to locate SKILL.md files and outputs a single YAML document per Skill unit including all required fields and safety assessments.

TDD-driven skill authoring enforces a RED-GREEN-REFACTOR workflow to ensure new Claude skills start with measurable baselines and are verified before deployment, preventing untested updates through progressive disclosure patterns and quality assurance checklists.

You discover all skill units by scanning directories with SKILL.md at the root. This identifies valid units by locating SKILL.md frontmatter, validating required fields, and outputting a single YAML document per Skill including category, keywords, dependencies, and safety assessment.

Yes, test-driven skill authoring works without external dependencies. You begin by drafting a failing baseline scenario and iteratively implementing and testing the skill until it passes, relying on built-in quality assurance checklists and anti-pattern guidance.

Common anti-patterns when creating Claude skills include deploying untested updates and skipping progressive disclosure. Using deployment checklists, rationalization handling, and structuring SKILL.md with lightweight inline content prevents these issues by loading heavy references on demand.

Yes, you can link to or reuse content from other skills. Cross-skill referencing supports linking to or reusing existing content to improve discoverability and maintain consistency across the repository without duplicating documentation.