writing-skills agent skill by obra
Use when creating new skills, editing existing skills, or verifying skills work before deployment
Source and license
| Publisher | obra |
|---|---|
| Repository | obra/superpowers |
| License | MIT |
| Snapshot | 2026-10-22 |
| Last repository commit | 2026-10-09 |
| Instruction size | 3,795 words; 676 lines |
| Bundled files | 7 |
Suede Skill Check: 69/100 · D
Report snapshot · · graded-v2
The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.
Source revision: bb92a7774141. Report version e4aa9d01193f. Badge URLs follow the latest listing; save the report to keep this version.
Download report · Request a fresh review
What to review next
- Structural checks: 48 of 56 points. 8 points for each of the seven graded checks.
- Description length: 1 of 5 points. 5 for 150–600 characters; 3 for 100–900; 1 for 50–1,024.
- Boundary clause: 0 of 4 points. 4 when the description says when not to use the skill (“Not for …”, “Do not use …”, “Use … instead”).
Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.
| Component | Points earned | Available |
|---|---|---|
| Structural checks | 48 | 56 |
| Description length | 1 | 5 |
| Boundary clause | 0 | 4 |
| Example request | 0 | 3 |
| Instruction depth | 4 | 7 |
| Reference files | 0 | 3 |
| Bundled scripts | 0 | 2 |
| Recent maintenance | 9 | 9 |
| Curated-list citations | 7 | 7 |
| Tool permissions declared | 0 | 2 |
| Compatibility declared | 0 | 2 |
The published score is capped at 99. It measures the published files, documentation and maintenance signals. Security scan: not scanned. This assessment does not include a runtime test or a full installation-dependency review.
Install writing-skills
The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.
npx skills add https://github.com/obra/superpowers/tree/main/skills/writing-skillstmp="$(mktemp -d)"
git clone --depth 1 https://github.com/obra/superpowers.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/writing-skills .claude/skills/
rm -rf "$tmp"tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/obra/superpowers.git "$tmp/repo"
mkdir -p .agents/skills
cp -R "$tmp/repo/"skills/writing-skills .agents/skills/
rm -rf "$tmp"For a user-level install, copy the folder to ~/.claude/skills/ (Claude Code) or ~/.agents/skills/ (Codex). Inside Codex, $skill-installer can also fetch a skill from GitHub. New to skills? Read How to install agent skills in Claude Code, Codex and Cursor.
obra/superpowers is third-party code. Read SKILL.md and any bundled scripts before you install it.
Show the listing and raise the score
writing-skills is listed with 69/100 · D. This badge links to its Suede AI listing. Skills scoring 80–99 add a numeric and a letter quality shield; the largest open points for writing-skills are structural checks (8), boundary clause (4) and description length (4). Send your repository and the points you want to raise, then request a fresh review after updating the skill. Publishers: read How to get your agent skill found in search and cited by AI assistants.
[](https://suedeai.directory/obra/superpowers/writing-skills/)<a href="https://suedeai.directory/obra/superpowers/writing-skills/"><img src="https://suedeai.directory/badge.svg" alt="Suede AI Skills Directory: listed" height="20"></a>