skills.rest
jayhjenkins
jayhjenkinsCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Apply TDD to Claude Skill documentation across RED-GREEN-REFACTOR cycles.

Updated Jan 3, 2026
Search Tags:#documentation#TDD#rationalization#progressive-disclosure#skill-writing#deployment-checklist
One-click install
npx skills add https://github.com/jayhjenkins/Dev-Team-Full-SDLC --skill writing-skills-jayhjenkins
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/jayhjenkins/Dev-Team-Full-SDLC/tree/main/vendor/superpowers/skills/writing-skills
Command: npx skills add https://github.com/jayhjenkins/Dev-Team-Full-SDLC --skill writing-skills-jayhjenkins

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables teams to apply test-driven development to Claude Skill documentation, ensuring new skills, edits, and deployments follow a repeatable, verified process.

Core Features & Use Cases

  • Red-Green-Refactor discipline: document baseline failures, implement minimal skills, and close loopholes with explicit counters.
  • Progressive disclosure: structure SKILL.md with frontmatter and inline content, plus optional references/scripts to load as needed.
  • Deployment readiness: includes rationalization tables, red flags, and a deployment checklist to ensure tested skills ship correctly.

Quick Start

To create a writing-skills Skill, write SKILL.md with name and description frontmatter, present the RED-GREEN-REFACTOR flow, and add a deployment checklist. Then test the skill using the Testing Skills With Subagents framework.

Frequently Asked Questions about writing-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I apply TDD to Claude Skill documentation?▼

Apply TDD to Claude Skill documentation by following RED-GREEN-REFACTOR cycles to document baseline failures, implement minimal skills, and close loopholes with explicit counters before deployment.

What is progressive disclosure for SKILL.md files?▼

Progressive disclosure structures SKILL.md with YAML frontmatter and inline content, plus optional references or scripts that load dynamically as needed to avoid overwhelming the context window.

How do I validate readiness before deploying a Claude Skill?▼

Validate readiness before deploying a Claude Skill by using a deployment checklist that includes rationalization tables and red flags to ensure the skill ships correctly without loopholes.

Can I use test-driven development to edit existing Claude Skills?▼

Yes, you can use test-driven development to edit existing Claude Skills by running RED-GREEN-REFACTOR cycles that document baseline failures, apply minimal edits, and refactor to close loopholes.

What is the best way to structure YAML frontmatter for a Claude Skill?▼

Structure YAML frontmatter for a Claude Skill by including the required name and description fields, followed by a SKILL.md body that follows progressive disclosure patterns for optimal context loading.

Related Skills

Explore More Content & Communication Skills→
AngelWings1997AngelWings1997

writing-skills

Convert process documentation into testable SKILL.md files using TDD cycles.

Community
Advanced
barrydobsonbarrydobson

Testing Skills With Subagents

Test skill documentation with RED-GREEN-REFACTOR cycles and pressure scenarios.

Community
Intermediate
tdiminotdimino
41

skill-optimizer

Guide creation, review, and optimization of AI skills with structured metadata.

Community
Advanced
LuisAlbertoMKLuisAlbertoMK

sdd-verify

Verify implementation compliance against specifications and design documents.

Community
Advanced