error-recovery-prompts

daishiman's avatarfrom daishiman

エラー復旧プロンプトの設計と改善を専門とするスキル。ユーザーがエラーから回復するための効果的なガイダンスを提供。Anchors:- The Pragmatic Programmer / 適用: エラーハンドリング原則 / 目的: 回復可能なエラー処理- Nielsen Norman Group UX Guidelines / 適用: エラープロンプト設計 / 目的: ユーザビリティ向上Trigger:Use when designing error recovery flows, creating user-friendly recovery prompts, implementing retry mechanisms, or improving error handling UX.error recovery, recovery prompt, retry, user guidance, error handling UX

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026
[UI Copy and Microcopy]

When & Why to Use This Skill

This Claude skill specializes in the strategic design and optimization of error recovery prompts and user flows. By integrating industry-standard UX guidelines from the Nielsen Norman Group with pragmatic error-handling principles, it empowers developers and designers to transform technical failures into clear, actionable guidance. The skill focuses on minimizing user frustration, preventing data loss, and maintaining workflow continuity through high-quality microcopy and structured recovery mechanisms.

Use Cases

  • Designing intuitive error messages for web and mobile applications that provide clear 'next-step' actions rather than vague technical codes.
  • Developing multi-tiered recovery strategies, such as automated retries, page refreshes, and manual support escalations, to ensure users never hit a dead end.
  • Optimizing error-handling UX to preserve user input and progress during transient system failures or connectivity issues.
  • Auditing existing application prompts to ensure compliance with usability standards and accessibility best practices for error state communication.
  • Creating standardized templates for error notifications that maintain a helpful, non-blaming brand tone while providing technical clarity.
nameerror-recovery-prompts
description|
- The Pragmatic Programmer / 適用エラーハンドリング原則 / 目的: 回復可能なエラー処理
- Nielsen Norman Group UX Guidelines / 適用エラープロンプト設計 / 目的: ユーザビリティ向上

Error Recovery Prompts

概要

エラー復旧プロンプトの設計と改善を専門とするスキル。 ユーザーがエラーから回復するための効果的なガイダンスを提供し、フラストレーションを最小化する。

ワークフロー

Phase 1: 復旧フロー設計

目的: エラータイプに応じた復旧フローを設計

アクション:

  1. エラータイプと発生シナリオを分析
  2. 自動/手動回復の可能性を判断
  3. 段階的な復旧オプションを設計
  4. プロンプト文言を作成

Task: agents/design-recovery-flow.md を参照

Phase 2: プロンプト実装

目的: 設計に基づき復旧プロンプトを実装

アクション:

  1. テンプレートを選択
  2. プロンプトコンポーネントを実装
  3. アクセシビリティを確保
  4. アニメーション/進捗表示を実装

Phase 3: 検証と記録

目的: 復旧フローの動作確認

アクション:

  1. 各エラーシナリオをテスト
  2. ユーザビリティを確認
  3. scripts/log_usage.mjs で記録

Task仕様ナビ

Task 起動タイミング 入力 出力
design-recovery-flow 設計時 エラーシナリオ 復旧フロー設計書

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

復旧プロンプトの基本原則

1. 明確なアクション提示

ユーザーが次に何をすべきかを明確に示す。

悪い例: "エラーが発生しました" 良い例: "エラーが発生しました。[再試行]ボタンをクリックしてください"

2. 段階的な回復オプション

1. 再試行 (最も簡単)
2. ページを更新
3. サポートに問い合わせ (最後の手段)

3. 進捗の保持

可能な限りユーザーの入力/進捗を保持する。

ベストプラクティス

すべきこと

  • 復旧オプションをボタンで明示
  • 自動リトライには進捗表示を追加
  • データロスを防止（自動保存）
  • キーボードショートカットをサポート
  • フォーカス管理（プロンプトにフォーカス）

避けるべきこと

  • 復旧方法なしでエラーを表示
  • 無限リトライ
  • ユーザーを責める表現
  • 技術的詳細の露出

リソース参照

agents/（Task仕様書）

Task パス 用途
復旧フロー設計 See agents/design-recovery-flow.md フロー設計

references/（詳細知識）

リソース パス 用途
プロンプトパターン See references/recovery-prompt-patterns.md パターンカタログ

scripts/（決定論的処理）

スクリプト 用途 使用例
log_usage.mjs フィードバック記録 node scripts/log_usage.mjs --result success

assets/（テンプレート）

テンプレート 用途
recovery-prompt-template.md 復旧プロンプトテンプレート

変更履歴

Version Date Changes
2.0.0 2026-01-01 18-skills.md仕様完全準拠、agents追加、Level1-4削除
1.0.0 2025-12-24 初版作成