writing-skills

Test-driven development for skill documentation applies the RED-GREEN-REFACTOR cycle to draft, validate, and refine SKILL.md files before deployment. This enforces structured frontmatter and trigger contracts throughout the authoring process.

The red-green-refactor workflow for SKILL.md files is a cycle that drafts skill triggers, validates metadata parity, and refines documentation. It ensures frontmatter-driven documents meet shared standards before review and deployment.

Validating frontmatter parity and trigger contracts involves checking SKILL.md files against shared skill standards. The test-driven workflow enforces these metadata requirements during the GREEN phase before proceeding to refactoring.

Yes, test-driven documentation supports editing existing plugin bundles. Skill maintainers can run the verification workflow to revalidate frontmatter, triggers, and metadata parity across updated SKILL.md files.

The best way to document new skills before deployment is following the Skill Creation Checklist: RED, GREEN, REFACTOR, and REVIEW. This sequence ensures all frontmatter, triggers, and metadata pass validation checks prior to release.

Yes, the skill writing workflow integrates with the Skill Reviewer. After completing the RED-GREEN-REFACTOR cycle and validation, the generated SKILL.md files transition into the Skill Reviewer workflow for final review.