How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill ux-audit-skillBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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
bash
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-skillOutput Shape
text
Audit target:
Evidence available:
Ran:
Skipped:
Severity matrix:
Top fixes:
Verification plan:
Privacy notes:
Residual risk:
