🎯

writing-skills

🎯Skill

from obra/superpowers

What it does

Generates high-quality, context-aware writing across genres, optimizing tone, structure, and clarity for professional and creative communication.

Overview

A skill that applies test-driven development (TDD) methodology to writing AI agent skills. It teaches a systematic approach: write test scenarios, watch agents fail without the skill, write the skill, then verify agents comply.

Key Features

TDD-based methodology for creating reliable AI skills (RED-GREEN-REFACTOR cycle)
Pressure scenario testing with subagents to validate skill effectiveness
Patterns for writing reusable technique guides rather than one-time narratives
Loophole detection and skill refinement workflows

Who is this for?

Skill authors who want to create robust, well-tested skills for AI agents. The TDD approach ensures skills actually change agent behavior rather than just being documentation that gets ignored.

📦

Same repository

obra/superpowers(16 items)

📚 Related Resources

📝Superpowers: How I'm using coding agents in October 2025

blog.fsck.com

📰Simon Willison's Notes on Superpowers

simonwillison.net

writing-skills

Installation

Vibe Index InstallInstalls to .claude/skills/ - auto-recognized by Claude Code

npx vibeindex add obra/superpowers --skill writing-skills

skills.sh Install⚠ Installs to .agents/skills/ - may not be auto-recognized by Claude Code

npx skills add obra/superpowers --skill writing-skills

Manual InstallCopy SKILL.md content and save to the path below

~/.claude/skills/writing-skills/SKILL.md

SKILL.md

16,809Installs

43,383

AddedJan 31, 2026

View on GitHub Back to Skills

More from this repository10

🏪

obra-superpowers🏪Marketplace

Complete software development workflow framework for coding agents. Enforces structured processes — brainstorming, spec writing, TDD, subagent-driven development, and code review — turning AI agents into disciplined engineering teammates.

🎯

brainstorming🎯Skill

Generates structured, creative problem-solving frameworks with step-by-step ideation techniques, prioritization, and actionable innovation strategies.

🎯

systematic-debugging🎯Skill

Methodically diagnose and resolve complex software bugs using structured analysis, trace patterns, and strategic troubleshooting techniques.

🎯

test-driven-development🎯Skill

Guides developers in writing automated tests before code, ensuring robust, modular software design and catching bugs early in the development process.

🎯

writing-plans🎯Skill

Generates structured, actionable writing plans with clear goals, research strategies, outline templates, and milestone tracking for various document types.

🎯

requesting-code-review🎯Skill

Streamlines code review requests by generating structured feedback templates, tracking review status, and facilitating collaborative code improvement workflows.

🎯

using-superpowers🎯Skill

Streamlines integration and usage of superpowers framework, providing intuitive methods for defining, configuring, and applying advanced computational capabilities.

🎯

executing-plans🎯Skill

Transforms complex multi-step workflows into executable sequences with robust error handling, retry mechanisms, and intelligent task orchestration.

🎯

subagent-driven-development🎯Skill

Automates complex software development workflows by dynamically coordinating specialized AI subagents to break down and solve intricate programming tasks

🎯

receiving-code-review🎯Skill

Helps developers professionally receive, process, and learn from code review feedback to improve code quality and collaboration skills.