ux-audit

What This Skill Does

The ux-audit skill acts as a design consultant embedded directly within your OpenClaw agent. Built upon the principles of Making UX Decisions by Tommy Geoco, it allows you to evaluate user interfaces systematically rather than relying on subjective gut feelings. The skill leverages a comprehensive library of design scaffolds, execution checklists, and established patterns—ranging from information architecture and accessibility to cognitive load management and progressive disclosure. When you trigger this skill, the agent scans your design assets or descriptions, mapping them against proven industry frameworks like the '3 Pillars of Warp-Speed Decisioning' (Scaffolding, Decisioning, and Crafting) to provide actionable, objective design feedback.

Installation

To integrate this auditing tool into your OpenClaw environment, execute the following command in your terminal or command interface:

clawhub install openclaw/skills/skills/tommygeoco/ux-audit

Ensure that you have your workspace permissions set to allow file-read access so the agent can properly parse your UI documentation or screenshot exports.

Use Cases

• Rapid UI Prototyping: Use it to validate component choices before moving to high-fidelity designs.
• Design Debt Reduction: Identify areas where inconsistent patterns increase cognitive load.
• Accessibility Compliance: Automatically flag potential issues like contrast violations, keyboard navigation gaps, and missing alt text references.
• Team Alignment: Use the skill to settle design debates by referencing objective, data-backed industry standards.
• Onboarding Optimization: Evaluate new user flows against proven patterns for reducing friction and abandonment.

Example Prompts

1. "@ux-audit, evaluate my current dashboard landing page. Does it align with the progressive disclosure patterns for minimizing cognitive load?"
2. "I'm deciding between a stepper or a side-nav for this new product configuration flow. Compare the two based on the patterns defined in the skill documentation."
3. "Run a full accessibility audit on these component specs and highlight any high-risk areas based on the 27-patterns-accessibility checklist."

Tips & Limitations

• Prioritize Context: Always provide the user persona or business goal along with your UI request to get the most relevant advice.
• Fidelity Awareness: The skill works best when provided with clear, annotated component states. While it can interpret general layouts, specific visual nuance is best reviewed with high-fidelity screenshots.
• Iterative Use: Don't just audit once. Re-run the audit after implementing feedback to ensure the design remains consistent with the chosen scaffold.
• Limitations: The skill provides expert recommendations based on heuristics and established UX research, but it cannot replace genuine usability testing with actual users. Treat its output as a high-quality baseline.