skills.rest
ether-moon
ether-moonCOMMUNITY
Explore all skills by this author →
GitHub

writing-clear-prose

Refine professional non-fiction prose for clarity, concision, and persuasiveness.

Updated Nov 9, 2025
Search Tags:#writing#editing#clarity#drafting#style-guide#technical-writing#revision
One-click install
npx skills add https://github.com/ether-moon/skill-set --skill writing-clear-prose
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-clear-prose
Source: https://github.com/ether-moon/skill-set/tree/main/plugins/skill-set/skills/writing-clear-prose
Command: npx skills add https://github.com/ether-moon/skill-set --skill writing-clear-prose

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps professionals and technical writers create and improve non-fiction prose by removing vagueness, reducing filler, and ensuring structure and persuasiveness so documents communicate reliably to readers with no prior context.

Core Features & Use Cases

  • Drafting workflow: Step-by-step outline, context-zero drafting, and document-type templates for explanatory text, persuasive proposals, and technical documentation.
  • Revising workflow: Four-pass revision checklist (structure, clarity, style, consistency) with concrete diagnostics and a section-by-section feedback pattern.
  • Principles and safeguards: Enforces concreteness, transcreation, steel-manning of counter-arguments, and brevity; includes anti-pattern catalogs and troubleshooting guidance.
  • Use cases: Draft a proposal that convinces stakeholders, revise a technical spec for clarity and implementability, or convert verbose reports into scannable summaries.

Quick Start

Revise the following draft to improve clarity, conciseness, and concreteness while applying the four core principles and return the revised text plus a short changelog of edits.

Frequently Asked Questions about writing-clear-prose

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

FAQPage Schema
How do I revise a technical report for clarity and conciseness?▼

To revise a technical report for clarity, apply a four-pass revision process that checks structure, clarity, style, and consistency. This removes vagueness and filler while ensuring factual concreteness and professional tone.

What is the best way to draft a persuasive proposal for stakeholders?▼

Drafting a persuasive proposal requires a structured workflow starting with an outline, followed by context-zero drafting, and applying steel-man argumentation to counter-arguments to ensure the document communicates reliably to readers with no prior context.

How do I convert verbose reports into scannable summaries?▼

Converting verbose reports into scannable summaries involves enforcing brevity and factual concreteness through a section-by-section feedback pattern. This refines professional non-fiction prose by removing filler and improving structure.

Does this prose revision process enforce a specific style guide?▼

The prose revision process enforces a structured drafting workflow and core principles of concreteness, transcreation, and consistency. It includes anti-pattern catalogs and troubleshooting guidance to maintain a clear, professional style.

Can I use this to improve technical documentation for implementability?▼

Yes, you can improve technical documentation for implementability by applying the four-pass revision checklist. It refines technical specs by verifying structure, style, and factual concreteness to ensure reliable communication.

Related Skills

Explore More Content & Communication Skills→
eKoh951eKoh951

product-marketing-context

Draft and manage a reusable product marketing context document in .claude/product-marketing-context.md.

Community
Advanced
hxk622hxk622
8

ppt_generation

Generate presentation slides from text using the Marp Markdown engine.

Community
Advanced
Norman-Norman-NormanNorman-Norman-Norman
7

editor

Analyze documentation text for grammar, style, and factual accuracy.

Official
Basic
Mathews-TomMathews-Tom
310

doc-condenser

Condense technical documentation into developer-focused specifications with file paths and code samples.

Community
Intermediate