wtf is onboarding-audit?

onboarding-audit is a free skill that plugs into coding agents like Claude Code, Codex, and Cursor. It teaches the agent to look at your app's signup flow and point out where a first time user would likely get confused or give up, then hand back a written report describing what to fix first. The skill packages up patterns commonly seen in onboarding reviews, things like empty states, front loaded value, sensible default settings, clear success states, progression systems, and how permissions are requested, and applies them to your actual signup to first value path. Because your agent already has access to your codebase, it can point to specific files and screens rather than giving generic advice. To use it, you tell your agent to audit your onboarding, and it works out what your product's key first moment of value is, checking that guess with you, then maps every screen on the path from signup onward and scores it against seven common patterns as pass, needs work, or missing. The final report lists problems ordered by how serious they are, describes what a new user would actually experience on each screen, and suggests a specific fix, including some quick fixes the agent can make immediately. The README is upfront about a limitation: because the audit only reads code, it can tell you what a fresh user would likely see, but it cannot tell you where real users actually get stuck or drop off, since that requires tracking real user behavior rather than reading source files. It is released under the MIT license, and installable via Claude Code's plugin system or the general purpose skills command line tool.