Agent skill

UX Audit Walkthrough

by AIPexStudio in AIPexStudio/AIPex

Walks a Figma prototype or live webpage screen by screen and scores it against four minimalist usability principles.

MITAuto-check passedFrontend & Design

Install UX Audit Walkthrough

skills CLI
$ npx skills add AIPexStudio/AIPex --skill ux-audit-walkthrough -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AIPexStudio/AIPex ux-audit-walkthrough --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AIPexStudio/AIPex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/browser-runtime/src/skill/built-in/ux-audit-walkthrough .claude/skills/ux-audit-walkthrough && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ux-audit-walkthrough
GitHub stars
1.3k
Token cost
~1.9k tokens
SKILL.md length
882 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Walks a Figma prototype or live webpage screen by screen and scores it against four minimalist usability principles.

  • Works in 4 steps: Strategy & Framework Setup → Continuous Walkthrough Logging → Final Diagnostic Report (Markdown) → …
  • Auditing a Figma prototype's click flow for usability issues
  • SKILL.md covers When to Use This Skill, Tool Usage Strategy (IMPORTANT), Profile and Core Philosophy (Four Core…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill drives a UX walkthrough audit by taking a screenshot first, analyzing what's on screen, then acting - clicking, scrolling or hovering - and taking a fresh screenshot after every action rather than relying on programmatic element lookup, which it only falls back to when screenshot analysis alone is not enough.

It evaluates each interaction against four principles: eliminating decorative or repetitive UI elements, keeping any non-essential task under three clicks, rejecting hidden gestures or triggers without a visible affordance, and making interfaces clear enough that a user should not hesitate for more than half a second. The output is a UX health score and a diagnostic report that names both surface-level UI problems and hidden logical traps in the flow.

It overrides the agent's normal tool-selection habits for this task specifically, requiring the screenshot-and-act loop as the primary method rather than treating it as optional.

When your agent uses it

  • Auditing a Figma prototype's click flow for usability issues
  • Scoring a live webpage's interaction design against a UX checklist
  • Finding hidden logic or cognitive-load problems in an interface

Example prompts

  • “Run a UX walkthrough audit on this Figma prototype link.”
  • “Audit the checkout flow on our staging site for cognitive load.”
  • “How many clicks does it take to complete this signup flow?”

Requirements

  • Screenshot and on-screen control tools for the target interface

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Strategy & Framework Setup
  2. Continuous Walkthrough Logging
  3. Final Diagnostic Report (Markdown)
  4. Report Export (ZIP with Screenshots)

What it can do on your machine

Read from SKILL.md and the folder at commit 4173fa8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

UX Audit Walkthrough loads about 1.9k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 882 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AIPexStudio/AIPex at commit 4173fa8, republished under its MIT licence (© AIPexStudio). 882 words, ~1,937 tokens.

Download SKILL.mdSave it as .claude/skills/ux-audit-walkthrough/SKILL.md (or your agent's skills folder).
name
ux-audit-walkthrough
description
Minimalist UX/Interaction Audit Expert that deconstructs complex interactions through cognitive load and operational efficiency lenses. Use this skill when you need to perform a UX walkthrough audit on a Figma prototype or web interface, evaluating usability based on principles like fewer clicks, less UI elements, no hidden logic, and self-explanatory design.
version
1.0.0

UX Audit Walkthrough Skill

When to Use This Skill

Use this skill when the user wants to:

  • Perform a UX walkthrough audit on a Figma Prototype or live webpage
  • Evaluate interaction flows for usability issues
  • Identify cognitive load problems and path friction in UI designs
  • Generate a professional UX health score and diagnostic report

Tool Usage Strategy (IMPORTANT)

This skill overrides the default tool selection strategy for UI operations.

When performing UX audit walkthroughs, you MUST follow this tool priority:

  1. PRIMARY: Screenshot + Computer

    • ALWAYS use capture_screenshot(sendToLLM=true) FIRST to understand the current page state
    • Use the computer tool for all coordinate-based interactions (clicks, scrolls, hovers)
    • Before ANY coordinate-based action, you MUST take a fresh screenshot
    • This visual-first approach is essential for accurate UX evaluation
  2. FALLBACK: search_elements

    • Only use search_elements when screenshot analysis is insufficient
    • Use for programmatic element discovery when visual inspection fails
  3. Workflow for Each Step:

    capture_screenshot(sendToLLM=true) → Analyze UI → Record observations → 
    computer(action) → capture_screenshot(sendToLLM=true) → Verify result

Role: Minimalist Interaction Audit Expert (UX Audit Architect)

Profile

You are a world-class UX audit expert specializing in deconstructing complex interactions through the lenses of cognitive load and operational efficiency. You treat redundancy as the enemy and relentlessly apply Occam's Razor to trim bloated interaction flows to their essence. You not only identify UI-level flaws, but also uncover hidden logical traps embedded in product design.

Core Philosophy (Four Core Audit Principles)

  1. Less UI elements
    UI exists to solve problems. Any decorative, repetitive, or attention-distracting elements must be eliminated.
  2. Fewer clicks
    Evaluate the shortest path to task completion. Any non-essential task requiring more than 3 clicks is suspect.
  3. No hidden logic
    Interactions must align with user expectations. Reject hidden long-presses, undiscoverable swipe gestures, or triggers without visual affordances.
  4. Don't make users think
    Interfaces must be self-explanatory. Users should not hesitate for more than 0.5 seconds before acting.

Task Strategy & Workflow

When the user provides a Figma Prototype link and task objectives, you will execute the audit in the following phases:


Before starting the automated walkthrough, it is recommended (but not mandatory) to briefly confirm with the user:

  • Target Users: Who is the primary audience for this product? (e.g., first-time users, power users, elderly, etc.)
  • Task Objective: What specific task or flow should be audited? (e.g., "complete checkout", "sign up and onboard")
  • Design Goals: What are the key design goals or success criteria? (e.g., "minimize time to first action", "reduce support tickets")

This context helps you tailor the audit to real-world constraints and produce more actionable recommendations.


Phase 1: Strategy & Framework Setup

Before starting the audit, define the following based on task complexity:

  • Evaluation Dimensions

    • Intent Clarity (aligned with Don't make users think)
    • Path Friction (aligned with Fewer clicks)
    • Information Signal-to-Noise Ratio (aligned with Less UI elements)
    • Logic Visibility (aligned with No hidden logic)
  • Scoring Framework (Total: 100 points)

    • Base score: 80
    • Exceptional execution: bonus points
    • Principle violations:
      • Severe issue: −10
      • Moderate issue: −5
      • Minor improvement: −2
  • Anchor Questions

    • Are there any isolated or dead-end pages?
    • Are button labels expressed as verbs?
    • Does the current state clearly indicate the next action?

Show full SKILL.md (377 more words)Show less
Phase 2: Continuous Walkthrough Logging

For each step in the Prototype, output the following:

  • [Step ID]: Page or step name
  • [User Action]: What the user is trying to accomplish
  • [Interaction Friction]: Identified issues (must reference one of the four core principles)
  • [Cognitive Load]: User thinking cost at this step (Low / Medium / High)

Phase 3: Final Diagnostic Report (Markdown)

Produce a professional Markdown report with the following structure:

  1. Executive Summary
    A single-sentence assessment of the flow's overall strengths and weaknesses.

  2. UX Health Score
    Final score based on the scoring framework, with a grade (S / A / B / C, etc.).

  3. Major Findings

    • Issue list sorted by severity.
    • Each issue must include:
      • Problem Description
      • Violated Principle
      • Actionable Optimization Advice
  4. Efficiency Metrics

    • Actual click count vs. theoretical minimum click count
    • UI element density assessment
  5. Redesign Proposal

    • For the top 1–2 most severe logical breakpoints, provide a streamlined redesign approach.

Phase 4: Report Export (ZIP with Screenshots)

After completing the diagnostic report, ask the user if they would like to export the report as a downloadable ZIP file.

💡 Recommendation: It is strongly recommended to download and save the report for future reference, stakeholder sharing, and tracking improvements over time. The ZIP format preserves both the Markdown report and all visual evidence (screenshots) in a portable package.

Screenshot Reference Convention

When referencing screenshots captured during the walkthrough in your report, use the following placeholder syntax:

[[screenshot:1]]   ← refers to the 1st screenshot captured in this session
[[screenshot:2]]   ← refers to the 2nd screenshot
...

Example usage in the report:

markdown
### Issue #1: Unclear Primary CTA

The main call-to-action button blends into the background, violating the "Don't make users think" principle.

[[screenshot:3]]

**Recommendation**: Increase button contrast and add a subtle shadow to create visual hierarchy.
Export Workflow
  1. Present the complete Markdown report to the user.
  2. Ask: "Would you like me to export this report as a ZIP file with all screenshots included?"
  3. Upon user confirmation, call the download_current_chat_report_zip tool with the report content.
  4. The tool will:
    • Replace all [[screenshot:N]] placeholders with proper Markdown image links (![](screenshots/screenshot-001.png))
    • Package the report and all captured screenshots into a single ZIP file
    • Trigger a browser download dialog

Note: The ZIP file will contain:

  • report.md — The full audit report with working image links
  • screenshots/ — All captured screenshots from the session

Constraints & Tone

  • Tone: Professional, sharp, objective, efficiency-driven
  • Avoid: Subjective terms such as "beautiful" or "nice-looking"
    Use professional terminology like cognitive burden, visual anchors, and interaction density.
  • Logic Integrity:
    If the provided Prototype cannot form a closed logical loop, you must explicitly call out the breakpoints.

© AIPexStudio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/browser-runtime/src/skill/built-in/ux-audit-walkthrough of AIPexStudio/AIPex.

Open the folder on GitHubat commit 4173fa8

Compare with similar skills

UX Audit Walkthrough next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

UX Audit Walkthrough compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
UX Audit Walkthrough this skillAIPexStudio/AIPex1.3k—~1.9kAutomated safety check: PassMIT
Design Critiquemohitagw15856/pm-claude-skills1.4k—~1.5kAutomated safety check: PassMIT
Ostackmr-daedalium/ostack-saas114—~6.1kAutomated safety check: NotesMIT
Bdgszymdzum/browser-debugger-cli170—~2.4kAutomated safety check: NotesMIT
GstackLeoYeAI/openclaw-master-skills2.2k—~4.1kAutomated safety check: NotesMIT
BrowseLeoYeAI/openclaw-master-skills2.2k—~3.2kAutomated safety check: NotesMIT

Similar skills

  • Design Critique

    mohitagw15856/pm-claude-skills

    Give structured, constructive feedback on any design using UX frameworks.

    1.4k GitHub stars~1.5k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Ostack

    mr-daedalium/ostack-saas

    Fast headless browser for QA testing and site dogfooding. An agent skill from mr-daedalium/ostack-saas.

    114 GitHub stars~6.1k tokensUpdated 6 mo ago
    DevelopmentAuto-check: notes
  • Bdg

    szymdzum/browser-debugger-cli

    Use bdg CLI to drive and debug a real Chrome via Chrome DevTools Protocol - navigate, click, fill and submit forms, check what an action changed (navigation, new messages, pending requests), inspect…

    170 GitHub stars~2.4k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Gstack

    LeoYeAI/openclaw-master-skills

    Fast headless browser for QA testing and site dogfooding. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check: notes
  • Browse

    LeoYeAI/openclaw-master-skills

    Fast headless browser for QA testing and site dogfooding. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~3.2k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check: notes
  • Pushes an agent past generic defaults when designing dashboards, admin panels, SaaS apps and tools, with attention to structure, type, navigation and how data is shown.

    11k GitHub starsUsed in 3 repos~6k tokens
    Frontend & DesignAuto-check passed

More from AIPexStudio/AIPex

  • AIPex Browser Control

    AIPexStudio/AIPex

    Lets an agent drive Chrome through the AIPex extension and its MCP bridge: navigation, clicking, form filling, screenshots, tab management and downloads.

    1.3k GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Audits a live webpage against eight core WCAG 2.2 success criteria, combining accessibility-tree inspection, visual screenshots and keyboard navigation tests, with evidence in the report.

    1.3k GitHub stars~4.7k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about UX Audit Walkthrough

What does UX Audit Walkthrough do?

Walks a Figma prototype or live webpage screen by screen and scores it against four minimalist usability principles. This skill drives a UX walkthrough audit by taking a screenshot first, analyzing what's on screen, then acting - clicking, scrolling or hovering - and taking a fresh screenshot after every action rather than relying on programmatic element lookup, which it only falls back to when screenshot analysis alone is not enough.

When should I use UX Audit Walkthrough?

UX Audit Walkthrough fits situations like: auditing a Figma prototype's click flow for usability issues; scoring a live webpage's interaction design against a UX checklist; finding hidden logic or cognitive-load problems in an interface.

How do I install UX Audit Walkthrough in Claude Code?

Run `npx skills add AIPexStudio/AIPex --skill ux-audit-walkthrough -a claude-code`. Or copy the skill folder (packages/browser-runtime/src/skill/built-in/ux-audit-walkthrough in AIPexStudio/AIPex) into .claude/skills/ux-audit-walkthrough in your project. Claude Code loads it when a task matches its description.

How do I install UX Audit Walkthrough in Codex?

Run `npx skills add AIPexStudio/AIPex --skill ux-audit-walkthrough -a codex`. Or copy the skill folder (packages/browser-runtime/src/skill/built-in/ux-audit-walkthrough in AIPexStudio/AIPex) into .agents/skills/ux-audit-walkthrough in your project. Codex loads it when a task matches its description.

Can I use UX Audit Walkthrough in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AIPexStudio/AIPex --skill ux-audit-walkthrough -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ux-audit-walkthrough, .gemini/skills/ux-audit-walkthrough, .github/skills/ux-audit-walkthrough and .opencode/skills/ux-audit-walkthrough in your project.

What does UX Audit Walkthrough need to run?

SKILL.md names no scripts, command-line tools or credentials: UX Audit Walkthrough is instructions for the agent only. Our summary lists: Screenshot and on-screen control tools for the target interface.

Does UX Audit Walkthrough access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is UX Audit Walkthrough safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does UX Audit Walkthrough use?

UX Audit Walkthrough is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does UX Audit Walkthrough use?

About 1.9k tokens (SKILL.md is roughly 7.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to UX Audit Walkthrough?

Skills that share tags, products or a category with UX Audit Walkthrough: Design Critique (mohitagw15856/pm-claude-skills, 1.4k stars), Ostack (mr-daedalium/ostack-saas, 114 stars), Bdg (szymdzum/browser-debugger-cli, 170 stars) and Gstack (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains UX Audit Walkthrough?

AIPexStudio (a GitHub organization) maintains it in AIPexStudio/AIPex, which has 1,261 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on August 26, 2026.

Source: AIPexStudio/AIPex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.