Xpersona
U

UI Audit

CLAWHUB · Unverified

AI skill for automated UI audits. Evaluate interfaces against proven UX principles for visual hierarchy, accessibility, cognitive load, navigation, and more. Based on Making UX Decisions by Tommy Geoco. Skill: UI Audit Owner: tommygeoco Summary: AI skill for automated UI audits. Evaluate interfaces against proven UX principles for visual hierarchy, accessibility, cognitive load, navigation, and more. Based on Making UX Decisions by Tommy Geoco. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-01-18T01:53:31.826Z | user README updates: Vercel AI SDK installation instructions v1.0.0 | 2026-01-18T01:45:36.232Z | auto

62
Rank
84
Safety
10k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 10.3K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17c9k7f92vrddn056q2rg3rah884mce:ui-audit
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tommygeoco-ui-audit-ui-audit-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

144,282 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: ui-audit
description: "AI skill for automated UI audits. Evaluate interfaces against proven UX principles for visual hierarchy, accessibility, cognitive load, navigation, and more. Based on Making UX Decisions by Tommy Geoco."
author: Tommy Geoco
homepage: https://audit.uxtools.co
logo: logo-light.png
logoDark: logo-dark.png
---

# UI Audit Skill

Evaluate interfaces against proven UX principles. Based on [Making UX Decisions](https://uxdecisions.com) by Tommy Geoco.

## When to Use This Skill

- Making UI/UX design decisions under time pressure
- Evaluating design trade-offs with business context
- Choosing appropriate UI patterns for specific problems
- Reviewing designs for completeness and quality
- Structuring design thinking for new interfaces

## Core Philosophy

**Speed ≠ Recklessness.** Designing quickly is not automatically reckless. Recklessly designing quickly is reckless. The difference is intentionality.

## The 3 Pillars of Warp-Speed Decisioning

1. **Scaffolding** — Rules you use to automate recurring decisions
2. **Decisioning** — Process you use for making new decisions  
3. **Crafting** — Checklists you use for executing decisions

## Quick Reference Structure

### Foundational Frameworks
- `references/00-core-framework.md` — 3 pillars, decisioning workflow, macro bets
- `references/01-anchors.md` — 7 foundational mindsets for design resilience
- `references/02-information-scaffold.md` — Psychology, economics, accessibility, defaults

### Checklists (Execution)
- `references/10-checklist-new-interfaces.md` — 6-step process for designing new interfaces
- `references/11-checklist-fidelity.md` — Component states, interactions, scalability, feedback
- `references/12-checklist-visual-style.md` — Spacing, color, elevation, typography, motion
- `references/13-checklist-innovation.md` — 5 levels of originality spectrum

### Patterns (Reusable Solutions)
- `references/20-patterns-chunking.md` — Cards, tabs, accordions, pagination, carousels
- `references/21-patterns-progressive-disclosure.md` — Tooltips, popovers, drawers, modals
- `references/22-patterns-cognitive-load.md` — Steppers, wizards, minimalist nav, simplified forms
- `references/23-patterns-visual-hierarchy.md` — Typography, color, whitespace, size, proximity
- `references/24-patterns-social-proof.md` — Testimonials, UGC, badges, social integration
- `references/25-patterns-feedback.md` — Progress bars, notifications, validation, contextual help
- `references/26-patterns-error-handling.md` — Form validation, undo/redo, dialogs, autosave
- `references/27-patterns-accessibility.md` — Keyboard nav, ARIA, alt text, contrast, zoom
- `references/28-patterns-personalization.md` — Dashboards, adaptive content, preferences, l10n
- `references/29-patterns-onboarding.md` — Tours, contextual tips, tutorials, checklists
- `references/30-patterns-information.md` — Breadcrumbs, sitemaps, tagging, faceted search
- `references/31-patterns-navigation.md` — Priority nav, off-canvas,

README.md

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="logo-dark.png" />
    <source media="(prefers-color-scheme: light)" srcset="logo-light.png" />
    <img src="logo-light.png" alt="UI Audit" width="50" />
  </picture>
</p>

<p align="center">
  <strong>AI skill for automated UI audits</strong><br>
  Evaluate interfaces against proven UX principles.
</p>

<p align="center">
  <a href="https://audit.uxtools.co">Guidelines</a> •
  <a href="https://clawdhub.com/skills/ui-audit">ClawdHub</a> •
  <a href="https://npmjs.com/package/ui-audit">npm</a>
</p>

---

## What is this?

A skill that gives AI assistants the ability to perform structured UI audits. Based on [Making UX Decisions](https://uxdecisions.com) by Tommy Geoco.

**Audits include:**
- Visual hierarchy & typography
- Visual style & spacing
- Accessibility & contrast
- Navigation & wayfinding
- Cognitive load & information architecture
- Social proof & trust signals
- Onboarding & empty states

## Installation

```bash
# Agent Skills (Vercel)
npx skills add uxtools/ui-audit

# ClawdHub
clawdhub install ui-audit

# npm
npm install ui-audit
```

## Usage

Ask your AI assistant:

```
Audit this design: [figma-url]
Review this landing page for accessibility issues
What visual hierarchy patterns should I use for a pricing page?
```

## What's Included

```
ui-audit/
├── SKILL.md                    # Main skill instructions
├── CLAUDE.md                   # Claude-specific quick reference
└── references/
    ├── 00-core-framework.md    # Decision-making process
    ├── 10-checklist-*.md       # Execution checklists
    └── 2*-patterns-*.md        # UI pattern libraries
```

## Guidelines

View the full list of principles at **[audit.uxtools.co](https://audit.uxtools.co)**

### Decisioning
- Weigh information in order: Institutional knowledge → User familiarity → Research
- Align every decision with macro bets: Velocity, Efficiency, Accuracy, or Innovation
- Define jobs-to-be-done first

### Visual Hierarchy
- Primary action is obvious within 3 seconds
- 2:1 ratio minimum between heading levels
- Related items are grouped (Law of Proximity)

### Accessibility
- Keyboard works everywhere
- Focus is always visible
- Color is not the only indicator

[View all guidelines →](https://audit.uxtools.co)

## Author

**[Tommy Geoco](https://x.com/designertom)** — [uxtools.co](https://uxtools.co) • [uxdecisions.com](https://uxdecisions.com)

## License

MIT

_meta.json

{
  "ownerId": "kn77js9mymrx3mfbzwyre847ex7zdnhj",
  "slug": "ui-audit",
  "version": "1.0.1",
  "publishedAt": 1768701211826
}

references/00-core-framework.md

# Core Framework: Warp-Speed Decisioning

## The 3 Pillars

### 1. Scaffolding
Rules that automate recurring decisions. Pre-made defaults so you don't re-decide the same things.

**Components:**
- Design psychology reference (laws, principles)
- Economics fundamentals (market forces)
- Accessibility reference (WCAG/POUR)
- Default typefaces and type scale
- Icon library choice
- Design system reference
- Default design rules

### 2. Decisioning
Process for making new decisions when scaffolds don't apply.

**Workflow:**
1. Inform simplicity — gather minimum viable context
2. Narrow options — eliminate conflicts, prioritize alignment
3. Weigh information — institutional knowledge → familiarity → research
4. Arrive at decision — commit and document reasoning

### 3. Crafting
Checklists for executing decisions consistently.

**Types:**
- Checklists for new interfaces
- Checklists for improving fidelity
- Checklists for visual style
- Checklists for innovation

---

## The Decisioning Workflow (Detail)

### Step 1: What Does Institutional Knowledge Say?

Institutional knowledge = existing patterns, brand guidelines, tech stack, team capabilities, business constraints.

**Questions:**
- Does an existing component/pattern solve this?
- What does our design system prescribe?
- What are our technical constraints?
- What has leadership/stakeholders indicated?

**Rule:** Always check internal resources before external inspiration.

### Step 2: What Are Users Familiar With?

User familiarity = conventions from similar products, learned behaviors, competitor patterns.

**Questions:**
- What do competitors do for this pattern?
- What's the platform convention (iOS/Android/Web)?
- What prior experience do users bring?
- Jakob's Law: Users spend most time on *other* sites

**Rule:** Familiarity reduces cognitive load. Novelty requires justification.

### Step 3: What Does Research Say?

Research = user testing, analytics, academic studies, heuristic evaluation.

**Questions:**
- Do we have usability data on this pattern?
- What does instrumentation tell us?
- Are there published studies on this interaction?
- Have we tested this with users?

**Rule:** Research trumps opinion, but absence of research ≠ decision paralysis.

### Arriving at a Decision

After weighing all three sources:
1. If clear winner exists → choose it
2. If conflict exists → prioritize by macro bet alignment
3. If uncertainty remains → choose fastest to validate, plan to learn

**Document your reasoning.** Future you (and teammates) will thank you.

---

## Staging Your Bets

### Why Bets Matter

Every design decision is a bet. You're wagering time and resources on an outcome. The question is whether you're betting intentionally or accidentally.

### Macro vs. Micro Bets

**Macro bets** = Company-level strategic bets on how to win the market
**Micro bets** = Individual design decisions within an interface

**Critical Rule:** Micro bets are only valid when intentionally supporting macro bets.

references/01-anchors.md

# The 7 Anchors: Foundational Mindsets

Anchors are mental models and principles that form your foundation. They keep you grounded when product development gets chaotic.

## Why Anchors Matter

1. **Clarity in chaos** — Quickly align decisions with core values when juggling priorities
2. **Confidence** — Make bold decisions under pressure
3. **Resilience** — Bounce back from setbacks
4. **Growth** — Framework for continuous learning (anchors evolve with you)

---

## Anchor 1: Pursue Your Purpose

**What:** Connect your work to a larger purpose. Inspired by Ikigai (reason for being).

**The 4 Elements:**
- What you love
- What you're good at
- What the world needs
- What you can be paid for

**When to rely on it:**
- Deciding which projects to take on
- Feeling unfulfilled or burnt out
- Prioritizing features or initiatives
- Considering career moves

**How to apply:**
- Define a personal mission statement
- Evaluate projects against the 4 elements
- Prioritize purpose-aligned work
- Connect even mundane tasks to larger goals
- Regularly reflect on alignment

---

## Anchor 2: Embrace the Marathon Mindset

**What:** Product design is a long game, not a sprint. Sustainable pace beats heroic bursts.

**Key principles:**
- Burnout is a feature, not a bug, of unsustainable work
- Small consistent progress compounds
- Recovery is part of the work
- Career success is measured in decades, not sprints

**When to rely on it:**
- Facing unrealistic deadlines
- Tempted to sacrifice quality for speed
- Building habits and systems
- Evaluating trade-offs with long-term consequences

**How to apply:**
- Protect your energy and attention
- Build systems, not just outputs
- Say no to protect yes
- Invest in learning that compounds

---

## Anchor 3: Be Intentional

**What:** Every design decision should be traceable to a reason. Accidental design is reckless design.

**Intentionality spectrum:**
- Unconscious incompetence (don't know what you don't know)
- Conscious incompetence (know gaps, learning)
- Conscious competence (deliberate, effortful mastery)
- Unconscious competence (intuitive mastery)

**When to rely on it:**
- Making any design decision
- Explaining choices to stakeholders
- Reviewing others' work
- Feeling autopilot taking over

**How to apply:**
- Document your reasoning
- Challenge "it's always been done this way"
- Ask "why this choice?" for every element
- Build decision logs

---

## Anchor 4: Embrace Your Unique Perspective

**What:** Your specific combination of experiences, skills, and viewpoints is an asset, not a liability.

**Key insight:** The industry doesn't need more average designers. It needs your particular blend of weird.

**When to rely on it:**
- Feeling imposter syndrome
- Comparing yourself to others
- Deciding what to learn next
- Positioning yourself professionally

**How to apply:**
- Identify your unique combination of skills
- Lean into interests others find "off-topic"
- Share your perspective, especially when differe

Sponsored

Ads related to UI Audit and adjacent AI workflows.