sergekostenchuk UX Audit Skill
Use this specialist for evidence-backed review of existing UI artifacts. The output is a severity matrix and actionable refactor brief, not a generic design essay.
Operating Modes
review-live-url: audit a reachable URL with available browser/static evidence.review-screenshot: audit image-only context without DOM claims.review-code: audit source files and templates.refactor-brief: convert findings into implementation tasks for another skill.regression-check: compare before/after evidence and remaining risks.
Required Workflow
- Classify available evidence using references/audit-evidence-model.md.
- Apply references/severity-model.md before ranking findings.
- Use assets/audit-report.template.md for audit output.
- Use assets/regression-report.template.md for before/after checks.
- Apply
../../shared/privacy-policy.mdbefore screenshots, Figma, or authenticated state. - If a URL is available, reuse local scripts listed in
../../shared/tool_inventory.json. - Label every finding by evidence type:
DOM,screenshot,source,automated, orManual.
Evidence Boundaries
- Screenshot-only input cannot support DOM, Lighthouse, axe, or runtime claims.
- Source-only input cannot prove rendered layout unless run or screenshot evidence exists.
- Manual findings are allowed but must be labeled
Manual. - Planned tools are not evidence.
Validation
python3 $CODEX_SKILLS_DIR/.system/skill-creator/scripts/quick_validate.py $CODEX_SKILLS_DIR/ux-audit-skill
python3 $CODEX_SKILLS_DIR/senior-skill-architect/scripts/lint_production_skill.py $CODEX_SKILLS_DIR/ux-audit-skill
Output Shape
Audit target:
Evidence available:
Ran:
Skipped:
Severity matrix:
Top fixes:
Verification plan:
Privacy notes:
Residual risk: