writing-clearly-and-concisely

What problem does it solve?

Unclear, verbose, or grammatically incorrect writing hinders communication, especially in technical documentation, commit messages, and reports. This skill applies William Strunk Jr.'s timeless writing rules to any human-readable prose, making it clearer, stronger, and more professional.

Core Features & Use Cases

• Strunk's Rules Application: Guides the user to apply principles like "Use active voice," "Put statements in positive form," "Omit needless words," and "Use definite, specific, concrete language."
• Context-Aware Copyediting: Provides a strategy for using a subagent to copyedit drafts even when context is tight, optimizing token usage.
• Versatile Prose Improvement: Applicable to documentation, commit messages, error messages, UI text, reports, and any other written explanation.
• Use Case: Before publishing a technical blog post, submitting a critical report, or writing important user-facing error messages, use this skill to automatically copyedit your draft, ensuring it is clear, concise, and professional.

Quick Start

When context is tight, dispatch a subagent:

1. Write your draft using judgment.

2. Dispatch a subagent with your draft and elements-of-style.md.

3. Have the subagent copyedit and return the revision.