error-handling-ux

error-handling-ux is a skill for Claude Code from Infrasity-Labs/dev-gtm-claude-skills. It costs 16 tokens per session (398 once invoked), scanned A, a copy of error-handling-ux, MIT.

A guide for designing how interfaces prevent, detect, explain, and recover from errors. It covers messages, validation, retries, preserved input, and other ways to help people complete a task after something goes wrong.

In plain words
What is it for?
Use it to design form validation, network-error states, timeout handling, permission checks, retry flows, undo actions, and recovery paths.
Why use it?
It replaces vague error messages and dead ends with clear explanations and useful next steps. This reduces confusion and prevents users from losing their work.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

Part of the marketing-skills plugin — 116 skills, 8 commands, 23 agents, 1 hook shipped together , and of writing-skills

Good fit Use it to design form validation, network-error states, timeout handling, permission checks, retry flows, undo actions, and recovery paths.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/infrasity-labs/dev-gtm-claude-skills/error-handling-ux
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Infrasity-Labs/dev-gtm-claude-skills --skill error-handling-ux
Clone the repo
git clone --depth 1 https://github.com/Infrasity-Labs/dev-gtm-claude-skills

Made for: Claude Code.

Or install marketing-skills, the plugin that ships this one along with the rest of its 116 skills, 8 commands, 23 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for error-handling-ux

README.md
[![agentmods](https://agentmods.dev/badge/skills/infrasity-labs/dev-gtm-claude-skills/error-handling-ux/github.svg)](https://agentmods.dev/skills/infrasity-labs/dev-gtm-claude-skills/error-handling-ux)
Your own site
<a href="https://agentmods.dev/skills/infrasity-labs/dev-gtm-claude-skills/error-handling-ux"><img src="https://agentmods.dev/badge/skills/infrasity-labs/dev-gtm-claude-skills/error-handling-ux/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for error-handling-ux

Your own site · 80×15
<a href="https://agentmods.dev/skills/infrasity-labs/dev-gtm-claude-skills/error-handling-ux"><img src="https://agentmods.dev/badge/skills/infrasity-labs/dev-gtm-claude-skills/error-handling-ux.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 16 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 398 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 88% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00016 $0.00398
Opus 5 $0.00008 $0.00199
Sonnet 5 $0.00003 $0.00080
Haiku 4.5 $0.00002 $0.00040

Measured 8d ago against content hash 8f3b02122ed3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

error-handling-ux scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

88% identical to error-handling-ux — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.claude/skills/error-handling-ux/SKILL.md · 50 lines

What it actually says

Error Handling UX

You are an expert in designing error experiences that prevent, detect, and help users recover from errors.

What You Do

You design error handling that minimizes frustration and helps users succeed.

Error Handling Hierarchy

1. Prevention

  • Inline validation before submission
  • Smart defaults and suggestions
  • Confirmation dialogs for destructive actions
  • Constraint-based inputs (date pickers, dropdowns)
  • Auto-save to prevent data loss

2. Detection

  • Real-time field validation
  • Form-level validation on submit
  • Network error detection
  • Timeout handling
  • Permission and authentication checks

3. Communication

  • Clear, human language (not error codes)
  • Explain what happened and why
  • Tell the user what to do next
  • Place error messages near the source
  • Use appropriate severity (error, warning, info)

4. Recovery

  • Preserve user input (don't clear forms on error)
  • Offer retry for transient failures
  • Provide alternative paths
  • Auto-retry with backoff for network errors
  • Undo for accidental actions

Error Message Format

  • What happened: Brief, clear description
  • Why: Context if helpful
  • What to do: Specific action to resolve

Error States by Context

  • Forms: Inline per-field + summary at top
  • Pages: Full-page error with retry/back options
  • Network: Toast/banner with retry
  • Empty results: Helpful empty state with suggestions
  • Permissions: Explain what access is needed and how to get it

Best Practices

  • Never blame the user
  • Be specific (not just 'Something went wrong')
  • Maintain the user's context and data
  • Log errors for debugging
  • Test error paths as thoroughly as happy paths
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 50 lines · 16 tokens per session scan A 8f3b02122ed3

Subscribe to this mod's changes

error-handling-ux is a skill published in the GitHub repository Infrasity-Labs/dev-gtm-claude-skills (124 stars, last pushed 2mo ago), licensed MIT. It adds 16 tokens to every session and 398 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 88% identical to error-handling-ux, differing in 2 lines, and is treated as a copy.

Related

Other skills, from other repositories

sxo

Search Experience Optimization (SXO) — the bridge between SEO and UX/CRO. Audits the full journey from the SERP click to the on-page goal: SERP click-through factors (title/meta/rich results that win the click), then post-click experience signals that keep users and drive conversions — above-the-fold relevance and…

nowork-studio/notfair-plugin · 235 tokens

geo-audit

Full website GEO+SEO audit with parallel subagent delegation. Orchestrates a comprehensive Generative Engine Optimization audit across AI citability, platform analysis, technical infrastructure, content quality, and schema markup. Produces a composite GEO Score (0-100) with prioritized action plan.

techhorizonlabs/thl-open · 60 tokens

geo

GEO-first SEO analysis tool. Optimizes websites for AI-powered search engines (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations. Performs full GEO audits, citability scoring, AI crawler analysis, llms.txt generation, brand mention scanning, platform-specific…

techhorizonlabs/thl-open · 139 tokens

geo-brand-mentions

Brand mention and authority scanner for AI visibility. Analyzes brand presence across platforms that AI models rely on for entity recognition and citation decisions. Produces a Brand Authority Score (0-100) with platform-specific recommendations.

techhorizonlabs/thl-open · 49 tokens

geo-llmstxt

Analyzes and generates llms.txt files -- the emerging standard for helping AI systems understand website structure and content. Can validate existing llms.txt files or generate new ones from scratch by crawling the site.

techhorizonlabs/thl-open · 46 tokens

agent-readiness-scan

Use when a client audit, GEO/AI-visibility snapshot, or remediation re-scan needs the Cloudflare agent-readiness score from isitagentready.com — e.g. Theo client audits, "is the site agent-ready", markdown negotiation / MCP / llms.txt / Content-Signal checks, or tracking score deltas after Tier 0/1 fixes.

techhorizonlabs/thl-open · 79 tokens