ui-audit

What This Skill Does

The ui-audit skill serves as a high-velocity decision-making engine for interface design, directly implementing the methodologies outlined in 'Making UX Decisions' by Tommy Geoco. It functions as an automated design critic that evaluates your UI against three core pillars: Scaffolding (standardized rules for recurring decisions), Decisioning (a structured framework for new interface challenges), and Crafting (execution-focused checklists). By analyzing your designs against these proven UX principles, the agent helps you identify potential bottlenecks in navigation, accessibility failures, cognitive load issues, and visual hierarchy inconsistencies before they reach production. It effectively bridges the gap between fast-paced agile development and thoughtful, intentional design.

Installation

To integrate this skill into your environment, run the following command within your OpenClaw terminal:

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

Ensure your local environment has the necessary permissions to allow the agent to access your design files or screenshots if you intend to run automated visual audits directly on your project assets.

Use Cases

• Rapid Interface Critique: Quickly run an audit on a mid-fidelity wireframe to check for information density issues before moving to high-fidelity.
• Accessibility Compliance: Automatically surface potential failures in contrast, keyboard navigation flow, and ARIA labeling by cross-referencing your UI against the internal accessibility patterns.
• Refining Design Systems: Ensure new components adhere to the visual style checklist regarding spacing, elevation, and typography consistency.
• Strategic Decision Making: When choosing between a drawer, a modal, or a tooltip, use the skill to weigh institutional knowledge against established design patterns to make the most contextually appropriate decision.

Example Prompts

1. "Perform a UI audit on this login screen mockup and identify any risks regarding cognitive load and form validation patterns."
2. "I am designing a complex dashboard. Can you walk me through the 'Making UX Decisions' framework to help me prioritize my navigation structure?"
3. "Evaluate the accessibility of this component using the 27-patterns-accessibility reference, specifically focusing on keyboard navigation."

Tips & Limitations

The UI Audit skill is most effective when provided with clear, annotated screenshots or component states. While it excels at identifying deviations from established patterns, it cannot 'feel' user frustration; always pair these audits with actual user testing when possible. Remember that 'speed is not recklessness'—the goal of this skill is to empower intentional, fast-tracked design decisions, not to replace the critical eye of a human designer.