onboarding-ux
Audit and generate in-app user guidance — onboarding flows, empty states, tooltips, feature tours, contextual help, defaults, and inline hints. Browses the app to find where new users would get stuck, then produces the actual content and code to fix it. Pairs with ux-audit: audit finds problems, this skill builds the solutions. Triggers: 'onboarding', 'help content', 'empty states', 'user guidance', 'first run experience', 'feature tour', 'app is confusing', 'new user experience', 'make the app welcoming'.
npx skills add jezweb/claude-skills --skill onboarding-ux --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Onboarding UX Audit a web app for onboarding gaps, then generate the in-app guidance to fix them. The goal: a new user should never stare at a blank screen wondering what to do. ## The Problem This Solves You've built the features. They work. But when a new user logs in for the first time, they see: - Empty tables with column headers and nothing else - Sidebars full of labels that mean nothing to them yet - No indication of where to start or what the app is for - Features they don't know exist because nothing points to them This skill finds those gaps and produces the content and code to fill them. ## Browser Tool Detection Same as ux-audit — detect Chrome MCP, Playwright MCP, or playwright-cli. See ux-audit's browser-tools.md reference if needed. ## URL Resolution Same as ux-audit — prefer deployed/live URL over localhost. Check wrangler.jsonc, CLAUDE.md, or running dev server. ## Workflow ### Phase 1: Audit — Find the Gaps Browse the app as a brand new user. On every page, evaluate: #### Empty States Navigate to every list/table/collection page. For each: | Check | Good | Bad | |-------|------|-----| | What does a zero-data page show? | "No clients yet. Add your first client to
- The Problem This Solves
- Browser Tool Detection
- URL Resolution
- Workflow
- Phase 1: Audit — Find the Gaps
- Phase 2: Generate — Build the Solutions
- Output
- Tips
- Pairing With Other Skills
What does the onboarding-ux skill do?
Audit and generate in-app user guidance — onboarding flows, empty states, tooltips, feature tours, contextual help, defaults, and inline hints. Browses the app to find where new users would get stuck, then produces the actual content and code to fix it. Pairs with ux-audit: audit finds problems, this skill builds the solutions. Triggers: 'onboarding', 'help content', 'empty states', 'user guidance', 'first run experience', 'feature tour', 'app is confusing', 'new user experience', 'make the app welcoming'.
How do I install it?
Run `npx skills add jezweb/claude-skills --skill onboarding-ux --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From jezweb/claude-skills, a repository with 954 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.