使い方ガイドへスキップ
ux-writing作者 content-designer

UX Writing スキル。

Claude Code と Codex 向けの UX リサーチスキル:ユーザー中心でアクセシブルなマイクロコピー(ボタン、ラベル、エラー、フォーム、オンボーディング)を作成します。

  • UX & Research
content-designer/ux-writing-skill · SKILL.mdSKILL.md
--- name: ux-writing description: Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and … --- ## When to Use This Skill ## Core UX Writing Principles ## UX Text Patterns ## Voice and Tone ## Editing Process ## Workflow
2026-09-14 に上流ファイルから読み込まれたフロントマターとセクション見出し · 全 15,313 文字

01 できること

Claude CodeおよびCodexにおいてux-writingスキルが行うこと

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

デジタルプロダクトにおけるマイクロコピーの作成と編集のための実践ガイドです。ボタン、ラベル、タイトル、エラーメッセージ、通知、フォーム、オンボーディング、空状態、成功メッセージ、ヘルプテキストを対象とします。すべての文字列は、目的性・簡潔性・会話性・明確性という4つの品質基準に照らして判断され、要素タイプごとにパターンが用意されています。例えばボタンには[動詞][対象]、

エラーには[理由・文脈]。[何をすべきか]。というパターンがあります。ボイスは固定されたブランドの個性として扱われ、トーンはユーザーの状態(不満、混乱、自信、慎重、成功)に応じて変化します。このスキルには、アクセシビリティのルール、研究に基づいた文章・文字数のベンチマーク、4段階の編集プロセス、そしてボイスチャート、コンテンツのユーザビリティ、Figma MCPに関する参照ファイルが含まれます。

生成されるもの

  • ボタン、ラベル、エラーメッセージ、通知、フォームなど、インターフェース上のコピーそのもの。
  • references/voice-chart-template.mdを用いて作成される、ブランドコンセプトをボイスの特徴に対応付け、良い例・悪い例を示すプロダクトボイスチャート。
  • templates/error-message-template.md(効果的なエラーメッセージのための入力可能なテンプレート)から作成されるエラーメッセージ。
  • templates/onboarding-flow-template.mdから設計されたオンボーディングフローで、明確なオンボーディング体験のためのフレームワークです。
プロンプト例を見る ↗

仕組み

  1. 01
    文脈から始める

    最初のステップは、下書きを始める前に、ユーザーの目標、事業目標、技術的制約、そしてユーザーの感情的な状態を理解することです。

  2. 02
    発話から書き起こす

    まず口に出して言う内容から始め、その要素のパターンを適用し、声とトーンを検討した上で、重要な情報を先頭に配置します。

  3. 03
    順序立てた4回の編集パスで仕上げる

    このファイルは4つの段階を順番に実行するよう定めています。目的性、簡潔性、対話性、明瞭性の各段階で、それぞれ独自の確認項目があります。

  4. 04
    その場の状況にトーンを合わせる

    トーンはユーザーの感情状態(不満、混乱、自信、慎重、成功)に応じて調整されますが、声は一貫して保たれます。

  5. 05
    テストと測定

    チームでレビューし、可能であればユーザーテストを行い、意見よりもタスク完了率と理解度を測定します。

02 適合性を確認

ux-writing Skill をいつ使うか

この種の UX リサーチが仕事である場合、Claude Code または Codex で ux-writing skill を使用してください。適合性と制限事項は、スキル自身のファイルから取得されています。

適している場合

  • ボタン、ラベル、タイトル、メッセージ、フォームなど、インターフェース要素のための新規コピーを書くこと。
  • すでに公開済みだが読みにくいUXテキストを編集すること。
  • 画面をまたいだ一貫性と使いやすさについて、プロダクトのコンテンツを監査すること。
  • 状況を説明し、回復を促すエラー、通知、成功メッセージを書くこと。
  • プロダクトの声とトーンを確立すること、またはオンボーディングや対話型フローを設計すること。

