skills.rest
dxc-danny
dxc-dannyCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Create and validate Claude Skills with YAML frontmatter and progressive disclosure.

8|1|Updated Mar 29, 2026
Search Tags:#tdd#documentation#skill-development#claude-skills#progressive-disclosure#yaml-frontmatter#skill-writing
One-click install
npx skills add https://github.com/dxc-danny/superpowers-cn --skill writing-skills-dxc-danny
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/dxc-danny/superpowers-cn/tree/main/skills/writing-skills
Command: npx skills add https://github.com/dxc-danny/superpowers-cn --skill writing-skills-dxc-danny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured blueprint for creating, editing, and validating Claude Skills, ensuring consistent frontmatter, documentation, and testing discipline across skill definitions.

Core Features & Use Cases

  • Helps define a reusable Skill template with mandatory YAML frontmatter (name and description) and a well-organized body that explains when to use the Skill and how to test it.
  • Guides the progressive disclosure approach: organizing content into core sections with optional references, scripts, and assets to be loaded on demand.
  • Enables rigorous Skill validation via TDD-inspired workflows, including red-green-refactor cycles and obstacle handling to prevent rationalizations.

Quick Start

Draft a SKILL.md with the required YAML frontmatter and a brief description, then test the Skill using a baseline scenario to verify observability and compliance.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write a Claude Skill with YAML frontmatter?▼

To write a Claude Skill, draft a SKILL.md file containing mandatory YAML frontmatter with name and description fields, followed by a structured body explaining when to use the Skill and how to test it.

What is progressive disclosure in skill development?▼

Progressive disclosure in skill development organizes content into core sections with optional references, scripts, and assets loaded on demand, ensuring Claude retrieves deeper guidance only when needed.

How do I validate Claude Skills using TDD workflows?▼

Validate Claude Skills using TDD-inspired workflows by running red-green-refactor cycles on baseline scenarios, verifying observability and compliance while handling obstacles to prevent rationalizations.

What should be included in Claude Skill documentation?▼

Claude Skill documentation should include mandatory YAML frontmatter, a clear trigger description explaining when to use the Skill, core content sections, and optional references for deeper guidance.

Do I need dependencies to create a Claude Skill template?▼

No dependencies are required to create a Claude Skill template. You only need to draft a SKILL.md file with the required YAML frontmatter and test it against a baseline scenario.

Why does my Claude Skill fail validation tests?▼

Claude Skill validation fails when the SKILL.md lacks required frontmatter, misses a clear trigger description, or bypasses TDD red-green-refactor cycles, preventing proper observability and compliance verification.

Related Skills

Explore More Content & Communication Skills→
openproseopenprose
1.7k

open-prose

Validate OpenProse Skill Units with mandatory SKILL.md and YAML frontmatter metadata.

Official
Advanced
dsifrydsifry
60

writing-skills

Automates Skill creation by applying test-driven development to SKILL.md documentation.

Community
Advanced
hetsheth-droidhetsheth-droid

writing-skills

Write and validate SKILL.md documentation using a TDD-based workflow.

Community
Advanced
I-OnlabsI-Onlabs
3

writing-skills

Automate SKILL.md creation and verification with TDD-inspired practices.

Community
Advanced