ux-writing について
明確で簡潔なインターフェース文言を書くためのスキルです。CTA、エラーメッセージ、空状態、確認ダイアログのパターンに加え、状況に応じたトーンの調整方法を示します。
主な機能
- 01明確で簡潔かつ一貫した文言の原則
- 02操作を具体的に示す CTA ラベル
- 03原因と対処法を含むエラーメッセージ
- 04空状態と確認ダイアログのパターン
- 05成功、エラー、警告、中立のトーン指針
活用シーン
- 01画面操作を示す具体的なラベルを作成
- 02エラーの原因と解決方法を説明
- 03次の操作を案内する空状態を作成
- 04確認操作の結果を明確に伝える
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ anthropics/ knowledge-work-plugins --skill ux-writingインストール後、Claude Code で/ux-writingを入力して読み込まれたか確認します。
詳細
UX ライティング
明確で簡潔、そして役に立つインターフェースの文言を書きます。
原則
- 明確に:伝えたいことをそのまま伝えます。専門用語や曖昧な表現は避けます。
- 簡潔に:意味を十分に伝えるために必要な最小限の言葉を使います。
- 一貫性を保つ:同じものには、常に同じ用語を使います。
- 役立つ内容に:すべての言葉が、ユーザーの目的達成に役立つようにします。
- 人間らしく:ロボットではなく、親切な人のように書きます。
文言のパターン
CTA
- 動詞から始めます:「無料トライアルを開始」「変更を保存」「レポートをダウンロード」
- 具体的にします:「送信」ではなく「アカウントを作成」
- ラベルを操作の結果に合わせます
エラーメッセージ
構成:何が起きたか+理由+解決方法
- 「お支払いが拒否されました。カードが発行会社によって拒否されました。別のカードをお試しいただくか、カード発行会社にお問い合わせください。」
空の状態
構成:これは何か+空である理由+開始方法
- 「プロジェクトはまだありません。最初のプロジェクトを作成して、チームとの共同作業を始めましょう。」
確認ダイアログ
- 操作を明確にします:「本当に実行しますか?」ではなく「3 個のファイルを削除しますか?」
- 結果を説明します:「この操作は取り消せません」
- ボタンには操作を示すラベルを付けます:「OK」/「キャンセル」ではなく「ファイルを削除」/「ファイルを残す」
ボイスとトーン
状況に合わせてトーンを調整します。
- 成功:喜びを表しつつ、大げさにならないようにします
- エラー:共感を示し、解決に役立つ内容にします
- 警告:明確で、次の行動につながる内容にします
- 中立:情報を簡潔に伝えます
コメント
Markdown 対応