readable-content について
コンテンツ設計者やライター向けの読みやすさ設計スキルです。情報の順序、内容の分割、明快な文章の指針を示し、読者の把握を助けます。
主な機能
- 01重要な情報を先に配置
- 02話題や段落ごとに内容を分割
- 03見出しやリストで一覧性を向上
- 04短く具体的な文を使用
- 05手順・エラー・データ向けの指針
活用シーン
- 01長い説明文を再構成
- 02ウェブコンテンツを読み取りやすく整理
- 03明確な手順やエラーメッセージを作成
- 04データの説明を理解しやすくする
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ owl-listener/ inclusive-design-skills --skill readable-contentインストール後、Claude Code で/readable-contentを入力して読み込まれたか確認します。
詳細
読みやすいコンテンツの設計
さまざまな読解力、集中力、認知スタイルを持つ人が、必要な情報を見つけて理解できるように、コンテンツを構成し、執筆します。
基本原則
人は文章を読むのではなく、ざっと目を通します。まず、ざっと目を通して内容を把握できるように設計し、次に読み込めるようにしましょう。
コンテンツの構成
逆ピラミッド型
最も重要な情報を最初に配置します。読者がいつ読むのをやめてもよいように構成します。
- 段落 1:主なメッセージまたは回答
- 段落 2:欠かせない補足情報
- 段落 3 以降:背景、文脈、詳細
チャンク化
- 1 つのセクションにつき 1 つのトピック
- 1 つの段落につき 1 つの考え
- 1 段落は最大 3~4 文
- 新しい見出しを設けるまでの段落数は、1 セクションあたり最大 5~7 段落
- 2~3 段落ごとに見出しを設け、長い文章のかたまりを分割します
ざっと目を通して把握できる要素
- セクションの内容を要約する、説明的な見出し
- 重要な用語の太字(控えめに使いましょう。すべてが太字だと、何も目立ちません)
- 3 つ以上の関連項目には箇条書き(1 つのリストにつき最大 7 項目)
- 比較情報には表
- 重要な情報には囲み枠やコールアウト
読みやすさを考慮した執筆
文のレベル
- 1 文あたり 15~20 語を目安にします
- 1 文につき 1 つの考えを伝えます
- 能動態を使います。「ご注文を発送します」は、「ご注文が発送されます」よりも明確です
- 具体的な表現を使います。「まもなく」ではなく「3 営業日以内に」とします
- 読者に直接語りかけます。「ユーザーはできます」ではなく「あなたはできます」とします
単語のレベル
- 意味を損なわない範囲で、最も簡単な言葉を使います
- 専門用語は初出時に定義します
- 頭字語は初出時に正式名称を示します。「Web Content Accessibility Guidelines(WCAG)」のように記載します
- 慣用句、比喩、文化に特有の表現は避けます
- 二重否定は避けます。「進めないことはありません」ではなく「続行できます」とします
段落のレベル
- 要点を最初の文に置きます(先頭に結論を示します)
- 続く文では、説明や根拠を加えます
- 段落単独で意味が通じるようにし、前の段落を読まないと理解できない構成は避けます
- 「ただし」「たとえば」「つまり」などのつなぎ言葉を使うと、文章が読みやすくなります
特定の配慮が必要なコンテンツ
手順とハウツー
- 順番に行う作業には番号付きの手順を使います
- 1 つの手順につき 1 つの操作を示します
- 各手順は動詞で始めます。「クリックする」「入力する」「選択する」など
- 各手順の後に、ユーザーに表示される内容を記載します
ポリシー、利用規約、法的コンテンツ
- 冒頭に平易な言葉で概要を示します
- 詳細を必要とする人向けに、その下に全文を記載します
- 法律用語はすべて、文脈に沿って定義します
- 抽象的な概念を説明するには、例を使います
エラーと警告に関するコンテンツ
- 発生したこと(具体的に)
- ユーザーにとっての意味
- 次に行うこと(明確な操作を 1 つ)
- 常に小学校 4~6 年生向けの読みやすさにします
データと数値
- 正確さが不要な場合は、数値を丸めます(1,987,453 ではなく約 200 万)
- 文脈を添えます。「40%、つまりほぼ半分」のように示します
- 複雑なデータには、テキストによる要約を添えたグラフを使います
- 読者が数値を理解できるとは限りません。数値が何を意味するかを説明します
評価のための質問
- 最も重要な情報を最初に示していますか?
- 見出しと太字のテキストだけをざっと見た人でも、要点を把握できますか?
- 1 文の平均は 20 語未満ですか?
- すべての段落が 4 文未満ですか?
- 小学校 8 年生程度の読解力がある人なら理解できますか?
コメント
Markdown 対応