Agent skill

UI UX Design Audit

by edonyzpc in edonyzpc/personal-assistant

Audit multi-surface UI/UX in the personal-assistant Obsidian plugin with the current PA framework, real interface evidence, structured scoring, adversarial finding verification, and product-decision…

AGPL-3.0Auto-check passedFrontend & Design

Install UI UX Design Audit

skills CLI
$ npx skills add edonyzpc/personal-assistant --skill ui-ux-design-audit -a claude-code

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

GitHub CLI
$ gh skill install edonyzpc/personal-assistant ui-ux-design-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/edonyzpc/personal-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ui-ux-design-audit .claude/skills/ui-ux-design-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
ui-ux-design-audit
GitHub stars
148
Token cost
~1.8k tokens
SKILL.md length
778 words
Files
2
Skills in repo
19
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Audit multi-surface UI/UX in the personal-assistant Obsidian plugin with the current PA framework, real interface evidence, structured scoring, adversarial finding verification, and product-decision…

  • Works in 5 steps: Bound the Audit → Observe and Score → Fan Out Broad Audits → …
  • Design retrospectives
  • SKILL.md covers Core Boundaries, Evidence Standard, Workflow and Artifacts, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

UI UX Design Audit is an agent skill from edonyzpc/personal-assistant. Audit multi-surface UI/UX in the personal-assistant Obsidian plugin with the current PA framework, real interface evidence, structured scoring, adversarial finding verification, and product-decision routing. Use for design retrospectives, visual quality baselines, cross-surface consistency audits, accessibility/mobile evaluations, or requests such as "帮我看看设计" and "audit the UI". Default to audit-only; implement findings only when explicitly requested, and require separate authorization for commit or archive…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Frontend & Design, covering UI design, Design review and critique and Retrospectives. It works with Obsidian. The repository describes itself as: A plugin that harnesses AI agents and streamlining techniques to help you automatically manage Obsidian. The licence is AGPL-3.0.

When your agent uses it

  • Design retrospectives
  • Visual quality baselines
  • Cross-surface consistency audits
  • Accessibility/mobile evaluations

Example prompts

  • “帮我看看设计”
  • “audit the UI”
  • “/ui-ux-design-audit”

Workflow steps

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

  1. Bound the Audit
  2. Observe and Score
  3. Fan Out Broad Audits
  4. Verify Findings
  5. Route Decisions and Fixes

What it can do on your machine

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

UI UX Design Audit loads about 1.8k tokens when it runs. Until then it costs about 156 tokens; SKILL.md has 778 words of instructions outside code blocks.

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

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 edonyzpc/personal-assistant at commit 4f02170, republished under its AGPL-3.0 licence (© edonyzpc). 778 words, ~1,766 tokens.

Download SKILL.mdSave it as .claude/skills/ui-ux-design-audit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ui-ux-design-audit
description
Audit multi-surface UI/UX in the personal-assistant Obsidian plugin with the current PA framework, real interface evidence, structured scoring, adversarial finding verification, and product-decision routing. Use for design retrospectives, visual quality baselines, cross-surface consistency audits, accessibility/mobile evaluations, or requests such as "帮我看看设计" and "audit the UI". Default to audit-only; implement findings only when explicitly requested, and require separate authorization for commit or archive actions. For review of a current code diff or PR, use `personal-assistant-review` instead.

UI/UX Design Audit

Core Boundaries

Default to audit-only:

  • Inspect, observe, score, verify, and report findings.
  • Do not edit runtime/product code unless the user explicitly asks to fix the verified findings.
  • Create or update a durable audit artifact only when the user asks for one; otherwise report in chat.
  • Do not commit or archive artifacts without separate explicit authorization.

Use this skill for cross-surface design quality. Route a current diff/PR review to personal-assistant-review, even when the diff is UI-heavy.

Read:

  1. AGENTS.md
  2. docs/product/pa-product-north-star.md
  3. docs/product/pa-low-burden-review-product-principles.md
  4. docs/development/workflows/pa-ui-ux-review-framework.md
  5. The source files and tests for the audited surfaces

Reuse the current PA framework before inventing a new instrument. Treat its four Layer A dimensions—Design Coherence, Visual Polish, Interaction Quality, and Content Clarity—as a PA adaptation, not a verbatim external framework. Research external frameworks only when the current instrument needs revision; use authoritative sources and preserve citations for adapted claims.

Evidence Standard

Separate evidence into three lanes:

LaneCan proveCannot prove alone
Source and testsState, lifecycle, copy, accessibility markup, CSS intent, product contractRendered visual quality or interaction feel
Runtime/DOMMounting, state transitions, computed structure, fresh console behaviorVisual polish or real user interaction by itself
Visible UILayout, hierarchy, contrast, clipping, focus, keyboard/touch flow, perceived burdenHidden code paths not exercised

