| name | ux-toolkit |
| description | Comprehensive UX evaluation meta-skill. Use when conducting UI/UX audits, accessibility reviews, user flow analysis, responsive testing, or interaction design evaluation. |
| version | 2.0.0 |
UX Toolkit
Professional-grade meta-skill for systematic UX evaluation across 9 domains. Framework-agnostic design works for web, mobile, and desktop applications.
When to Use
Invoke for:
- UI/UX heuristic evaluations (Nielsen + modern methodologies)
- Accessibility (WCAG 2.2) compliance audits
- User flow & friction analysis
- Responsive/cross-device testing
- Interaction & micro-interaction review
- Design system consistency audits
- Content & UX writing review
- AI/ML interface patterns
- Privacy & ethical design review
Audit Type Selection
What do you need to evaluate?
│
├─► Full UX Audit ─────────► Load ALL references
│
├─► Accessibility Only ────► Load accessibility-inspector.md
│
├─► Usability Review ──────► Load heuristic-audit.md + user-flow-analysis.md
│
├─► Visual/Responsive ─────► Load responsive-behavior.md + interaction-review.md
│
├─► Design System ─────────► Load design-system-audit.md
│
├─► Content Audit ─────────► Load content-ux-audit.md
│
├─► AI Interface ──────────► Load ai-ux-patterns.md
│
└─► Privacy/Ethics ────────► Load privacy-ethics-audit.md
Sub-Workflows
| Domain | Reference | Purpose |
|---|
| Heuristic Audit | references/heuristic-audit.md | Nielsen's 10 + modern methodologies (OOUX, JTBD, Cognitive Walkthrough) |
| A11Y Inspector | references/accessibility-inspector.md | WCAG 2.2 AA/AAA, keyboard nav, screen readers |
| Flow Analysis | references/user-flow-analysis.md | Task paths, friction points, cognitive load |
| Responsive | references/responsive-behavior.md | Breakpoints, touch targets, RTL/LTR, PWA |
| Interactions | references/interaction-review.md | Micro-interactions, animations, feedback |
| Design System | references/design-system-audit.md | Token consistency, component audit |
| Content UX | references/content-ux-audit.md | UX writing, readability, voice & tone |
| AI/ML Patterns | references/ai-ux-patterns.md | Explainability, trust, ML error handling |
| Privacy & Ethics | references/privacy-ethics-audit.md | Dark patterns, consent, GDPR/DSA compliance |
Quick Start
1. Define Scope
Audit Scope:
├── Screens/Pages: [List target screens]
├── User Flows: [Primary conversion, core tasks]
├── Platform: [Web/Mobile/Desktop/All]
├── WCAG Target: [A/AA/AAA]
└── Priority Focus: [Accessibility/Usability/Performance]
2. Select Audit Type
| Type | References | Time | Coverage |
|---|
| Quick A11Y | accessibility-inspector.md | 1-2h | Automated + keyboard nav |
| Heuristic Review | heuristic-audit.md | 2-4h | Nielsen's 10 + severity |
| Full UX Audit | All 9 references | 1-2d | Complete evaluation |
| Focused Audit | 2-3 specific refs | 3-6h | Targeted domain review |
3. Execute Workflow
Each reference contains:
- Checklist items w/ pass/fail criteria
- Severity + effort classification
- Remediation guidance
- Tool recommendations
4. Generate Report
python3 scripts/generate_report.py --type [full|heuristic|a11y|flow|responsive|interaction] --output report.md --format [md|json|csv]
Severity Classification
| Level | Impact | Frequency | Priority | Action |
|---|
| Critical | Blocks task | Any | P0 | Fix immediately |
| Major | Significant friction | >50% users | P1 | Fix before release |
| Minor | Reduced efficiency | <50% users | P2 | Fix in next sprint |
| Cosmetic | Polish issue | Any | P3 | Backlog |
Priority Matrix
HIGH FREQUENCY
│
┌───────────────┼───────────────┐
│ │ │
│ MAJOR │ CRITICAL │
│ (P1) │ (P0) │
│ │ │
LOW ├───────────────┼───────────────┤ HIGH
IMPACT │ │ │ IMPACT
│ COSMETIC │ MINOR │
│ (P3) │ (P2) │
│ │ │
└───────────────┼───────────────┘
│
LOW FREQUENCY
Effort Estimation
| Effort | Description | Examples |
|---|
| Low | < 1 hour, single file | CSS fix, label addition, alt text |
| Medium | 1-4 hours, few files | Component refactor, form validation |
| High | > 4 hours, architectural | Navigation restructure, focus management |
Modern Methodologies
Beyond Nielsen's 10 heuristics, this toolkit incorporates:
| Methodology | Focus | When to Use |
|---|
| Cognitive Walkthrough | Task completion probability | Complex flows, onboarding |
| OOUX | Object-noun consistency | Information architecture |
| JTBD | Job stories validation | Feature validation |
| Six Minds Framework | Cognitive architecture | Complex interfaces |
| Baymard Heuristics | E-commerce specifics | Shopping flows |
WCAG Compliance Levels
| Level | Requirement | Target |
|---|
| A | Minimum accessibility | Baseline |
| AA | Acceptable accessibility | Standard target |
| AAA | Enhanced accessibility | Specific audiences |
WCAG 2.2 Status: This toolkit covers all 9 new WCAG 2.2 criteria (October 2023).
Platform Adapters
| Platform | Automated Testing | Manual Testing |
|---|
| Web | axe-core, Lighthouse | Browser DevTools |
| iOS | Xcode Accessibility Inspector | VoiceOver |
| Android | Accessibility Scanner (ADB) | TalkBack |
| Desktop | Platform-specific tools | Keyboard + screen reader |
| Design Files | Figma plugins (Stark, A11y) | Manual review |
Integration Points
| Tool | Purpose | Usage |
|---|
| axe-core | Automated a11y | scripts/run_axe.js |
| Lighthouse | Performance + a11y | Chrome DevTools |
| Contrast Checker | Color ratios | scripts/check_contrast.py |
| Readability | Content grade level | Flesch-Kincaid analysis |
| Visual Regression | Layout stability | BackstopJS/Playwright |
Process Overview
1. Scope Definition → Define screens/flows to audit
2. Reference Loading → Load relevant sub-workflow(s)
3. Automated Scans → Run axe-core, Lighthouse
4. Manual Review → Execute checklists
5. Finding Capture → Document w/ severity + effort
6. Prioritization → Apply Impact × Frequency matrix
7. Report Generation → Compile actionable report
Anti-Patterns to Detect
| Anti-Pattern | Category | Severity |
|---|
| Confirm-shaming | Dark Pattern | Critical |
| Hidden costs | Dark Pattern | Critical |
| Forced continuity | Dark Pattern | Major |
| No loading feedback | Visibility | Major |
| Keyboard traps | Accessibility | Critical |
| Color-only indicators | Accessibility | Major |
| Infinite scroll w/o footer | Navigation | Minor |
| Auto-playing video w/ sound | Attention | Major |
Competitive Benchmarking
For comprehensive audits, compare key flows against 1-2 competitors:
| Metric | Your Product | Competitor A | Competitor B |
|--------|--------------|--------------|--------------|
| Task completion time | Xs | Xs | Xs |
| Click count | X | X | X |
| Error rate | X% | X% | X% |
| A11y score (Lighthouse) | X | X | X |
Report Formats
| Format | Use Case | Command |
|---|
| Markdown | Documentation, PRs | --format md |
| JSON | Jira/Linear import | --format json |
| CSV | Spreadsheet analysis | --format csv |
Files Structure
ux-toolkit/
├── SKILL.md # This file
├── references/
│ ├── heuristic-audit.md # Nielsen + modern heuristics
│ ├── accessibility-inspector.md # WCAG 2.2 compliance
│ ├── user-flow-analysis.md # Flow & friction analysis
│ ├── responsive-behavior.md # Cross-device behavior
│ ├── interaction-review.md # Micro-interactions
│ ├── design-system-audit.md # Token & component audit
│ ├── content-ux-audit.md # UX writing & readability
│ ├── ai-ux-patterns.md # AI/ML interface patterns
│ └── privacy-ethics-audit.md # Dark patterns & consent
├── scripts/
│ ├── check_contrast.py # Color contrast checker
│ ├── generate_report.py # Report generator
│ └── run_axe.js # Automated a11y testing
└── data/
└── issues-database.json # Common issues + remediation
Ref: Load specific references/*.md for detailed checklists & workflows.
