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.