design-empty-states

Generate empty-state UI copy with primary calls to action.

240|11|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/gnurio/refactoring-ui-plugin --skill design-empty-states
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-empty-states
Source: https://github.com/gnurio/refactoring-ui-plugin/tree/main/skills/07-design-empty-states
Command: npx skills add https://github.com/gnurio/refactoring-ui-plugin --skill design-empty-states

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users get stuck when an interface has no content, because generic or blank empty states don’t explain what belongs there or what to do next.

Core Features & Use Cases

  • Expectation-setting copy: Creates a friendly headline and short description that explains what should appear in the area.
  • Actionable recovery: Recommends a clear primary call-to-action plus optional secondary guidance (e.g., learn more or templates).
  • Context-aware empty-state types: Adapts output for first-time, user-cleared, no-results, no-access, and error-as-empty scenarios.
  • Assessment & refactoring guidance: Produces pass/fail evaluation and identifies failure modes like dead ends, negative framing, and generic illustrations.

Quick Start

Provide your current empty-state context (type of user state, what content should normally be present, and available user actions) and ask the skill to generate an empty-state design spec with copy and a primary CTA.

Frequently Asked Questions about design-empty-states

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is an empty state in UX design and when do I need it?

An empty state in UX design is the UI shown when a screen has zero content, such as during first-time onboarding, no-results searches, or permission-restricted views. You need it to prevent users from hitting dead ends by explaining what belongs there.

How do I design empty state UI copy that prevents user dead ends?

To design empty state UI copy that prevents dead ends, create an actionable headline and short description explaining what should appear, paired with a clear primary call-to-action button. This guides users toward the next step instead of leaving them stranded.

What makes a good empty state versus a poor empty state?

A good empty state provides an actionable headline, descriptive context, and a clear primary button, while a poor empty state fails users with dead ends, negative framing, or generic illustrations. Evaluating these failure modes helps refine zero-content screens.

How do I adapt empty state designs for different UI workflows?

To adapt empty state designs for different UI workflows, generate context-aware copy for first-time experiences, cleared-content views, no-results searches, no-access states, and error-as-empty cases. Each scenario requires a tailored primary call-to-action to guide recovery.

Can I include secondary actions in my zero-content screen design?

Yes, you can include optional secondary info in your zero-content screen design alongside the required primary call-to-action. Secondary guidance, such as links to learn more or templates, provides additional recovery paths without distracting from the main action.

Why does my no-results search state show a blank screen with no actions?

A no-results search state shows a blank screen because it lacks an actionable headline, descriptive copy, and a primary call-to-action. Fix this empty state by adding context-aware guidance that explains the zero-content result and suggests a clear next step.