writing-skills

Create and test Skills using a RED-GREEN-REFACTOR workflow with YAML frontmatter.

2|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/anortham/razorback --skill writing-skills-anortham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/anortham/razorback/tree/main/skills/writing-skills
Command: npx skills add https://github.com/anortham/razorback --skill writing-skills-anortham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing Skills document processes the creation and validation of agent skills using a test-driven approach, ensuring documentation drives correct behavior before deployment.

Core Features & Use Cases

  • Structured SKILL.md with mandatory frontmatter and concise body, enabling principled skill design, testing, and iteration.
  • RED-GREEN-REFACTOR workflow application to guard against rationalizations and ensure continuous improvement.
  • Progressive disclosure and maintainable organization with optional references/resources to keep payloads small.

Quick Start

Draft the SKILL.md with frontmatter and concise body, then run baseline tests to ensure failure without the skill and success with it.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create agent skills using a test-driven approach?

To create agent skills using a test-driven approach, draft a SKILL.md with mandatory YAML frontmatter and a concise body, then run baseline tests to ensure failure without the skill and success with it.

What is the RED-GREEN-REFACTOR workflow for skill validation?

The RED-GREEN-REFACTOR workflow for skill validation applies test-driven principles across discovery, validation, and deployment phases to guard against rationalizations and ensure continuous improvement of agent skills.

How do I structure a SKILL.md file for deployment readiness?

Structure a SKILL.md file for deployment readiness by including mandatory YAML frontmatter with name and description, a concise self-contained body, and optional scripts, references, or assets for progressive disclosure.

Why does my skill documentation need baseline testing before deployment?

Skill documentation needs baseline testing before deployment to ensure correct behavior is driven by the documentation, reducing rationalizations and improving consistency across the creation and validation phases.

Can I use optional references and assets to keep skill payloads small?

Yes, you can use optional references and assets to maintain progressive disclosure and keep payloads small, ensuring the core SKILL.md remains self-contained while supporting maintainable organization.