ux-decisions – OpenClaw Skill

---

name: ux-decisions description: "AI skill for the Making UX Decisions framework (uxdecisions.com) by Tommy Geoco. Use for UI/UX design decisions, design audits, pattern selection, visual hierarchy analysis, and reviewing designs for completeness. Enables rapid, intentional interface design with checklists for visual style, accessibility, social proof, navigation, and more." author: Tommy Geoco homepage: https://uxdecisions.com

UX Decisions Skill

A comprehensive UI design decision-making framework based on "Making UX Decisions" by Tommy Geoco (uxdecisions.com). Enables rapid, intentional interface design in competitive, high-pressure environments.

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, sticky, bottom nav

Usage Instructions

For Design Decisions

1. Read 00-core-framework.md for the decisioning workflow
2. Identify if this is a recurring decision (use scaffold) or new decision (use process)
3. Apply the 3-step weighing: institutional knowledge → user familiarity → research

For New Interfaces

1. Follow the 6-step checklist in 10-checklist-new-interfaces.md
2. Reference relevant pattern files for specific UI components
3. Use fidelity and visual style checklists to enhance quality

For Pattern Selection

1. Identify the core problem (chunking, disclosure, cognitive load, etc.)
2. Load the relevant pattern reference
3. Evaluate benefits, use cases, psychological principles, and implementation guidelines

Decision Workflow Summary

When facing a UI decision:

1. WEIGH INFORMATION
   ├─ What does institutional knowledge say? (existing patterns, brand, tech constraints)
   ├─ What are users familiar with? (conventions, competitor patterns)
   └─ What does research say? (user testing, analytics, studies)

2. NARROW OPTIONS
   ├─ Eliminate what conflicts with constraints
   ├─ Prioritize what aligns with macro bets
   └─ Choose based on JTBD support

3. EXECUTE
   └─ Apply relevant checklist + patterns

Macro Bet Categories

Companies win through one or more of:

Bet	Description	Design Implication
Velocity	Features to market faster	Reuse patterns, find metaphors in other markets
Efficiency	Manage waste better	Design systems, reduce WIP
Accuracy	Be right more often	Stronger research, instrumentation
Innovation	Discover untapped potential	Novel patterns, cross-domain inspiration

Always align micro design bets with company macro bets.

Key Principle: Good Design Decisions Are Relative

A design decision is "good" when it:

• Supports the product's jobs-to-be-done
• Aligns with company macro bets
• Respects constraints (time, tech, team)
• Balances user familiarity with differentiation needs

There is no universally correct UI solution—only contextually appropriate ones.

<p align="center"> <img src="logo.png" alt="UX Decisions" width="400" /> </p> <p align="center"> <strong>An AI skill for the Making UX Decisions framework</strong><br> A software design decision-making system for rapid, intentional interface design. </p> <p align="center"> <a href="https://uxdecisions.com">📖 Learn more at uxdecisions.com</a> • <a href="https://clawdhub.com/skills/ux-decisions">ClawdHub</a> • <a href="https://npmjs.com/package/ux-decisions">npm</a> </p>

---

What is this?

This is a skill package that gives AI assistants (Claude, Clawdbot, Codex, etc.) the ability to perform structured UI/UX design audits using the Making UX Decisions framework by Tommy Geoco.

Use it for:

• UI/UX design decisions under time pressure
• Design audits with actionable feedback
• Pattern selection for specific problems
• Visual hierarchy and style analysis
• Reviewing designs for completeness

Installation

Clawdbot / ClawdHub

clawdhub install ux-decisions

npm

npm install ux-decisions

Then copy the files to your project or AI workspace.

Claude Desktop / Claude Code

Copy CLAUDE.md to your project root. Claude will automatically use it.

Manual

Clone this repo and copy to your AI's skills directory:

git clone https://github.com/tommygeoco/ux-decisions.git
cp -r ux-decisions ~/your-ai-workspace/skills/

What's Included

ux-decisions/
├── SKILL.md              # Main skill instructions
├── CLAUDE.md             # Claude-specific quick reference
└── references/
    ├── 00-core-framework.md         # 3 pillars, decisioning workflow
    ├── 10-checklist-new-interfaces.md   # 6-step design process
    ├── 11-checklist-fidelity.md     # Component states, interactions
    ├── 12-checklist-visual-style.md # Spacing, color, typography
    ├── 13-checklist-innovation.md   # Originality spectrum
    ├── 20-patterns-chunking.md      # Cards, tabs, accordions
    ├── 21-patterns-progressive-disclosure.md
    ├── 22-patterns-cognitive-load.md
    ├── 23-patterns-visual-hierarchy.md
    ├── 24-patterns-social-proof.md  # Testimonials, trust signals
    ├── 25-patterns-feedback.md
    ├── 26-patterns-error-handling.md
    ├── 27-patterns-accessibility.md # WCAG, keyboard nav
    ├── 28-patterns-personalization.md
    ├── 29-patterns-onboarding.md
    ├── 30-patterns-information.md
    └── 31-patterns-navigation.md

Core Concepts

The 3 Pillars

1. Scaffolding — Rules that automate recurring decisions
2. Decisioning — Process for making new decisions
3. Crafting — Checklists for executing decisions

Macro Bets

Every design decision should align with company strategy:

Bet	You win by...	Design implication
Velocity	Shipping faster	Reuse patterns, find metaphors
Efficiency	Reducing waste	Design systems, reduce WIP
Accuracy	Being right more	Stronger research, instrumentation
Innovation	Finding new value	Novel patterns, cross-domain inspiration

Decision Workflow

1. WEIGH INFORMATION
   ├─ Institutional knowledge (existing patterns, brand, constraints)
   ├─ User familiarity (conventions, competitor patterns)
   └─ Research (user testing, analytics, studies)

2. NARROW OPTIONS
   ├─ Eliminate conflicts with constraints
   └─ Prioritize by macro bet alignment

3. EXECUTE
   └─ Apply relevant checklist + patterns

Example Usage

Ask your AI assistant:

"Audit this landing page design using the UX Decisions framework"

"What visual hierarchy patterns should I use for a pricing page?"

"Review this checkout flow for accessibility issues"

"Help me decide between tabs vs accordion for this content"

Author

Tommy Geoco

• uxdecisions.com
• uxtools.co

License

MIT