Clear Writing
Refines prose into professional, punchy communication by applying classical composition principles and eliminating linguistic clutter.
The source repository doesn't declare a license. Check its terms before reusing the code.
Key features
- Prunes filler words, jargon, and stock metaphors to improve clarity
- Optimizes sentence structure and variety while keeping paragraphs concise
- Enforces active voice and positive phrasing for stronger impact
- Applies classical grammar and composition rules for professional prose
- Eliminates em dashes and bullet points to favor stronger narrative flow
Use cases
- Drafting technical documentation, README files, and reports
- Writing professional commit messages and pull request descriptions
- Crafting user-facing UI copy, error messages, and help text
FAQ
What does the Clear Writing skill do?
This skill transforms technical prose into sharp, professional communication. It applies classical grammar rules, enforces the active voice, and removes linguistic clutter like jargon and filler words to ensure your text is punchy and highly readable.
How does it improve my developer workflow?
It automates the editing process for non-code assets. By ensuring your explanations, reports, and documentation are clear and concise from the start, you reduce communication friction and improve project maintainability.
When should I use this skill?
Use it whenever you are writing text intended for human readers. This includes README files, technical documentation, git commit messages, pull request descriptions, error messages, and UI copy.
What specific composition rules does it follow?
It adheres to Strunk & White’s classical principles: omitting needless words, using positive phrasing, and keeping related words together. It also optimizes sentence variety while strictly limiting paragraph length to keep readers engaged.
Does this skill work for non-technical writing?
Yes. While it excels at technical documentation, its focus on 'The Elements of Style' makes it perfect for any professional prose, including reports, summaries, and internal status updates where clarity is paramount.
Related skills
Word Document Generator
Generates professional Microsoft Word documents with rich text formatting, complex tables, and structured layouts using automated code execution.
Learning Documentation29712 ptsSemantic Line Breaks
Applies semantic line breaks to prose, such as comments and commit messages, to improve readability and maintainability.
Learning Documentation1112 ptsFrontend Implementation Plan
Creates comprehensive, production-ready frontend implementation plans for any UI screen or feature.
Learning Documentation12 pts