writing-skills

Standardize SKILL.md creation with RED-GREEN-REFACTOR testing workflows.

Updated Jun 20, 2026
One-click install
npx skills add https://github.com/lowmason/agent-skills --skill writing-skills-lowmason
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/lowmason/agent-skills/tree/main/writing-skills
Command: npx skills add https://github.com/lowmason/agent-skills --skill writing-skills-lowmason

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This section explains the challenge of creating, validating, and maintaining Skills documentation that adheres to TDD discipline and robust deployment checks.

Core Features & Use Cases

  • TDD-driven Skill lifecycle (RED-GREEN-REFACTOR) with baseline testing, rationalization tables, red flags, and deployment checklist.
  • Progressive disclosure and modular structure guidance for SKILL.md, references, and tooling, to keep token usage efficient.
  • Metadata-driven discovery support: enforce frontmatter fields (name, description) and support for validation of Skill content before deployment.

Quick Start

Draft a new SKILL.md using the Skill pattern and run the RED-GREEN-REFACTOR testing workflow to verify it.

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 for Skill documentation?

Test-driven development for Skill documentation applies a RED-GREEN-REFACTOR workflow to author, validate, and refine SKILL.md files before deployment. This approach establishes baseline testing and rationalization tables to ensure documentation meets structural and content requirements.

What is the standard YAML frontmatter structure for a SKILL.md file?

The standard YAML frontmatter structure requires specific name and description fields to support metadata-driven discovery. Enforcing this frontmatter structure ensures that Skill content is properly validated and indexed before deployment across the skills repository.

How do I validate a Skill before deployment across a repository?

To validate a Skill before deployment, run the RED-GREEN-REFACTOR testing workflow to check YAML frontmatter, content structure, and deployment readiness. This process identifies red flags and verifies that all baseline tests pass before the Skill is merged.

How do I keep token usage efficient when editing existing SKILL.md files?

To keep token usage efficient when editing existing SKILL.md files, apply progressive disclosure and modular structure guidance. This technique separates core content from references and tooling, reducing the token load during the Skill authoring process.

What are rationalization tables and red flags in Skill authoring?

Rationalization tables and red flags are validation mechanisms within the TDD-driven Skill lifecycle. Rationalization tables document design decisions, while red flags highlight structural or content anomalies that fail baseline testing before deployment.