skills.rest
bamecho
bamechoCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Author and validate Claude Skill documentation using RED-GREEN-REFACTOR practices.

1|Updated Nov 21, 2025
Search Tags:#workflow#testing#tdd#documentation#skills#subagents#rationalizations
One-click install
npx skills add https://github.com/bamecho/my-claude-skills --skill writing-skills-bamecho
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/bamecho/my-claude-skills/tree/main/skills/writing-skills
Command: npx skills add https://github.com/bamecho/my-claude-skills --skill writing-skills-bamecho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams write and validate Claude Skills using a test-driven approach to documentation, ensuring that guidance is concrete, testable, and free from ambiguity.

Core Features & Use Cases

  • RED-GREEN-REFACTOR lifecycle for skill creation and maintenance.
  • YAML frontmatter discipline with name and description for robust discovery.
  • Progressive disclosure structure to keep SKILL.md concise while enabling heavy references when needed.
  • Tools and patterns for documenting rationalizations and pressure scenarios to prevent loopholes.

Quick Start

Begin by drafting a SKILL.md with a failing baseline (RED), then implement a minimal skill (GREEN), and finally close loopholes (REFACTOR) while re-validating with pressure scenarios.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write test-driven documentation for Claude Skills?▼

Test-driven documentation for Claude Skills uses a RED-GREEN-REFACTOR lifecycle. You draft a failing baseline SKILL.md, implement minimal guidance to pass, then refactor to close loopholes while re-validating with pressure scenarios.

What is progressive disclosure in Skill documentation?▼

Progressive disclosure keeps SKILL.md concise while enabling heavy references when needed. This structure ensures Claude receives clear triggering conditions without overwhelming the core guidance with excessive detail.

How do I validate frontmatter metadata for Skill discovery?▼

Validating frontmatter metadata requires enforcing YAML discipline to ensure name and description fields are present. This robust discovery mechanism allows Claude to accurately identify and trigger the appropriate Skill.

How do I prevent loopholes when authoring Claude Skills?▼

Preventing loopholes when authoring Claude Skills involves documenting rationalizations and testing with pressure scenarios during the REFACTOR phase. This ensures guidance remains concrete and free from ambiguity.

Do I need subagents to test Skill documentation workflows?▼

Subagents are not required to test Skill documentation workflows. The validation process focuses on frontmatter discipline, triggering conditions, and progressive disclosure using strict test-driven development practices.

Related Skills

Explore More Content & Communication Skills→
GOODWORKRINKZGOODWORKRINKZ

writing-skills

Enforce a test-driven process for creating and validating SKILL.md files.

Community
Advanced
nice-and-precisenice-and-precise

Writing Skills

Apply test-driven development cycles to verify process documentation with subagents.

Community
Advanced
johanruttensjohanruttens

skill-writer

Create and validate Claude Code Agent Skills with SKILL.md frontmatter.

Community
Basic
barrydobsonbarrydobson

Testing Skills With Subagents

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

Community
Intermediate