skills.rest
l-lin
l-linCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

clear-writing

Rewrite prose for clarity and conciseness using elementary rules of usage and composition.

17|2|Updated Dec 27, 2013
Search Tags:#writing#tone#editing#clarity#prose
One-click install
npx skills add https://github.com/l-lin/dotfiles --skill clear-writing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clear-writing
Source: https://github.com/l-lin/dotfiles/tree/main/home-manager/modules/share/ai/.config/ai/skills/clear-writing
Command: npx skills add https://github.com/l-lin/dotfiles --skill clear-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps rewrite prose to be clearer, more concise, and professional, saving time on editing and improving communication.

Core Features & Use Cases

  • Rewrite for clarity: Improve sentence structure and readability.
  • Conciseness and tone: Shorten, adjust tone for the target audience.
  • UI/docs/commit messages: Improve error messages, documentation, and descriptions.

Quick Start

Provide the text you want rewritten and, optionally, a desired tone or length. The model will return a cleaned, concise version.

Frequently Asked Questions about clear-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve clarity in technical documentation and README files?▼

Rewrite prose for clarity by applying active voice, concrete language, and short paragraphs. This skill restructures sentences for readability, removes needless words, and places emphatic ideas at the end to make documentation more accessible to readers.

Can I use this to make commit messages and error messages more concise?▼

Yes. This skill shortens and refines commit messages, error messages, and UI copy by eliminating redundancy and adjusting tone for your audience, resulting in clearer, more professional communication.

What's the best way to edit prose for both clarity and tone?▼

Provide your text and optionally specify desired tone or length. The skill returns a rewritten version applying elementary composition rules—active voice, positive form, related words grouped together—tailored to your target audience.

How does active voice and concrete language improve writing?▼

Active voice clarifies who performs actions; concrete language replaces vague terms with specific details. Together they reduce ambiguity and make prose more direct, helping readers understand your intent faster.

Does this work with reports and technical explanations?▼

Yes. This skill applies to any human-facing prose including reports and technical explanations, enhancing readability by condensing content, eliminating jargon, and structuring information for clarity.

Related Skills

Explore More Content & Communication Skills→
2lab-ai2lab-ai

using-govuk

Apply GOV.UK style guide and GDS content design principles to written content.

Official
Intermediate
hwj123hwjhwj123hwj
4

edit-article

Restructure article sections and rewrite prose for readability.

Community
Advanced
jayteealaojayteealao

every-style-editor

Review editorial content against Every's style guide for grammar and punctuation.

Community
Basic
ConnectiveTCSConnectiveTCS

editor

Correct grammar, refine style, and improve clarity in written content.

Community
Basic