使い方ガイドへスキップ
ux-copy作者 Anthropic

UX Copy スキル。

Claude Code と Codex 向けの UX リサーチスキル:UX コピー(マイクロコピー、エラーメッセージ、空の状態、CTA)を作成またはレビューします。

  • UX & Research
anthropics/knowledge-work-plugins · design/skills/ux-copy/SKILL.mdSKILL.md
--- name: ux-copy description: Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text. --- ## Usage ## What I Need From You ## Principles ## Copy Patterns ## Voice and Tone ## Output
2026-09-14 に上流ファイルから読み込まれたフロントマターとセクション見出し · 全 3,424 文字

01 できること

ux-copy スキルが Claude Code と Codex で行うこと

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

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

スキル自身の言葉で

インターフェーステキストに対するライティングまたはレビューのパス:マイクロコピー、エラーメッセージ、空状態、CTA、確認ダイアログ、ツールチップ、ローディング状態、オンボーディングを対象とします。画面またはフロー、ユーザーが達成しようとしていることとその感情、トーンと文字数制限を指定すると、各要素に対する推奨文言と、トーンと最適な使用場面を示した3つの代替案、根拠、ローカライズ上の注意点を返します。

この機能の特徴は、自由形式の提案ではなく固定の構造を適用する点です。エラーは「何が起きたか」+「なぜか」+「どう直すか」、空状態は「これは何か」+「なぜ空なのか」+「どう始めるか」、ダイアログはアクションとその結果を明示します。コネクタを使えば、ブランドボイスの参照やFigma内のフロー読み取りが可能です。

生成されるもの

  • 画面内で名前付けされた各要素に対する推奨文言
  • 選択肢A、B、Cそれぞれのトーンと使用すべき場面を示した代替案テーブル
  • そのコピーがそのユーザーコンテキストにおいて効果的である理由を説明する短い根拠
  • 避けるべき慣用句、文字数の増加、文化的コンテキストを指摘するローカライズ上の注意点
プロンプト例を見る ↗

仕組み

  1. 01
    まずコンテキストを収集する

    ライティングを始める前に、画面、フロー、または機能と、その時点でユーザーが達成しようとしていることと感じていることを確認します。

  2. 02
    5つの原則でコピーを検証する

    明確、簡潔、一貫性、有用、人間らしさ——提案されるすべての文言はこのフィルターを通過する必要があります。

  3. 03
    要素をそのパターンに合わせる

    CTA、エラーメッセージ、空状態、確認ダイアログ、ツールチップ、ローディング状態、オンボーディングにはそれぞれ独自のルールがあり、Copy Patternsセクションで定義されています。

  4. 04
    状況に応じてトーンを調整する

    成功、エラー、警告、ニュートラルの各状態には、単一のハウスボイスではなく、それぞれ異なるレジスターが割り当てられます。

  5. 05
    テンプレート化された出力を返す

    各要素の推奨コピー、3つの選択肢を示した代替案テーブル、根拠、そして翻訳者向けのローカライズ上の注意点です。

02 適合性を確認

ux-copy Skill を使用するタイミング

この種の UX リサーチを行う場合は、Claude Code または Codex で ux-copy skill を使用してください。適用範囲と制限は skill 自体のファイルから取得しています。

適している場合

  • CTAの命名、確認ダイアログの文言作成、空状態の記入、オンボーディングテキストの作成
  • 平易な言葉での書き直しが必要な決済失敗エラー:「決済が拒否されました。お客様の銀行がこのカードでの決済を拒否しました。
  • ブランドボイスガイドがすでに文書化されているプロダクトで、コピーをそれに合わせて調整できる
  • Figmaでデザインしている画面で、フローとレイアウト上の制約が可視化されている
  • 翻訳される予定で、慣用句、文字数の増加、文化的コンテキストに関する注意点が必要な文言

境界を知る

  • コンテキストを推測することはありません。画面またはフロー、ユーザーの状態、トーン、制約を指定する必要があります。
  • ブランドボイスの参照とFigma画面のコンテキスト取得は、それらのコネクタが実際に接続されている場合のみ機能します。
  • ツールチップには構造や例のない単一行のガイダンスのみが提供されます。

提供すべきもの

  • トーンフォーマル、親しみやすい、遊び心のある、または安心感を与える口調など、ブランドボイスの説明です。
  • 制約文言の範囲を定める文字数制限やプラットフォームのガイドラインです。
  • レビューの場合はコピー自体この呼び出しは、書き起こしの元となるコンテキスト、またはレビュー対象のコピーのいずれかを受け取ります。

03 スキルの内部

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

