writing-skills

Document how to create Claude Skills using test-driven development and SKILL.md validation checklists.

1|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/pianzhu/my-claude-skills --skill writing-skills-pianzhu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/pianzhu/my-claude-skills/tree/main/skills/writing-skills
Command: npx skills add https://github.com/pianzhu/my-claude-skills --skill writing-skills-pianzhu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill documents how to create Claude Skills using test-driven development to ensure verifiable quality.

Core Features & Use Cases

  • Guides Skill creation with TDD patterns, frontmatter constraints, and deployment checklists.
  • Teaches how to structure SKILL.md for discoverability and reusability.
  • Provides testing workflows and rationalization-tracking patterns to defend Skill quality.

Quick Start

Create a new SKILL.md for a skill and fill in YAML frontmatter with name and description, then outline the core sections as described.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I use test-driven development to create Claude Skills?

Test-driven development for Claude Skills involves writing tests before deployment to ensure verifiable quality. You structure SKILL.md files with YAML frontmatter, outline core sections, and apply testing workflows to validate skill patterns.

What is the best way to structure a SKILL.md file for discoverability?

Structuring a SKILL.md for discoverability requires adding YAML frontmatter with name and description, then outlining core sections. This approach conforms to frontmatter constraints and ensures reusable skill patterns for deployment.

How do I validate Claude Skills before deployment?

Validating Claude Skills before deployment requires applying testing workflows and deployment checklists. You use rationalization-tracking patterns to defend skill quality and ensure bulletproof, reusable skill patterns conform to guidelines.

Does writing Claude Skills require specific frontmatter constraints?

Writing Claude Skills requires conforming to frontmatter constraints, structured sections, testing workflows, and deployment checklists. You fill in YAML frontmatter with name and description to begin the skill authoring process.

Why should I use test-driven development for skill authoring?

Using test-driven development for skill authoring ensures verifiable quality and defends against deployment errors. It provides rationalization-tracking patterns that maintain bulletproof, reusable skill patterns throughout the skill lifecycle.

What goes into a deployment checklist for Claude Skills?

A deployment checklist for Claude Skills includes validating frontmatter constraints, verifying structured sections, running testing workflows, and confirming rationalization-tracking patterns. This ensures bulletproof skill quality before deployment.