sd-skill

You test and document Claude Skills by applying a RED-GREEN-REFACTOR workflow: write a minimal failing baseline, implement a minimal passing version, and re-test until compliant. This enforces verifiable behavior and prevents rationalizations.

The RED-GREEN-REFACTOR workflow for skill design is a disciplined framework establishing a repeatable creation process. It starts with a failing baseline, implements minimal functionality to pass, then refactors skill documentation and testing artifacts for compliance.

You enforce quality assurance when creating new Skills by applying pressure scenarios and rationalization tracking. This framework specifies required frontmatter fields, Markdown structure, testing artifacts, and safety constraints to ensure traceability and compliance.

No dependencies are required to start the skill creation workflow. The framework operates independently, allowing skill authors to establish testing formats, deployment checklists, and safety constraints without external tool installations.

Pressure scenarios in skill testing are targeted evaluation formats used to challenge a Skill's behavior and track rationalizations. You use them during the RED phase to establish a failing baseline and throughout the workflow to verify compliance and safety.

Skill documentation fails compliance checks when missing required frontmatter fields, proper Markdown structure, or testing artifacts. Applying the RED-GREEN-REFACTOR workflow enforces these metadata constraints and prevents rationalizations from masking missing safety specifications.