skills.rest
christopherarter
christopherarterCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

superpowers-writing-skills

Enforce a test-driven red-green-refactor workflow for creating and validating Reasonix skills.

90|5|Updated Jun 13, 2026
Search Tags:#testing#tdd#documentation#skill-development#frontmatter#skill-writing#reasonix
One-click install
npx skills add https://github.com/christopherarter/superpowers-reasonix --skill superpowers-writing-skills-christopherarter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: superpowers-writing-skills
Source: https://github.com/christopherarter/superpowers-reasonix/tree/main/skills/superpowers-writing-skills
Command: npx skills add https://github.com/christopherarter/superpowers-reasonix --skill superpowers-writing-skills-christopherarter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Difficult to create and maintain Reasonix skills without a repeatable, test-driven workflow that validates both content and behavior.

Core Features & Use Cases

  • Enforces a RED-GREEN-REFACTOR cycle for skill development.
  • Documents required frontmatter (name and description) and provides a structured body for operational instructions.
  • Supports optional references/scripts/assets to organize supporting materials.

Quick Start

Create a failing test scenario, implement the skill to satisfy it, and re-run tests in a subagent-enabled session.

Frequently Asked Questions about superpowers-writing-skills

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

FAQPage Schema
How do I use test-driven development for writing Reasonix skills?▼

Test-driven skill development for Reasonix uses a red-green-refactor cycle: create a failing test scenario, implement the skill to satisfy it, then re-run tests in a subagent-enabled session to validate behavior.

What frontmatter is required when creating a Reasonix skill?▼

Required Reasonix skill frontmatter demands strictly a name and description, followed by a Markdown body for operational instructions, ensuring structured organization and frontmatter validation.

How do I organize supporting files and scripts for skill development?▼

Skill development organizes supporting files into optional directories: scripts/ for executable resources, references/ for documentation, and assets/ for additional materials needed by the skill.

Can I validate both content and behavior when I edit Reasonix skills?▼

Yes, skill editing validates both content and behavior by enforcing a repeatable test-driven workflow that checks frontmatter structure and runs operational tests within a subagent-enabled session.

What is the best way to maintain skills without a repeatable testing workflow?▼

Maintaining skills without a repeatable workflow causes inconsistent validation; adopting a structured red-green-refactor cycle with frontmatter checks solves this by enforcing repeatable test-driven development.

Does skill writing work without subagent-enabled sessions?▼

Skill writing can author content without subagents, but the test-driven validation cycle requires a subagent-enabled session to execute and verify the failing test scenarios properly.

Related Skills

Explore More Software Engineering Skills→
withzombieswithzombies
80

writing-skills

Enforce a RED-GREEN-REFACTOR test-driven workflow for skill verification and documentation.

Community
Intermediate
gmliaogmliao
1

writing-skills

Create and validate Claude Skills through RED-GREEN-REFACTOR testing cycles.

Community
Advanced
xiongxianfeixiongxianfei
3

valid-basic

Validate SKILL.md existence and required frontmatter fields for structural tests.

Community
Basic
tgmarinhotgmarinho

writing-skills

Create AI agent skill documentation with test-driven development and discovery optimization.

Community
Advanced