ss-audit

Audit screens for UX issues using Nielsen's heuristics and mobile UX checks.

Updated May 26, 2026
One-click install
npx skills add https://github.com/rmethodm/resumegen --skill ss-audit-rmethodm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ss-audit
Source: https://github.com/rmethodm/resumegen/tree/main/.agents/skills/ss-audit
Command: npx skills add https://github.com/rmethodm/resumegen --skill ss-audit-rmethodm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a screen for usability problems is often ad hoc and inconsistent, so issues like missing loading states, tiny touch targets, or dark patterns slip through. This Skill provides a structured checklist-based audit so every screen is evaluated against the same criteria. ## Core Features & Use Cases - Heuristic Evaluation: Walks through all 10 of Nielsen's usability heuristics as concrete checkboxes covering feedback, consistency, error prevention, and recovery. - Mobile-Specific Checks: Verifies touch target sizes, safe-area insets, skeleton loading, and gesture affordances for mobile interfaces. - Dark Pattern Detection: Flags forced modals, exit-prevention dialogs, and manipulative CTAs. - Use Case: Point the audit at a checkout screen file and receive a graded report (A+ to F) with critical, major, and minor issues plus specific code-level recommendations. ## Quick Start Run the ss-audit skill on the checkout screen file and list all critical usability issues with fixes.

Frequently Asked Questions about ss-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a screen for UX issues?▼

Run the audit against a screen file or screen name as the argument. The skill walks through Nielsen's 10 heuristics, mobile-specific checks, and dark pattern rules, then returns a graded report with prioritized issues and recommendations.

What usability heuristics does a UX audit checklist cover?▼

The audit covers all 10 Nielsen heuristics including visibility of system status, error prevention, consistency, recognition over recall, and error recovery. Each heuristic maps to concrete checkboxes like skeleton loading states and confirmation dialogs.

Does the UX audit check mobile touch target sizes?▼

Yes, the audit verifies touch targets are at least 44x44px with 8px spacing between adjacent targets. It also checks safe-area insets for notches and home indicators, plus bottom navigation padding.

When should I not use a heuristic UX audit?▼

Skip this audit for accessibility-only reviews, design token compliance checks, copy quality reviews, or screens that do not exist yet. Those cases need dedicated accessibility, design system, copywriting, or screen design workflows instead.

What output format does a UX audit report use?▼

The report starts with an A+ to F score with breakdown, then lists critical issues that block usability, major issues that degrade experience, minor polish items, and specific code change recommendations for each finding.