writing-skills
Apply TDD principles to authoring, testing, and refactoring documentation-based skills for AI agents.
Install
npx skills add https://github.com/obra/superpowers --skill writing-skillsStats
| Total installs | 26,782 |
| Weekly installs | 26.5K |
| GitHub stars | 118.4K |
| First seen | Jan 19, 2026 |
| Source | @obra/superpowers |
Summary
- Write failing test scenarios first (baseline agent behavior without skill), then write minimal skill documentation to address specific violations, following RED-GREEN-REFACTOR cycle
- Skills live in agent-specific directories and must include YAML frontmatter (name, description), overview, core patterns, quick reference, and common mistakes sections
- Description field must start with "Use when..." and list only triggering conditions—never summarize workflow, as Claude may follow description instead of reading full skill content
- Requires understanding superpowers:test-driven-development; discipline-enforcing skills need explicit loophole closures and rationalization tables to resist workarounds under pressure
- Keep getting-started skills under 150 words, other frequently-loaded skills under 200 words total; use cross-references and tool help to compress token usage
Tags
Related skills
| Skill | Installs | vs writing-skills |
|---|---|---|
| baoyu-markdown-to-html | 12,459 | -14,323 |
| sales-enablement | 15,281 | -11,501 |
| azure-messaging | 132,663 | +105,881 |
| documentation-writer | 11,665 | -15,117 |
| competitor-alternatives | 25,883 | -899 |
FAQ
- How many installs does writing-skills have?
- writing-skills has 26,782 total installs and 26.5K installs this week.
- Where is writing-skills hosted?
- writing-skills is published by @obra/superpowers at https://github.com/obra/superpowers.
- How many GitHub stars does writing-skills have?
- writing-skills has 118.4K GitHub stars.
- When was writing-skills first indexed?
- OrangeBot.AI first indexed writing-skills on Jan 19, 2026.
- How do I install writing-skills?
- Run: npx skills add https://github.com/obra/superpowers --skill writing-skills