New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

UX Surface Audit

by lobehub in lobehub/lobehub

Runs a repeatable UX review of one screen against the Designing Interfaces pattern language and LobeHub's ux checklists, using static, visual and dynamic layers.

Custom licenceAuto-check passedFrontend & Design

Install UX Surface Audit

skills CLI
$ npx skills add lobehub/lobehub --skill ux-audit -a claude-code

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

GitHub CLI
$ gh skill install lobehub/lobehub ux-audit --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/lobehub/lobehub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ux-audit .claude/skills/ux-audit && 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
GitHub stars
83k
Token cost
~4.9k tokens
SKILL.md length
2,535 words
Files
32 (incl. references)
Skills in repo
50
Repo updated
First seen
Licence
Custom licence

At a glance

Runs a repeatable UX review of one screen against the Designing Interfaces pattern language and LobeHub's ux checklists, using static, visual and dynamic layers.

  • Works in 2 steps: Jenifer Tidwell, Designing Interfaces —… → The ux skill — LobeHub's execution…
  • Reviewing one built screen against a pattern language before release
  • SKILL.md covers Three layers — pick by what…, Ground rule: evidence, not vibes, Ground rule: benchmark the… and Ground rule: comparing two…, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

A UX audit covers one surface per run, because a full-app sweep is too much for a single pass, and the review is repeated per page as the product grows. The benchmark combines the pattern language from the book Designing Interfaces, which describes what a good interface is made of, with the ux skill's checklists for how a flow should behave.

The audit answers which patterns the surface uses and how well, and where the experience is weak, with each gap tied to a checklist item. Three layers catch different problems: a static layer reads the code for missing empty, error and retry states and absent patterns; a visual layer uses screenshots for hierarchy, spacing, contrast, truncation, responsive breakpoints and dark or light themes; and a dynamic layer runs an automated user journey with performance checks.

Each layer has its own procedure file, and you run the layers the surface needs. Recurring gaps feed back as new items in the ux checklists, and the finished audit becomes a worked-example reference; the folder already holds example audits for surfaces such as chat, home, onboarding and profile.

When your agent uses it

  • Reviewing one built screen against a pattern language before release
  • Checking a page for missing empty, error and retry states in the code
  • Capturing screenshots to judge hierarchy, spacing and responsive behavior
  • Re-auditing a page after the product around it has grown

Example prompts

  • “Audit the home page surface with the static and visual layers and list the gaps.”
  • “Run a UX audit of the onboarding flow and tie each finding to a ux checklist item.”
  • “Re-run the chat surface audit and note what changed since the last example.”

Requirements

  • A checkout of the LobeHub repository
  • A rendered build of the surface for the visual and dynamic layers

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Jenifer Tidwell, Designing Interfaces — the pattern language for what a good
  2. The ux skill — LobeHub's execution checklists for how a flow

What it can do on your machine

Read from SKILL.md and the folder at commit 35d442e. 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.

    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 Surface Audit loads about 4.9k tokens when it runs, and up to ~89k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 2,535 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~4.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~89k

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,535 words (~4,915 tokens).

“A repeatable, standards-based UX review of one surface at a time. The benchmark is two things together:”

— opening of SKILL.md by lobehub, Custom licence
name
ux-audit
argument-hint
<page-or-surface> [--l1 | --l2 | --l3]

Read the full SKILL.md on GitHub

Files

SKILL.md and 31 other files (references) in .agents/skills/ux-audit of lobehub/lobehub.

  • SKILL.md
  • agents/openai.yaml
  • references/example/channel.md
  • references/example/chat-input-notice.md
  • references/example/chat.md
  • references/example/community-list.md
  • references/example/create.md
  • references/example/doc.md
  • references/example/eval.md
  • references/example/fleet.md
  • references/example/home-inbox-error.md
  • references/example/home.md
  • references/example/memory.md
  • references/example/onboarding.md
  • references/example/page.md
  • references/example/profile.md
  • references/example/resource.md
  • references/example/self-learning-create.md
  • … and 14 more

Open the folder on GitHubat commit 35d442e

Compare with similar skills

