ホーム/テクニカルライティング/writing-clearly-and-concisely
W

writing-clearly-and-concisely

by @obrav
4.3(120)

Strunkの時代を超越した執筆ルールを適用し、人間が読むあらゆる文章(ドキュメント、コミットメッセージ、エラーメッセージ、レポート、UIテキストなど)をより明確、簡潔、プロフェッショナルにします。コミュニケーション効率と情報伝達の精度を向上させます。

writingstyleclarityconcisenesseditingGitHub
インストール方法
npx skills add https://github.com/obra/the-elements-of-style --skill writing-clearly-and-concisely
compare_arrows

Before / After 効果比較

1 组
使用前

ドキュメント、レポート、UIテキスト作成時、内容が冗長で曖昧になりがちで、読者が核心を素早く理解するのが難しく、コミュニケーションの非効率性や誤解を招くことがあります。

使用後

Strunkの執筆原則を適用することで、テキストは簡潔で力強く、プロフェッショナルになります。読者は要点を素早く把握でき、コミュニケーション効率と情報伝達の正確性が大幅に向上します。

SKILL.md

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

  1. One paragraph per topic
  2. Begin paragraph with topic sentence
  3. Use active voice
  4. Put statements in positive form
  5. Use definite, specific, concrete language
  6. Omit needless words
  7. Avoid succession of loose sentences
  8. Express co-ordinate ideas in similar form
  9. Keep related words together
  10. Keep to one tense in summaries
  11. 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.

ユーザーレビュー (0)

レビューを書く

効果
使いやすさ
ドキュメント
互換性

レビューなし

統計データ

インストール数2.1K
評価4.3 / 5.0
バージョン
更新日2026年10月23日
比較事例1 件

ユーザー評価

4.3(120)
5
37%
4
43%
3
13%
2
5%
1
2%

この Skill を評価

0.0

対応プラットフォーム

🤖claude-code

タイムライン

作成2026年5月6日
最終更新2026年10月23日
🎁 Agent 知識カード
アンケート