skills.rest
Xza85hrf
Xza85hrfCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Author and test Claude Skills using a TDD-inspired RED-GREEN-REFACTOR workflow.

Updated Feb 9, 2026
Search Tags:#documentation#best-practices#progressive-disclosure#skill-architecture#skill-writing#testing-skills#ttd
One-click install
npx skills add https://github.com/Xza85hrf/claude-code-agent-kit --skill writing-skills-xza85hrf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/Xza85hrf/claude-code-agent-kit/tree/main/.claude/skills/meta/writing-skills
Command: npx skills add https://github.com/Xza85hrf/claude-code-agent-kit --skill writing-skills-xza85hrf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writers and reviewers of Claude Skills struggle to produce concise, testable, and discoverable SKILL.md artifacts that scale across teams. This guide provides a structured approach to authoring, testing, and tuning Skills with TDD-style loops and progressive disclosure.

Core Features & Use Cases

  • TDD-inspired Skill creation and testing workflow
  • Progressive disclosure with frontmatter-driven guidance and reference separation
  • Clear guidance for describing, naming, and organizing Skills at scale

Quick Start

Follow the SKILL.md frontmatter and body guidance to draft, test, and refine a new skill using the RED-GREEN-REFACTOR cycle.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write Claude Skills that are testable and scale across teams?▼

Apply progressive disclosure to SKILL.md files by separating frontmatter-driven guidance from reference files, ensuring naming, frontmatter structure, and documentation standards comply with skill architecture best practices.

What is the best way to test Claude Skills before deployment?▼

Refine existing Claude Skills by applying the RED-GREEN-REFACTOR cycle to enforce progressive disclosure, check frontmatter structure, validate naming conventions, and optimize documentation standards across skill units.

Does this skill authoring workflow require specific testing frameworks?▼

Yes, this approach handles large skill architectures by applying progressive disclosure with frontmatter-driven guidance and reference separation, organizing skill units to maintain documentation standards at scale.

Why does my Claude Skill fail progressive disclosure standards?▼

To structure a SKILL.md file correctly, follow frontmatter and body guidance to draft, test, and refine the skill using the TDD cycle, ensuring compliance with naming, description quality, and documentation standards.

Related Skills

Explore More Content & Communication Skills→
emellebyemelleby

skill-creator

Design, document, and package Claude skills with SKILL.md frontmatter.

Community
Intermediate
devtitusdevtitus

writing-skills

Automate skill documentation creation and validation using the RED-GREEN-REFACTOR workflow.

Community
Intermediate
duggal1duggal1
2

skill-creator

Initialize and validate AgentSkills against the AgentSkills spec.

Community
Advanced
third774third774
5

agent-skills

Author and improve Agent Skills following the agentskills.io specification.

Community
Basic