writing-skills
Test-driven documentation for creating reusable agent techniques, patterns
by obraFree
Description
writing-skills is an agent skill from Jesse Vincent's (obra) Superpowers collection, listed on skills.sh. It applies test-driven development to writing skills: write pressure scenarios, watch an agent fail without the skill, write the skill, watch the agent comply, then close loopholes. It covers where skills live in Claude Code, Codex, Copilot CLI and Gemini CLI. A skill is a SKILL.md file of instructions (sometimes with scripts and reference notes) that an AI agent loads only when a task calls for it, so the agent knows the steps to follow and what to avoid. It is free and open source.…
Highlights
- Test-driven skill writing
- Pressure scenarios with subagents
- Works across Claude Code, Codex and Gemini CLI
Ratings & Reviews
No ratings yet
Be the first to rate writing-skills.
People also visit
diagnosing-superpowers
A superpowers session went wrong and your human partner wants to know why
writing-skills FAQ
What does the writing-skills skill do?
It applies test-driven development to writing skills: write pressure scenarios, watch an agent fail without the skill, write the skill, watch the agent comply, then close loopholes.
How do I install the writing-skills skill?
Run: npx skills add https://github.com/obra/superpowers --skill writing-skills
Is it free?
Yes. It is free and open source.
What is an agent skill?
A SKILL.md file of instructions, sometimes with scripts and reference notes, that an AI agent such as Claude Code loads when a task needs it, so it handles that task the same careful way every time.
What are the best writing-skills alternatives?
Popular alternatives to writing-skills include skill-creator, clawhub and diagnosing-superpowers. See all writing-skills alternatives