UX Surface Audit 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 Surface Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
UX Surface Audit this skilllobehub/lobehub83k—~4.9kAutomated safety check: PassCustom licence
Interface Design for Dashboards and Appsholaboss-ai/holaOS11k3 repos~6kAutomated safety check: PassMIT
Design Critiquegetcrew44/crew44356—~691Automated safety check: PassMIT
Product Design Workflow BundleXiaomiMiMo/MiMo-Code14k—~721Automated safety check: PassMIT
Om UX Review PRgo-musicfox/go-musicfox2.6k1 repos~1.4kAutomated safety check: NotesGPL-3.0
Design Reviewjezweb/claude-skills1.1k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Interface Design for Dashboards and Apps

    holaboss-ai/holaOS

    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

  • Design Critique

    getcrew44/crew44

    Walks an agent through five review passes on a screen, flow or mockup, then returns ranked findings with a severity and a suggested fix for each one.

    356 GitHub stars~691 tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed

  • Product Design Workflow Bundle

    XiaomiMiMo/MiMo-Code

    Entry point to a bundle of product design workflows covering context, research, audits, ideation, URL or image to code, design QA and sharing a prototype.

    14k GitHub stars~721 tokensUpdated today
    Frontend & DesignAuto-check passed

  • Om UX Review PR

    go-musicfox/go-musicfox

    Evidence-first design review of a PR's UI. An agent skill from go-musicfox/go-musicfox.

    2.6k GitHub starsUsed in 1 repo~1.4k tokens
    Frontend & DesignAuto-check: notes

  • Design Review

    jezweb/claude-skills

    Review a web app or page for visual design quality — layout, typography, spacing, colour, hierarchy, consistency, interaction patterns, and responsive behaviour.

    1.1k GitHub stars~2.1k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed

  • I Critique

    boussadjra/vuestrata

    Evaluate design effectiveness from a UX perspective. An agent skill from boussadjra/vuestrata.

    111 GitHub starsUsed in 4 repos~1.3k tokens
    Frontend & DesignAuto-check passed

More from lobehub/lobehub

All 50 skills in this repo

  • LobeHub Interactive Prototype

    lobehub/lobehub

    Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.

    83k GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Acceptance Evidence for Deliveries

    lobehub/lobehub

    Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.

    83k GitHub stars~9.7k tokensUpdated today
    Auto-check passed

  • Git Worktree Cleanup

    lobehub/lobehub

    Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.

    83k GitHub stars~2.8k tokensUpdated today
    Auto-check passed

  • LobeHub Alint Rule Set Maintenance

    lobehub/lobehub

    Maintains LobeHub's model-backed alint rule set: writing rules, removing false positives against real code, deciding warn versus error and tracking token cost.

    83k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

  • LobeHub Builtin Tool Authoring

    lobehub/lobehub

    Guides building LobeHub builtin agent tools, from the manifest and execution runtime to executors, chat UI renders and registry wiring.

    83k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

  • LobeHub Data Fetching Layers

    lobehub/lobehub

    Explains how LobeHub client code fetches data through services, SWR store hooks and cache keys, and when to avoid useEffect fetching or duplicated state.

    83k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Categories

Questions about UX Surface Audit

What does UX Surface Audit do?

Runs a repeatable UX review of one screen against the Designing Interfaces pattern language and LobeHub's ux checklists, using static, visual and dynamic layers. A UX audit covers one surface per run, because a full-app sweep is too much for a single pass, and the review is repeated per page as the product grows. The benchmark combines the pattern language from the book Designing Interfaces, which describes what a good interface is made of, with the ux skill's checklists for how a flow should behave.

When should I use UX Surface Audit?

UX Surface Audit fits situations like: reviewing one built screen against a pattern language before release; checking a page for missing empty, error and retry states in the code; capturing screenshots to judge hierarchy, spacing and responsive behavior; re-auditing a page after the product around it has grown.

How do I install UX Surface Audit in Claude Code?

Run `npx skills add lobehub/lobehub --skill ux-audit -a claude-code`. Or copy the skill folder (.agents/skills/ux-audit in lobehub/lobehub) into .claude/skills/ux-audit in your project. Claude Code loads it when a task matches its description.

How do I install UX Surface Audit in Codex?

Run `npx skills add lobehub/lobehub --skill ux-audit -a codex`. Or copy the skill folder (.agents/skills/ux-audit in lobehub/lobehub) into .agents/skills/ux-audit in your project. Codex loads it when a task matches its description.

Can I use UX Surface Audit 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 lobehub/lobehub --skill ux-audit -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, .gemini/skills/ux-audit, .github/skills/ux-audit and .opencode/skills/ux-audit in your project.

What does UX Surface Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: UX Surface Audit is instructions for the agent only. Our summary lists: A checkout of the LobeHub repository; A rendered build of the surface for the visual and dynamic layers.

Does UX Surface Audit 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 Surface Audit 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 Surface Audit use?

UX Surface Audit has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does UX Surface Audit use?

About 4.9k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 84k tokens, read only when the agent opens those files.

What are the alternatives to UX Surface Audit?

Skills that share tags, products or a category with UX Surface Audit: Interface Design for Dashboards and Apps (holaboss-ai/holaOS, 11k stars), Design Critique (getcrew44/crew44, 356 stars), Product Design Workflow Bundle (XiaomiMiMo/MiMo-Code, 14k stars) and Om UX Review PR (go-musicfox/go-musicfox, 2.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains UX Surface Audit?

lobehub (a GitHub organization) maintains it in lobehub/lobehub, which has 83,074 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 9, 2026.

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