SKILL.mdがエージェントに設定する7つの具体的な指示、デフォルト、制限 — ファイルの中で結果を変える部分です。

  1. エラーメッセージは3つの要素で構成されます

    何が起きたか、なぜ起きたか、どう直すかの順で構成します。

  2. 空の状態は3つの要素で構成されます

    これが何か、なぜ空なのか、どう始めればよいかを伝えます。

  3. 確認画面ではアクションを明示します

    「本当に実行しますか?」のような汎用的な表現ではなく、「3件のファイルを削除しますか?」のように、タイトルで実際の問いを述べます。

  4. ボタンにはアクションをラベル付けします

    ボタンには実行内容の動詞を載せます。「OK」/「キャンセル」ではなく「ファイルを削除」/「ファイルを保持」のようにします。

  5. CTAは動詞から始めます

    ラベルは動詞で始め、具体的にします。結果がラベルと一致するように、「送信」ではなく「アカウントを作成」とします。

  6. 一つの概念に一つの用語

    インターフェース全体で、同じ概念には同じ言葉を使います。

  7. オンボーディングは一度に一つの概念だけ

    オンボーディングの文言は、最初にすべてを説明するのではなく、段階的開示を用います。

04 実際に使う

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

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

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

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

Terminal
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill ux-copy

design/skills/ux-copy/SKILL.md 用の汎用的な skills CLI 形式です。リポジトリ側で独自のパスが定められている場合があります。

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

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

Starter prompt
Write copy for the [checkout] screen. The user just tried to pay and their card was declined, so they are frustrated and need to know what to do next. Tone should be empathetic but not wordy, and the retry button has a [20] character limit on [iOS].

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

最初の結果を確認

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

  • 各行の語数を確認し、意味を完全に伝えつつ最も短いバージョンを選びます。
  • すべての単語について、ユーザーが目的を達成する助けになっているかを問います。
  • 読み込み中の文言が、単に回転するだけでなく、期待値を設定し不安を軽減しているかを確認します。
  • 結果を共有したブランドボイスと比較し、ユーザーの感情状態に合わせて調整します。
  • 与えたコンテキストが十分具体的だったか、例えば単に「エラーメッセージ」ではなく失敗条件を明示していたかを再確認します。

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

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

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

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

Author
Anthropic
スキルファイル
design/skills/ux-copy/SKILL.md 検証時にコンテンツチェックサムを記録、コミット 8f877b6
License
Apache-2.0 LICENSE より。
リポジトリスター数
24,012 anthropics/knowledge-work-plugins リポジトリ全体の GitHub スナップショット(2026-09-14 取得)。このカタログには 7 つのスキルが含まれています。ux-copy の評価や使用回数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

SKILL.md の中身

  1. 使い方呼び出し方法:コンテキストまたはコピーを引数とするスラッシュコマンド
  2. 必要な入力提供すべき4つの入力:コンテキスト、ユーザーの状態、トーン、制約
  3. 原則すべての文言が備えるべき5つの特質:明確、簡潔、一貫性、有用、人間的
  4. コピーパターンCTA、エラー、空の状態、ダイアログ、ツールチップ、ローディング、オンボーディングごとのルール
  5. ボイスとトーン成功、エラー、警告、通常時にトーンがどう変化するか
  6. 出力Markdownテンプレート:推奨コピー、代替案の表、根拠、ローカライズに関する注記
  7. コネクタが利用可能な場合接続されたナレッジベースやデザインツールがコピーに何を追加するか
  8. ヒントコンテキストを具体的に伝える、ブランドボイスを共有する、感情的な状態を考慮する
スキル自身による説明
「UX コピーを作成またはレビューします — マイクロコピー、エラーメッセージ、空の状態、CTA。「~のコピーを書いて」「このボタンには何と書くべき?」「このエラーメッセージをレビューして」で起動、または CTA の命名、確認ダイアログの文言作成、空の状態の記述、オンボーディングテキストの作成時に使用します。」

SKILL.md のフロントマター説明。完全なファイルは約 3,424 文字です。GitHub で完全なファイルを読む。

06 インストールする前に

ux-copyスキルに関する質問

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

既存のブランドボイスをそのまま使えますか?

ナレッジベースのコネクタが接続されている場合のみ、あなたのブランドボイスガイドラインとコンテンツスタイルガイドを取得し、既存のコピーパターンと用語を確認します。それ以外の場合は、リクエスト内でトーンを説明してください。

具体的に何が返されますか?

「UX Copy」というタイトルのMarkdownブロックに、コンテキスト、各要素の推奨文言、トーンと最適な用途をタグ付けした3つの代替案の表、根拠、翻訳者向けのローカライズに関する注記が含まれます。

実際の画面を見てもらえますか?

デザインツールのコネクタが接続されている場合、Figma上で画面のコンテキストを確認してユーザーフロー全体を理解し、デザインから文字数制限やレイアウトの制約を確認します。それがない場合は、フローを言葉で説明してください。

UX コピー

実際の UX リサーチタスクで ux-copy を実行する

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

ターミナル
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill ux-copy

OpenDesign デスクトップ版

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

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

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

macOS と Windows に対応