clear-writing — Claude Code skill: purpose and installation
The clear-writing Claude Code skill clarifies prose during drafting, editing, rewriting, and review. It targets sentences that feel dense, vague, or awkward.
no license ★ 67 updated 2026-11-06
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a claude-codeWhat clear-writing does
The skill revises sentences so their main actor and action are easier to spot. It brings key actions into verbs, keeps subjects close to verbs, and arranges information to connect with what came before. The writer’s meaning, qualifications, and emphasis stay intact.
It reads the passage first, tracks the ideas and relationships that must remain, then checks the revision against the original. During reviews, it separates necessary fixes from optional changes. The skill handles sentence-level clarity; it does not override subject-matter, legal, academic, or house-style requirements. A reference file, references/sentence-clarity.md, covers difficult cases.
What it helps with
- clarify overloaded sentences
- replace buried actions with specific verbs
- retain qualifications while rewriting prose
- offer a concrete revision for an unclear passage
Example prompts for the agent
- Edit this paragraph for clarity while preserving the writer’s meaning and uncertainty.
- Rewrite this passage so each action has a clear actor.
- Review this sentence and suggest a clearer order for its ideas.
How to install clear-writing
1Skills CLI (Vercel)
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a claude-code2Manually: put the files in place
~/.claude/skills/clear-writing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/clear-writing/
1Skills CLI (Vercel)
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a codex2Manually: put the files in place
.agents/skills/clear-writing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a cursor2Manually: put the files in place
.cursor/skills/clear-writing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wanderingspirit03/clear-writing-skill clear-writing2Manually: put the files in place
.github/skills/clear-writing/SKILL.md1Skills CLI (Vercel)
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a gemini-cli2Platform CLI
gemini skills install https://github.com/wanderingspirit03/clear-writing-skillManually: put the files in place
.devin/skills/clear-writing/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about clear-writing
How do I install clear-writing in Claude Code?
Run npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a claude-code. The skill file is at ~/.claude/skills/clear-writing/SKILL.md.
What does clear-writing do?
It revises or reviews unclear prose by clarifying the actor and action, improving information flow, and retaining the original meaning.
Does clear-writing replace subject-matter or legal requirements?
No. It focuses on sentence clarity and leaves subject-matter, legal, academic, and house-style requirements in force.