Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wanderingspirit03/clear-writing-skill --skill clear-writing -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/clear-writing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/clear-writing/

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.

Similar skills

All skills for Writing and docs →

Project sponsors

Companies that keep this analytics open