clear-writing

Remove hedging and filler phrases from professional and technical writing.

11|2|Updated May 29, 2025
One-click install
npx skills add https://github.com/yulonglin/dotfiles --skill clear-writing-yulonglin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clear-writing
Source: https://github.com/yulonglin/dotfiles/tree/main/claude/local-marketplace/plugins/writing-toolkit/skills/clear-writing
Command: npx skills add https://github.com/yulonglin/dotfiles --skill clear-writing-yulonglin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clear writing eliminates hedging, filler, and low-clarity language in technical and professional communications, helping readers understand intent quickly.

Core Features & Use Cases

  • Encourages concise, direct voice with active constructions
  • Guides removal of hedging phrases and padding in papers, blogs, emails, and reports
  • Provides patterns and checklists to improve tone, structure, and readability for research and professional writing

Quick Start

Provide a clear, direct rewrite of a draft by removing hedging phrases and unnecessary padding.

Frequently Asked Questions about clear-writing

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

FAQPage Schema
How do I remove hedging and filler phrases from technical writing?

Remove hedging and filler phrases from technical writing by applying anti-hedging checklists and active-voice preference to draft concise, direct communications. This process eliminates overly cautious language, ensuring your papers, blogs, and reports are easy to understand.

What is clear writing and why does it matter for professional communication?

Clear writing is the elimination of hedging, filler, and low-clarity language in professional communication. It matters because it helps readers understand intent quickly, applying tone, structure, and word choice guidelines to ensure consistent readability across reports and emails.

How do I rewrite an email draft to be more concise and direct?

Rewrite an email draft to be concise and direct by removing unnecessary padding and applying active-voice preference. Use signposting patterns to improve structure and tone, ensuring your professional communications are straightforward and easy to understand.

Can I use clear-writing guidelines for research papers and technical reports?

Yes, you can use clear-writing guidelines for research papers and technical reports. The approach applies anti-hedging checklists, active-voice preference, and signposting patterns across papers, blogs, emails, and reports to ensure consistent readability and professional tone.

What is the best way to improve readability and tone in technical documentation?

The best way to improve readability and tone in technical documentation is applying style-guide patterns, word choice guidelines, and active-voice preference. This removes overly cautious language and padding, resulting in concise, direct documentation that is easy to understand.

When should I avoid using active voice in professional writing?

You should avoid active voice in professional writing when the doer of the action is irrelevant or unknown, though the clear-writing approach strongly prefers active constructions to eliminate overly cautious language, filler, and padding across your drafts.