境界を知る

  • ChatGPTでは動作しません — このファイルには、Codex CLI/IDEで実行されること、そしてChatGPTはスキルをインストールまたは使用できないことが記載されています。
  • 「何らかの問題が発生しました」のような曖昧な失敗説明は、避けるべきものとして挙げられています。
  • 深刻な文脈では、過度に凝ったユーモアは禁止です。

提供すべきもの

  • ユーザーの感情状態とリスクの大きさトーンは、ユーザーがどう感じているか、どれほどのリスクがあるかによって選ばれます — 低リスクなテーマ変更とアカウント削除では読み方が異なります。
  • アクセシビリティ上の制約その要素において視覚的な文脈だけで十分か、それとも支援技術のために明示的なラベルやARIAラベルが必要かどうか。

03 スキルの内部

ux-writing スキルがClaude CodeとCodexに与えるルール

SKILL.md がエージェントに設定する 8 つの具体的な指示・既定値・制限 — 結果を変える部分です。

  1. 40〜60文字の行

    インターフェーステキストの行は、このファイルが定める読みやすさの上限である40〜60文字に収めるべきです。

  2. ボタン: 2〜4語

    ボタンやCTAのラベルは2〜4語とし、6語を上限とします。

  3. 対象読者に応じた平易な言葉

    一般向けには中学1年生程度、専門的な文脈では高校1年生程度の読解レベルで記述してください。

  4. 85%は能動態で書く

    コピーの約85%は能動態にしてください。

  5. エラーは固定された順序で伝える

    エラーコピーは、何が失敗したか、次にその理由や状況、最後に何をすべきかの順で記述します。

  6. ユーザーを非難しない

    エラーコピーは、読む人を非難せずに問題を伝えます。

  7. 色だけに意味を持たせない

    意味は色だけで伝えず、視覚的な指標には必ずテキストを併記します。

  8. エラーメッセージ: 12〜18語

    解決策を含むエラーメッセージは、12〜18語の範囲に収めます。

04 実際に使う

Claude Code または Codex に ux-writing をインストールする

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex またはお使いのエージェントに ux-writing を追加する

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

SKILL.md用の汎用skills CLI形式です。リポジトリによっては独自のパスを文書化している場合があります。

スキルに最初の UX リサーチタスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
Write the microcopy for our [checkout] flow: the payment button label, the field labels, and the message a user sees when their card is declined. The user will be frustrated, so keep the tone empathetic and give a clear next step. Then run the four-phase edit and flag any line over 60 characters.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • コピーを声に出して読み、実際にそのように言うかどうかを確認します。
  • 文章を読みやすさ判定ツールに通します。ファイル名はHemingway EditorとFlesch-Kincaidスコアリングです。
  • 理解度のベンチマークを確認します。8語以下で理解度100%、14語以下で理解度90%を読み取ります。
  • UXテキストの品質を評価するために付属しているチェックリスト、references/content-usability-checklist.mdを実施します。
  • 好みではなく、タスク完了率と理解度を測定しながら、チームによるレビューとユーザーテストを行います。
  • アクセシビリティのため、スクリーンリーダーがエラーとフィールドラベルを一緒に読み上げるように構造化されていることを確認します。

OpenDesignではSKILL.mdリンクからux-writingをインポートします: Plugins → Add → Skill → Import from link。その後、トップバーで選択してください。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

スキルファイル
SKILL.md 検証時にコンテンツチェックサムを記録;コミット 98cacde
License
MIT LICENSE より。
リポジトリスター数
168 GitHub スナップショットは 2026-09-14 に content-designer/ux-writing-skill リポジトリ全体について取得されました。ux-writing の評価や使用数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

