How this skill is triggered — by the user, by Claude, or both
Slash command
/refactoring-ui-skills:07-design-empty-statesThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Create helpful, actionable empty/zero states that guide users forward instead of leaving them at a dead end.
Create helpful, actionable empty/zero states that guide users forward instead of leaving them at a dead end.
Generative + Evaluative
Transforms blank screens into onboarding/guidance moments with context, explanation, and clear next steps.
Illustration/Icon (optional but helpful)
Headline
Description
Primary Action
Secondary Info (optional)
| Type | Context | Approach |
|---|---|---|
| First-time | New user, no content | Onboarding, education, clear CTA |
| User-cleared | User deleted everything | Confirmation, undo option, re-add CTA |
| No results | Search/filter returned nothing | Adjust filters, clear search, try different terms |
| No access | Permission restrictions | Explain why, how to request access |
| Error state | Failed to load | Retry action, support contact |
| Failure | Description | Fix |
|---|---|---|
| The Void | Blank white space | Add context, illustration, CTA |
| Error as Empty | "404" or "Null" message | Distinguish error states from empty states |
| No Way Forward | Message but no action | Always provide primary CTA |
| Generic Illustration | Unrelated cute character | Use relevant icon or context illustration |
| Negative Framing | "You have no friends" | Positive framing: "Connect with people" |
| Too Much Info | Paragraphs of text | Keep to 1-2 sentences + CTA |
design-button-hierarchy (needs clear primary action)apply-typography-scale (headline + body hierarchy)Input: Dashboard showing "No data available" in small gray text, no other content
Evaluation: FAIL
Recommendation:
npx claudepluginhub gnurio/refactoring-ui-plugin --plugin refactoring-ui-skillsGuides design of empty states for first-use, no-results, user-cleared, and error scenarios to reduce abandonment and improve activation.
Provides patterns and copywriting guidance for empty states: first-use, user-cleared, no-results, and error-empty screens. Includes rules for CTAs, value framing, and recovery suggestions.
Provides emotional UX design patterns: user needs hierarchy, surface/deep delight, empty states checklists, and progressive onboarding for intuitive interfaces.