writing-clearly-and-concisely — Claude Code plugin: prose checks
writing-clearly-and-concisely — a Claude Code plugin that improves prose quality in documentation, commit messages, error messages, and UI text. Runs whenever you write text that people will read.
MIT ★ 2,707 updated 2026-03-05
/plugin marketplace add softaworks/agent-toolkit
/plugin install writing-clearly-and-concisely@agent-toolkitWhat writing-clearly-and-concisely does
The plugin integrates with Claude Code and activates when you write prose for humans—READMEs, commit messages, error text, code explanations. It checks for clarity and brevity: unnecessary words, vague phrasing, mismatched tone.
Inside are rules for clean writing: no corporate jargon, no filler phrases, no vague formulations that slow readers down. It catches the bureaucratic language and filler that creeps into technical writing.
What it helps with
- remove jargon and filler from documentation
- make commit messages shorter and clearer
- ensure error messages are readable
- simplify explanations and code comments
Example prompts for the agent
- Check this documentation for clarity and length
- Help me rewrite the error message so users understand it
- Does this explanation sound natural?
How to install writing-clearly-and-concisely
Plugin marketplace
/plugin marketplace add softaworks/agent-toolkit/plugin install writing-clearly-and-concisely@agent-toolkitStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about writing-clearly-and-concisely
How do I install writing-clearly-and-concisely in Claude Code?
Run /plugin marketplace add softaworks/agent-toolkit, then /plugin install writing-clearly-and-concisely@agent-toolkit.
What does the writing-clearly-and-concisely plugin do?
It reviews prose written for readers—documentation, commit messages, error text, explanations. It flags clichés, redundant words, and unclear phrasing.
What kinds of text does it check?
Any text meant for humans: READMEs, commit messages, error messages, comments, code explanations, UI copy, and reports.
Source text
writing-clearly-and-concisely · MIT
Use when writing prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Skills: skills/writing-clearly-and-concisely
© softaworks · MIT · softaworks/agent-toolkit