writing-skills

An agent skill by obra, from obra/superpowers. Tags: api, developer-tools, documents.

What it does

Use when creating new skills, editing existing skills, or verifying skills work before deployment

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

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

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/obra/superpowers
cp -r superpowers/skills/writing-skills ~/.claude/skills/writing-skills

Safety box score

Not rated yet. A safety box score grades what a skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. Anyone can request one from this page; it is saved for everyone. How the score works.

Source

Repository

obra/superpowers (all skills from this repository)

Path

skills/writing-skills/SKILL.md

Branch

main

Updated

2026-09-19

Related skills

• code-documenter — Generates, formats, and validates technical documentation — including docstrings, OpenAPI/Swagger specs, JSDoc annotations, doc portals, and user guides.
• deprecation-and-migration — Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another.
• documentation-and-adrs — Records decisions and documentation.
• intended-vs-implemented — The method for finding the gap between what a system is supposed to do and what the code actually does — the class of bug generic scanners miss because they.
• shipping-artifacts — The durable documentation set that makes an AI-built (vibe-coded) app reviewable before shipping.
• source-driven-development — Grounds every implementation decision in official documentation.