skills.rest
bbohhu-prog
bbohhu-progCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Document Claude skills using test-driven development with YAML frontmatter.

Updated Apr 12, 2026
Search Tags:#tdd#documentation#writing#skills#claude-skills#rationalizations
One-click install
npx skills add https://github.com/bbohhu-prog/waxs --skill writing-skills-bbohhu-prog
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/bbohhu-prog/waxs/tree/main/.claude/skills/superpowers/writing-skills
Command: npx skills add https://github.com/bbohhu-prog/waxs --skill writing-skills-bbohhu-prog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing Skills is test-driven development applied to process documentation, ensuring consistency, testability, and resilience in skill creation and maintenance.

Core Features & Use Cases

  • TDD-based skill creation: write pressure-based tests, observe failures, then craft skill content to address them.
  • Documentation discipline: enforce frontmatter, structured guidance, and explicit triggering conditions for CSO.
  • Red-Green-Refactor workflow: document and close loopholes, maintain a rationalization table, and perform meta-checks.
  • Collaboration aids: provide patterns for organizing multi-file references and progress disclosure to Claude.

Quick Start

Begin by drafting a concise SKILL.md with frontmatter and a minimal body, then create a test plan to exercise baseline failures and verify compliance.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply test-driven development to process documentation?▼

Test-driven documentation applies the RED-GREEN-REFACTOR cycle to skill creation by drafting pressure-based tests, observing failures, then writing content to address them. This ensures repeatable, verifiable documentation patterns.

What is the best way to structure Claude skills for consistency?▼

Structuring Claude skills requires YAML frontmatter with name and description fields, followed by a minimal body. This enforces documentation discipline and supports progressive disclosure for organized multi-file references.

How do I validate skill documentation for loopholes and edge cases?▼

Validating skill documentation involves performing meta-checks and maintaining a rationalization table to close loopholes. The test-driven workflow explicitly documents red flags and verifies compliance across scenarios.

Does writing skills require any external dependencies or components?▼

Writing skills operates with no external dependencies or components. It functions as a standalone methodology for creating, editing, and validating Claude skills using test-driven principles.

Why does my skill documentation fail verification checks?▼

Skill documentation fails verification when it lacks required YAML frontmatter or explicit triggering conditions. Applying the test-driven workflow identifies these baseline failures through pressure-based tests before crafting compliant content.

Related Skills

Explore More Content & Communication Skills→
alexsandrocruzalexsandrocruz
6

writing-skills

Validate Claude skill documentation using test-driven development with subagents.

Community
Intermediate
HohlasHohlas
3

writing-skills

Enforce test-driven documentation practices for Skill writing with RED-GREEN-REFACTOR workflows.

Community
Advanced
guiling0guiling0

skill-elements

Clarify skill activation timing and conflict resolution in 三国杀.

Community
Basic
windyskywindysky

moai-docs-generation

Generate documentation patterns from code for Sphinx, MkDocs, TypeDoc, and Nextra.

Community
Advanced