writing-clearly

Apply Strunk's Elements of Style rules to tighten prose drafts.

9|1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/lmorchard/decafclaw --skill writing-clearly-lmorchard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-clearly
Source: https://github.com/lmorchard/decafclaw/tree/main/contrib/skills/writing-clearly
Command: npx skills add https://github.com/lmorchard/decafclaw --skill writing-clearly-lmorchard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps writers tighten prose by applying William Strunk Jr.'s The Elements of Style (1918) rules to drafts, improving clarity and concision.

Core Features & Use Cases

  • Delegated planning: a clean-context child agent produces a structured edit plan describing exact substitutions or rewrites.
  • Deterministic application: tool code applies each plan entry to the draft by replacing the specified before text with the after text, first match only.
  • Safe preservation: technical terms, code, links, and quoted material are preserved verbatim, with an auditable edit history.
  • Use cases include polishing documentation, commit messages, READMEs, replies, and blog posts.

Quick Start

Provide a draft inline to be edited, and optionally a focus, then run the tool to obtain the tightened revision.

Frequently Asked Questions about writing-clearly

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

FAQPage Schema
How do I tighten prose and improve clarity in my drafts?

To tighten prose, you can apply Strunk's Elements of Style rules to your drafts. This generates a structured edit plan of exact substitutions and rewrites to improve concision.

Can I use Strunk's rules to edit technical documentation and commit messages?

Yes, applying Strunk's rules works for technical documentation and commit messages. The process preserves technical terms, code, links, and quoted material verbatim while tightening the surrounding prose.

What is the best way to copy-edit a blog post without losing formatting?

The best way to copy-edit without losing formatting is using a deterministic application process. A planner generates targeted text substitutions, replacing only the first match to safely preserve your original formatting and terminology.

How do I apply Elements of Style revisions to a draft automatically?

You apply Elements of Style revisions by providing your draft text and optionally a focus area. A delegated child agent produces an edit plan, which tool code then deterministically applies to generate the tightened revision.

Does editing prose with Strunk's rules preserve technical terms and code blocks?

Editing prose with Strunk's rules does preserve technical terms and code blocks verbatim. The process ensures safe preservation of code, links, and quoted material while maintaining an auditable edit history of all changes.

What are the limitations of using Strunk's Elements of Style for prose editing?

A limitation of using Strunk's Elements of Style is that substitutions apply to the first match only. The deterministic application relies on a structured edit plan, meaning complex structural rewrites may require manual review afterward.