skills.rest
bluefishs
bluefishsCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Enforce test-driven documentation for creating and verifying skills with SKILL.md structure.

Updated Dec 30, 2025
Search Tags:#tdd#documentation#process#skill-authoring#writing-skills#rationalizations
One-click install
npx skills add https://github.com/bluefishs/CK_Missive --skill writing-skills-bluefishs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/bluefishs/CK_Missive/tree/main/.claude/skills/_shared/shared/superpowers/writing-skills
Command: npx skills add https://github.com/bluefishs/CK_Missive --skill writing-skills-bluefishs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing skills currently suffer from inconsistent structure and verification gaps. This guide provides a concise, test-driven approach to creating and maintaining Skills documentation so it is reusable, auditable, and battle-tested.

Core Features & Use Cases

  • Enforces RED-GREEN-REFACTOR style workflow for skill creation and edits
  • Supplies a minimal, self-contained SKILL.md structure with frontmatter and guidance
  • Includes references and templates to speed up authoring and standardize quality across Skills
  • Use Cases: creating new Skills, editing existing Skills, and validating Skills before deployment

Quick Start

Ensure the SKILL.md frontmatter exists and write a concise guide that follows the required sections.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create a SKILL.md file with the correct YAML frontmatter?▼

To create a SKILL.md file, you must include YAML frontmatter specifying the skill name and description. A minimal, self-contained structure with a three-section guide enforces consistent documentation and standardizes quality across skills.

What is the test-driven approach for skill authoring?▼

The test-driven approach for skill authoring applies a RED-GREEN-REFACTOR cycle to create and verify skills. This enforces a disciplined workflow that makes documentation reusable, auditable, and battle-tested before deployment across Claude-like agents.

How do I verify existing skills before deploying them to agents?▼

You verify skills before deployment by applying a robust testing framework using the RED-GREEN-REFACTOR cycle. This validates edits and ensures the SKILL.md structure meets required standards for Claude-like agents.

Why does my skill documentation lack consistency and verification?▼

Skill documentation lacks consistency due to missing structural enforcement and verification gaps. Applying a test-driven guide with required YAML frontmatter and a standardized three-section SKILL.md structure resolves these issues.

Do I need any dependencies to start writing skills with test-driven guidance?▼

No dependencies are required to start writing skills. You simply need to ensure the SKILL.md frontmatter exists and write a concise guide that follows the required sections to begin the test-driven authoring workflow.

Can I use this test-driven workflow to edit existing skills?▼

Yes, you can use this test-driven workflow to edit existing skills. It enforces the RED-GREEN-REFACTOR style workflow during edits, ensuring updates maintain the required YAML frontmatter and three-section SKILL.md structure.

Related Skills

Explore More Content & Communication Skills→
spacholski1225spacholski1225
2

Writing Skills

Apply test-driven development to create and verify SKILL.md documentation.

Community
Advanced
quazfentonquazfenton

terminaluse

Automate agent creation, deployment, and interaction via the TerminalUse tu CLI.

Community
Intermediate
hyperbolic-chyperbolic-c
5

requirement-parser

Parse YAML frontmatter from Markdown requirement files and validate required fields.

Community
Intermediate
riddopicriddopic

writing-skills

Guide AI skill creation with a RED-GREEN-REFACTOR testing cycle.

Community
Advanced