mcpField
R
readable-content

readable-content

github.com/owl-listenerデザイン・UI10881 回インストール20 週間前に更新
リポジトリ

readable-content について

コンテンツ設計者やライター向けの読みやすさ設計スキルです。情報の順序、内容の分割、明快な文章の指針を示し、読者の把握を助けます。

主な機能

  1. 01重要な情報を先に配置
  2. 02話題や段落ごとに内容を分割
  3. 03見出しやリストで一覧性を向上
  4. 04短く具体的な文を使用
  5. 05手順・エラー・データ向けの指針

活用シーン

  1. 01長い説明文を再構成
  2. 02ウェブコンテンツを読み取りやすく整理
  3. 03明確な手順やエラーメッセージを作成
  4. 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. 最も重要な情報を最初に示していますか?
  2. 見出しと太字のテキストだけをざっと見た人でも、要点を把握できますか?
  3. 1 文の平均は 20 語未満ですか?
  4. すべての段落が 4 文未満ですか?
  5. 小学校 8 年生程度の読解力がある人なら理解できますか?

コメント