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

Ready to run

npx skills add https://github.com/bamecho/my-claude-skills --skill writing-skills-bamecho

💬 Prompt for ChatGPT / Claude Chat▼

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.