writing-skills — Skills — getagentictools

Requirements & configuration

Critical for discovery: Future agents need to FIND your skill

4. Token Efficiency (Critical)

Problem: getting-started and frequently-referenced skills load into EVERY conversation. Every token counts.

Why no @ links: @ syntax force-loads files immediately, consuming 200k+ context before you need them.

"Need to show information?" [shape=diamond];

Test-driven documentation for creating reusable agent techniques, patterns, and reference guides.

Source

Repository: https://github.com/obra/superpowers

writing-skills FAQ

What does the writing-skills skill do?

Use when creating new skills, editing existing skills, or verifying skills work before deployment Technique wasn't intuitively obvious to you You'd reference this again across projects

What does writing-skills require?

Critical for discovery: Future agents need to FIND your skill 4. Token Efficiency (Critical) Problem: getting-started and frequently-referenced skills load into EVERY conversation. Every token counts. Why no @ links: @ syntax force-loads files immediately, consuming 200k+ context before you need them. "Need to show information?" [shape=diamond];

How do I install writing-skills?

Run: npx -y skills add https://github.com/obra/superpowers --skill writing-skills --agent claude-code — the source lives at github.com/obra/superpowers.

Maintain writing-skills?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![writing-skills on getagentictools](https://getagentictools.com/badge/skills/obra-superpowers-writing-skills.svg)](https://getagentictools.com/skills/obra-superpowers-writing-skills?ref=badge)

npx agentictools info skills/obra-superpowers-writing-skills

The second line is the CLI lookup for this page — handy in READMEs and docs.