Require obsidian-test-vault-smoke at full-ui tier before assigning visual or interaction scores. Capture the visible path, interaction, observed state, and screenshot evidence. If the app cannot be observed, mark those dimensions UNSCORED or BLOCKED; do not infer a score from source code.

Use obsidian-ios-real-device-smoke for claims about real iOS touch behavior. Do not generalize desktop evidence to mobile.

Workflow

1. Bound the Audit
  1. Confirm the requested surfaces, platforms, themes, and key user journeys.
  2. Inventory views, panels, modals, overlays, commands, settings, and navigation transitions in scope.
  3. Select only the framework dimensions relevant to the request.
  4. Define the evidence needed for every score before auditing.
2. Observe and Score
  1. Deploy and observe the real test-vault UI through obsidian-test-vault-smoke when visual or interaction scoring is requested.
  2. Trace each visible issue to source, CSS, state, or product-contract evidence.
  3. Score with the current PA framework. Use short evidence-backed rationales; do not manufacture numerical precision.
  4. Check the North Star explicitly:
    • capture friction
    • right-time return
    • quietness and ignorable states
    • source-backed trust
    • reversible maintenance and earned action
    • net review burden

For layered surfaces, use Mermaid for topology or flow diagrams. Use a Markdown table for the score heatmap.

3. Fan Out Broad Audits

If multi-agent tools are available and the audit is broad or the user asks for an agent team, partition surfaces across independent agents. Give every agent the same framework and different surfaces. If subagents are unavailable, run the same partitions locally.

Require this schema from each lane:

markdown
## Surface: <name>

### Evidence
- visible path and screenshot
- source/test anchors

### Scores
| Dimension | Score or UNSCORED | Evidence |
| --- | --- | --- |

### Findings
| Finding | Severity | Trigger | Suggested direction |
| --- | --- | --- | --- |

Add one cross-surface pass for terminology, design tokens, navigation, progressive disclosure, accessibility, and desktop/mobile consistency.

Show full SKILL.md (302 more words)Show less
4. Verify Findings

Verify every P0/P1/P2 finding against the actual source and the relevant visible flow before presenting it as confirmed.

Classify each finding:

  • CONFIRMED: the trigger and impact match the evidence
  • PARTIALLY CONFIRMED: the issue exists but scope or severity changes
  • FALSE POSITIVE: current source or observed behavior contradicts it
  • BLOCKED: required runtime/device evidence is unavailable

Recalibrate severity after verification. Do not force findings per surface or dimension.

5. Route Decisions and Fixes

End an audit-only request after verified findings, decisions, and validation gaps.

If the user explicitly asks to fix findings:

  1. Use personal-assistant-review-followup to classify and confirm the fix set.
  2. Ask before changing product semantics, visible capability, confirmation burden, information architecture, or review cadence.
  3. Route structural changes to sdd-lifecycle; do not reproduce the refactor workflow here.
  4. Implement only the approved fix set.
  5. Use personal-assistant-review on the resulting diff.
  6. Re-run the relevant full-ui flow and record before/after evidence.

Implementation authorization does not authorize commit, push, archive, or release actions.

Artifacts

  • Reuse docs/development/workflows/pa-ui-ux-review-framework.md; do not create a duplicate framework.
  • Follow docs/development/documentation-workflow.md when the user requests a durable audit report.
  • Keep an active audit package under docs/development/active/<audit>/ only while work is active.
  • Add unresolved follow-up to docs/backlog.md only when requested and avoid copying the full audit into the backlog.
  • Archive a completed report only when the user explicitly asks.

Output

Lead with verified findings ordered by severity. Include:

  • surface and user-visible trigger
  • score or UNSCORED, with evidence
  • source/test and visible-UI anchors
  • confirmation status and suggested direction
  • validation completed, blocked, and not run
  • decisions required before any fix

If there are no actionable findings, say ✅ OK and list only material evidence gaps.

  • personal-assistant-review: current diff/PR review
  • personal-assistant-review-followup: finding triage and approved fixes
  • sdd-lifecycle: structural design and implementation lifecycle
  • obsidian-test-vault-smoke: local full-UI evidence
  • obsidian-ios-real-device-smoke: iOS real-device evidence

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

Files

SKILL.md and 1 other file in .agents/skills/ui-ux-design-audit of edonyzpc/personal-assistant.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 4f02170

Compare with similar skills

UI UX Design 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.

