Kushal20057

Error State Handling — Design skill for Claude Code

Design community

A Claude Skill that enforces good error-state UX: every user-facing error must say what happened, why, and what to do next, never a raw stack trace, error code, or a bare "Something went wrong.

How to install Error State Handling

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Kushal20057/error-state-handling and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Error State Handling does

A Claude Skill that enforces good error-state UX: every user-facing error must say what happened, why, and what to do next, never a raw stack trace, error code, or a bare "Something went wrong.

Alternatives in Design

  • Design AR Overlay — Design an AR overlay interface — anchor strategy, world tracking UI, scan states, confirmation overlays, and o 309 ★
  • Coding Conventions — Enforces client coding conventions 223 ★
  • 404 Planet — Build a full-page 404 error page for a hosting company called "NEXOVA" 152 ★

README

error-state-handling

A Claude Skill that enforces good error-state UX: every user-facing error must say what happened, why, and what to do next — never a raw stack trace, error code, or a bare "Something went wrong."

What it does

Whenever Claude builds or reviews a feature that can fail (API calls, forms, file uploads, auth, payments, data fetches), this skill makes it:

  • Add loading / empty / error states, not just the happy path
  • Log full technical errors server-side (with an ID + timestamp), never in the UI
  • Write user-facing errors in plain English using a Title / Body / Action template
  • Refactor existing raw-error or generic-error UI on sight, even if not explicitly asked

See [SKILL.md](./SKILL.md) for the full rules, template, and examples.

Install

**Claude Code**

git clone https://github.com/Kushal20057/error-state-handling.git
claude skills add ./error-state-handling

**Claude.ai** Upload `SKILL.md` as a file in a Claude.ai Project, or use the "Save skill" option if you received it as a `.skill` file.

**Anthropic API** Paste the contents of `SKILL.md` into your system prompt, or serve it via the Skills API.

License

Apache 2.0 — see [LICENSE](./LICENSE).