ux-audit-skill
Audit existing UI screens, URLs, screenshots, Figma frames, HTML/CSS/React code, dashboards, mobile flows, and landing pages for UX, accessibility, responsive behavior, visual hierarchy, conversion blockers, state coverage, and regression risk. Use this skill whenever the user asks for a UI/UX review, severity matrix, evidence-backed findings, before/after check, or actionable refactor brief. Never claim DOM, Lighthouse, axe, or screenshot evidence unless it exists.
How do I install this agent skill?
npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill ux-audit-skillIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a specialist framework for auditing user interfaces, including accessibility and visual hierarchy. It uses structured templates and evidence models to ensure reports are accurate. No security threats were found.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
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:
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/sergekostenchuk/ui-ux-agent-skill-system/ux-audit-skill">View ux-audit-skill on skillZs</a>