UI UX Design Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
UI UX Design Audit this skilledonyzpc/personal-assistant148—~1.8kAutomated safety check: PassAGPL-3.0
Interface Design for Dashboards and Appsholaboss-ai/holaOS11k3 repos~6kAutomated safety check: PassMIT
Tastemaker UI Designcodeswithroh/tastemaker444—~16kAutomated safety check: PassMIT
UI Aesthetics Judgmentkasonye/ui-aesthetics-skill383—~3.2kAutomated safety check: PassNone
Agentos UI UXSapienXai/AgentOS118—~4.4kAutomated safety check: PassMIT
Distinctive UI Buildertw93/Waza7.2k—~3.7kAutomated safety check: PassMIT

Similar skills

  • 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
  • Tastemaker UI Design

    codeswithroh/tastemaker

    Grounds AI-built interfaces in real reference images and a saved personal taste profile, so UI work avoids the generic defaults of typical generated apps.

    444 GitHub stars~16k tokensUpdated 11 days ago
    Frontend & DesignAuto-check passed
  • UI Aesthetics Judgment

    kasonye/ui-aesthetics-skill

    Sets rules for web UI work that favor hierarchy, spacing and restrained styling, with routes for generating, reviewing and polishing interfaces.

    383 GitHub stars~3.2k tokensUpdated 5 mo ago
    Frontend & DesignAuto-check passed
  • Agentos UI UX

    SapienXai/AgentOS

    Design, review, or implement AgentOS UI and UX work using the project’s operator-console visual system.

    118 GitHub stars~4.4k tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed
  • Builds or restyles production UI with a clear point of view, checks the result against screenshots and responsive states, and hands document typography to other skills.

    7.2k GitHub stars~3.7k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Fix PR Design Notes

    different-ai/openwork

    Reads the advisory design review attached to a pull request's screenshots, fixes the flagged UI problems in product code, and proves each note is gone.

    24k GitHub stars~824 tokensUpdated today
    Frontend & DesignAuto-check passed

More from edonyzpc/personal-assistant

All 19 skills in this repo
  • Obsidian Dataview

    edonyzpc/personal-assistant

    Dataview plugin query syntax, inline expressions, DataviewJS API, and common vault analysis patterns.

    148 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Obsidian Test Vault Smoke

    edonyzpc/personal-assistant

    Validate Personal Assistant runtime and UI changes in the repo-local Obsidian test vault.

    148 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Obsidian Community Check

    edonyzpc/personal-assistant

    Trigger and inspect Obsidian Community checks for personal-assistant.

    148 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Pa Brat Beta Release

    edonyzpc/personal-assistant

    Manage Personal Assistant BRAT beta prerelease workflow. An agent skill from edonyzpc/personal-assistant.

    148 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Pa Docs Lifecycle Manager

    edonyzpc/personal-assistant

    Maintain PA task records and documentation lifecycle. An agent skill from edonyzpc/personal-assistant.

    148 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Personal Assistant Review

    edonyzpc/personal-assistant

    Review uncommitted or PR diffs in the personal-assistant Obsidian plugin with project-specific risk lanes, second-layer future-risk checks, severity discipline, subagent review routing, and…

    148 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Works with

Questions about UI UX Design Audit

What does UI UX Design Audit do?

Audit multi-surface UI/UX in the personal-assistant Obsidian plugin with the current PA framework, real interface evidence, structured scoring, adversarial finding verification, and product-decision…. UI UX Design Audit is an agent skill from edonyzpc/personal-assistant. Audit multi-surface UI/UX in the personal-assistant Obsidian plugin with the current PA framework, real interface evidence, structured scoring, adversarial finding verification, and product-decision routing.

When should I use UI UX Design Audit?

UI UX Design Audit fits situations like: design retrospectives; visual quality baselines; cross-surface consistency audits; accessibility/mobile evaluations.

How do I install UI UX Design Audit in Claude Code?

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

How do I install UI UX Design Audit in Codex?

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

Can I use UI UX Design 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 edonyzpc/personal-assistant --skill ui-ux-design-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/ui-ux-design-audit, .gemini/skills/ui-ux-design-audit, .github/skills/ui-ux-design-audit and .opencode/skills/ui-ux-design-audit in your project.

What does UI UX Design Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: UI UX Design Audit is instructions for the agent only.

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

UI UX Design Audit is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does UI UX Design Audit use?

About 1.8k tokens (SKILL.md is roughly 7.1k 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 UI UX Design Audit?

Skills that share tags, products or a category with UI UX Design Audit: Interface Design for Dashboards and Apps (holaboss-ai/holaOS, 11k stars), Tastemaker UI Design (codeswithroh/tastemaker, 444 stars), UI Aesthetics Judgment (kasonye/ui-aesthetics-skill, 383 stars) and Agentos UI UX (SapienXai/AgentOS, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains UI UX Design Audit?

edonyzpc (a GitHub user) maintains it in edonyzpc/personal-assistant, which has 148 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 10, 2026.

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