itsual/agent-skills-collection/empty-states
Claude Code and agent skill by itsual/agent-skills-collection
- community
Checking that the SKILL.md file is still in the repository.
Design effective empty states that orient users, set expectations, and guide them toward the first meaningful action. Use when creating first-use experiences, zero-data screens, cleared views, or error-driven empty conditions.
Install
npx vskill@latest install itsual/agent-skills-collection/empty-statesSKILL.md
The same SKILL.md was published earlier as itsual/agent-skills-collection/empty-states.
Empty States
Overview
Empty states are product moments, not blanks. They appear on first use, after clearing data, or when searches return nothing — and they strongly shape activation and confidence.
When to Use
- First-run and zero-data screens
- No-results and filtered-empty views
- Permission-denied or setup-required states
- Error states that leave a screen empty
Core Practices
- Explain why the screen is empty
- Offer a clear primary action to move forward
- Use illustration or visuals sparingly and purposefully
- Differentiate first-use empty from “you cleared everything” empty
- Avoid dead ends
Principles
- Empty states are onboarding opportunities
- Be helpful, not cutesy at the expense of clarity
- Match tone to the user’s likely emotional state
- Design empty states as intentionally as populated ones
Verification
- [ ] User knows what to do next
- [ ] Primary action is obvious
- [ ] Different empty reasons are handled differently when needed
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/design-ux/empty-states/SKILL.md
Popularity
- Repository stars
- 6
- Repository forks
- 1
- 7-day trend score
- 15
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/itsual/agent-skills-collection/empty-states)