---
id: gh-writing-clearly-and-concisely
name: "writing-clearly-and-concisely"
url: https://skills.yangsir.net/skill/gh-writing-clearly-and-concisely
author: obra
domain: writing
tags: ["writing", "style", "clarity", "conciseness", "editing"]
install_count: 2100
rating: 4.30 (120 reviews)
github: https://github.com/obra/the-elements-of-style/tree/main/skills/writing-clearly-and-concisely
---

# writing-clearly-and-concisely

> 基于Strunk的经典写作规则，本技能帮助你将任何面向人类阅读的文本（如文档、提交信息、报告、UI文本）变得更清晰、更简洁、更专业，有效提升沟通效率和信息传达准确性。

**Stats**: 2,100 installs · 4.3/5 (120 reviews)

## Before / After 对比

### 提升写作清晰度与专业性

**Before**:

撰写文档、报告或UI文本时，内容常显冗长、模糊，读者难以快速理解核心信息，导致沟通效率低下，甚至产生误解。

**After**:

运用Strunk写作原则，文本变得简洁、有力、专业，读者能迅速抓住要点，大幅提升沟通效率和信息传达的准确性。

| Metric | Before | After | Change |
|---|---|---|---|
| 理解时间 | 60分钟 | 15分钟 | -75% |

## Readme

# Writing Clearly and Concisely

## Overview

William Strunk Jr.'s *The Elements of Style* (1918) teaches you to write clearly and cut ruthlessly.

**WARNING:** `elements-of-style.md` consumes ~12,000 tokens. Read it only when writing or editing prose.

## When to Use This Skill

Use this skill whenever you write prose for humans:

- Documentation, README files, technical explanations
- Commit messages, pull request descriptions
- Error messages, UI copy, help text, comments
- Reports, summaries, or any explanation
- Editing to improve clarity

**If you're writing sentences for a human to read, use this skill.**

## Limited Context Strategy

When context is tight:
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

## All Rules

### Elementary Rules of Usage (Grammar/Punctuation)
1. Form possessive singular by adding 's
2. Use comma after each term in series except last
3. Enclose parenthetic expressions between commas
4. Comma before conjunction introducing co-ordinate clause
5. Don't join independent clauses by comma
6. Don't break sentences in two
7. Participial phrase at beginning refers to grammatical subject

### Elementary Principles of Composition
8. One paragraph per topic
9. Begin paragraph with topic sentence
10. **Use active voice**
11. **Put statements in positive form**
12. **Use definite, specific, concrete language**
13. **Omit needless words**
14. Avoid succession of loose sentences
15. Express co-ordinate ideas in similar form
16. **Keep related words together**
17. Keep to one tense in summaries
18. **Place emphatic words at end of sentence**

### Section V: Words and Expressions Commonly Misused
Alphabetical reference for usage questions

## Bottom Line

Writing for humans? Read `elements-of-style.md` and apply the rules. Low on tokens? Dispatch a subagent to copyedit with the guide.


---
*Source: https://skills.yangsir.net/skill/gh-writing-clearly-and-concisely*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-writing-clearly-and-concisely/markdown*