Write and validate Claude Skills using a RED-GREEN-REFACTOR workflow.
npx skills add https://github.com/ssimhan/meal-planner --skill writing-skills-ssimhan
Please help me install this Agent Skill. Skill: writing-skills Source: https://github.com/ssimhan/meal-planner/tree/main/skills/writing-skills Command: npx skills add https://github.com/ssimhan/meal-planner --skill writing-skills-ssimhan
This Skill provides a structured, test-driven approach to documenting and validating Skills, ensuring clarity, consistency, and verifiable behavior before deployment.
To start, write the YAML frontmatter (name and description) for a new Skill, then draft the body with an overview, use cases, and implementation guidance.
High-intent search queries and answers about installing and using this skill.
Test-driven skill-writing enforces a RED-GREEN-REFACTOR cycle to document and validate Claude Skills. It requires drafting a YAML frontmatter block with name and description, then structuring the Markdown body with guidance and references.
The required frontmatter format for a SKILL.md file is a YAML block at the top containing only the name and description fields. This frontmatter discipline ensures clarity and consistency before skill deployment.
Structure Claude Skill documentation for progressive disclosure by organizing the Markdown body so Claude reads essential guidance sections first, accessing heavy references only when needed during task execution.
Yes, you can use this TDD framework to edit and validate existing Claude Skills. It applies test-driven development discipline to editing existing skills and verifying their frontmatter and behavior prior to deployment.
A limitation of this TDD approach for skill-writing is its strict frontmatter constraint, allowing only name and description in the YAML header, which may restrict adding custom metadata fields to the SKILL.md file.
rafaelminatto1Guide developers through the RED-GREEN-REFACTOR cycle for test-first coding.
HeartcoolmanDeploy a cloud agent to execute a test skill and verify UI changes.
kreuzberg-devValidate Markdown syntax and structure via HTML roundtrip testing.
troykellyVerify review artifacts and block PR creation when gates fail.
