writing-clearly-and-concisely について
『The Elements of Style』に基づき、人が読む文章の執筆と編集を支援するスキルです。文法、文章構成、簡潔な表現を扱い、ドキュメントやメッセージ、説明文に活用できます。
主な機能
- 01文法と句読点の指針
- 02文章構成の原則
- 03能動的で具体的な表現
- 04冗長な語句の削減
活用シーン
- 01技術ドキュメントの編集
- 02コミットやプルリクエストの説明作成
- 03UI文言やエラーメッセージの改善
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/writing-clearly-and-conciselyを入力して読み込まれたか確認します。
同梱ファイルelements-of-style.md
詳細
明確かつ簡潔に書く
概要
William Strunk Jr. の The Elements of Style（1918年）は、明確に書き、容赦なく削る方法を教えてくれます。
警告： elements-of-style.md は約12,000トークンを消費します。文章を書くとき、または編集するときにだけ読んでください。
このスキルを使う場面
人が読む文章を書くときは、いつでもこのスキルを使ってください。
- ドキュメント、README ファイル、技術的な説明
- コミットメッセージ、プルリクエストの説明
- エラーメッセージ、UI の文言、ヘルプテキスト、コメント
- レポート、要約、その他あらゆる説明
- 明確さを高めるための編集
人が読む文を書くなら、このスキルを使ってください。
コンテキストが限られている場合の戦略
コンテキストに余裕がない場合：
- 判断に基づいて下書きを書きます
- 下書きと
elements-of-style.mdをサブエージェントに渡します - サブエージェントに文章を校正させ、修正版を返してもらいます
すべてのルール
基本的な用法のルール（文法・句読点）
- 単数形の所有格は 's を付けて作ります
- 列挙では最後の語を除き、各語の後にコンマを置きます
- 挿入句はコンマで囲みます
- 等位節を導く接続詞の前にコンマを置きます
- 独立節をコンマだけでつなげてはいけません
- 文を途中で分断してはいけません
- 文頭の分詞句は文法上の主語を修飾します
構成の基本原則
- 1つの段落では1つのトピックを扱います
- 段落はトピックセンテンスから始めます
- 能動態を使います
- 肯定形で述べます
- 明確で具体的な表現を使います
- 不要な語句を省きます
- まとまりのない文を続けないようにします
- 等位の概念は同じ形式で表します
- 関連する語句は近くに置きます
- 要約では時制を統一します
- 強調したい語句を文末に置きます
セクション V：よく誤用される語句や表現
用法に関する疑問を解決するためのアルファベット順のリファレンスです。
要点
人が読む文章を書きますか？elements-of-style.md を読み、ルールを適用してください。トークンが不足していますか？ガイドを使って校正するよう、サブエージェントに依頼してください。
コメント
Markdown 対応