ss-audit
FeaturedAudit screens for UX issues using Nielsen's heuristics and modern mobile UX best practices
Web & Frontend 950 stars
88 forks Updated today MIT
Install
Quality Score: 96/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# UX Audit
## Registry-first artifact boundary
When `.styleseed/project.json` and `.styleseed/artifacts/index.json` exist, resolve the requested artifact ID first, then read only `.styleseed/bundles/<artifact-id>.md` and `.styleseed/manifests/<artifact-id>.json`. Never fall back to the global legacy bundle for a registry project. Legacy projects may use `.styleseed/effective-rules.md` only when no registry exists.
## When NOT to use
- For accessibility-only issues → use `/ss-a11y`
- For design system token/golden-rule compliance → use `/ss-review`
- For copy/microcopy quality → use `/ss-copy`
- For brand new screens that don't exist yet — design first with `/ss-page` or `/ss-flow`
Target: **$ARGUMENTS**
## Audit Framework
### Nielsen's 10 Usability Heuristics
#### 1. Visibility of System Status
- [ ] Loading states present (skeleton screens, not spinners)
- [ ] Success/error feedback after actions (toast notifications)
- [ ] Progress indicators for multi-step flows
- [ ] Active state clearly shown on navigation items
- [ ] Real-time data has timestamp showing freshness
#### 2. Match Between System and Real World
- [ ] Labels use user's language, not technical jargon
- [ ] Icons are universally recognizable (Lucide standard set)
- [ ] Number formats match user expectations (comma separators, currency symbols)
- [ ] Date formats are locale-appropriate
#### 3. User Control and Freedom
- [ ] Back navigation available on all non-root screens
- [ ] Destructive actions have...
Details
- Author
- bitjaru
- Repository
- bitjaru/styleseed
- Created
- 5 months ago
- Last Updated
- today
- Language
- JavaScript
- License
- MIT
Integrates with
Bundled in these plugins
Similar Skills
Semantically similar based on skill content — not just same category
Web & Frontend Featured
ss-a11y
Audit a component or page for accessibility issues and fix them
950 Updated today
bitjaru Web & Frontend Listed
ui-ux-audit
Structured UI/UX audit of a screen or flow — hierarchy, clarity, states, a11y, mobile. Use before shipping UI or when asking “what’s wrong with this page?”.
0 Updated 1 months ago
edenbuilds AI & Automation Solid
heuristic-evaluation
Audit a design against Nielsen's ten usability heuristics, tying every finding to a specific element with a specific fix. Use on a built screen or a detailed mockup.
28 Updated today
mshadmanrahman