SKILL.md の中身

  1. このスキルを使用するタイミングインターフェースのコピー、メッセージ、対話フロー、ボイス、コンテンツの監査を書く・編集する際の6つのトリガーです。
  2. UXライティングの基本原則4つの品質基準に加え、簡潔さ、明確さ、対話的なトーン、ユーザー中心の実践です。
  3. UXテキストのパターンタイトル、ボタン、4種類のエラー、成功メッセージ、空の状態、フォーム、通知に関するフォーマットと例です。
  4. 声とトーン一貫した声を築きつつ、ユーザーの感情状態やコンテンツの種類によってトーンを変化させます。
  5. 編集プロセス目的性・簡潔さ・会話らしさ・明確さという順序立てられた4つのパス。それぞれに確認すべき質問があります。
  6. ワークフローコンテキストを理解し、ドラフトを作成し、4つのフェーズを通じて反復的に編集を行い、その後テストと測定を行います。
  7. UXライティングにおけるアクセシビリティスクリーンリーダー、認知面、マルチモーダル、プレインランゲージの要件を、良し悪しのパターン例とともに解説します。
  8. UXテキストのベンチマーク要素ごとの文数・文字数の目安、理解率、リーディングレベル、テストツールを紹介します。
  9. 避けるべきよくある間違い受動態や汎用的なラベルから、アクセシブルでないリンクテキストまで、11のアンチパターンを紹介します。
  10. クイックリファレンスセンテンスケース、命令形のボタン、ユーザー中心の視点、具体的な動詞、フロントローディングに関する一行の注意事項です。
  11. リソースアクセシビリティガイド、声のチャート、ユーザビリティチェックリスト、パターン例、テンプレート、Figma連携を含む、出力される9つのファイルです。
スキル自身による説明
"デジタルプロダクトのためのユーザー中心でアクセシブルなインターフェースコピー(マイクロコピー)を作成します。ボタン、ラベル、エラーメッセージ、通知、フォーム、オンボーディング、空状態、成功メッセージ、ヘルプテキストなどが含まれます。アプリ、ウェブサイト、ソフトウェアインターフェースに表示されるテキストの作成または編集、会話フローの設計、ボイス&トーンガイドラインの策定、一貫性とユーザビリティのためのプロダクトコンテンツ監査、UI 文字列のレビュー、既存のインターフェースコピーの改善を行う際に使用します。目的性、簡潔性、会話性、明瞭性という 4 つの品質基準に基づく UX ライティングのベストプラクティスを適用します。アクセシビリティガイドライン、リサーチに基づくベンチマーク(文の長さ、理解率、読解レベル)、拡張エラーパターン、トーン適応フレームワーク、包括的な参考資料が含まれます。"

SKILL.md からの前付け説明文です。完全なファイルは約15,313文字です。GitHub で完全なファイルを読む

06 インストールする前に

ux-writing スキルに関するよくある質問

回答は 2026-09-14 時点で読んだ SKILL.md に基づくもので、記録された実行結果によるものではありません。

このスキルはどのエージェントで実行できますか?

Claude、Codex、Cursor、そしてエージェントスキル仕様をサポートするその他のエージェント向けに書かれています。ChatGPTは明示的に除外されており、スキルをインストールしたり使用したりすることはできません。

既存のコピーに対して使用できますか?

はい。このスキルは、既存のUXテキストの編集、UI文字列のレビュー、一貫性とユーザビリティのためのプロダクトコンテンツの監査もカバーしており、ゼロからの執筆だけに限りません。

アクセシビリティはカバーされていますか?

はい。アクセシブルなライティングは独立した項目として扱われており、スクリーンリーダーの最適化、認知アクセシビリティ、マルチモーダルコミュニケーション、プレインランゲージをカバーし、WCAG AAの色コントラスト最低基準4.5:1にも触れています。

UX Writing

実際のUXリサーチタスクで ux-writing を実行します。

OpenDesign をダウンロードし、SKILL.md リンクから ux-writing をインポートし、上記のプロンプトを貼り付けて、結果の前に計画を確認してください。

ターミナル
npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

OpenDesign デスクトップ版

ひとつのデザインシステムで、すべての制作物をブランドらしく

完全な Vibe Design Workspace で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

  • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
  • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
  • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
無料ダウンロード

macOS と Windows に対応