writing-skills

Create SKILL.md templates enforcing a TDD workflow for Skill lifecycle.

91|4|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/prime-radiant-inc/serf --skill writing-skills-prime-radiant-inc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/prime-radiant-inc/serf/tree/main/agent/skills/writing-skills
Command: npx skills add https://github.com/prime-radiant-inc/serf --skill writing-skills-prime-radiant-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing disciplined Skill documentation that enforces a test-driven development workflow for creating, editing, and validating SKILL.md files.

Core Features & Use Cases

  • Enforces YAML frontmatter with name and description and a concise one-line description
  • Provides a TDD-inspired workflow (RED-GREEN-REFACTOR) for Skill creation and maintenance
  • Guides progressive disclosure, risk mitigation, and quality assurance in Skill docs
  • Supports reviews and testing procedures before deployment to productionSkill catalogs

Quick Start

Create a new SKILL.md following the TDD-driven structure described here.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write Skill documentation using a TDD workflow?▼

To write Skill documentation using a TDD workflow, apply a RED-GREEN-REFACTOR cycle to SKILL.md files, enforcing structured YAML frontmatter, progressive disclosure, and quality assurance before deployment.

What is test-driven development for process documentation?▼

Test-driven development for process documentation applies a RED-GREEN-REFACTOR cycle to SKILL.md files, ensuring metadata validation and quality assurance before deployment to a production Skill library.

What sections are required in a SKILL.md file?▼

Required sections in a SKILL.md file include YAML frontmatter with name and description, plus the body sections 'What problem...', 'Core Features & Use Cases', and 'Quick Start' to ensure complete documentation.

Does this Skill documentation template require dependencies or components?▼

No, this Skill documentation template requires no dependencies or components, allowing you to independently create, edit, and validate SKILL.md files before deployment across a Skill library.

What's the best way to validate Skill metadata before deployment?▼

The best way to validate Skill metadata before deployment is using a TDD-inspired workflow that enforces YAML frontmatter rules, toxicity checks, and structured body sections for quality assurance across the Skill library.