improve-ui

Audit product surfaces against design evidence and write implementation plans for UI fixes.

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/Mjlike123/ui-prototype-workbench --skill improve-ui-mjlike123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-ui
Source: https://github.com/Mjlike123/ui-prototype-workbench/tree/main/.agents/skills/improve-ui
Command: npx skills add https://github.com/Mjlike123/ui-prototype-workbench --skill improve-ui-mjlike123

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams struggle to identify genuine UI inconsistencies without false positives, and design feedback often lacks the evidence needed for another engineer or agent to act on it. This Skill audits a product surface against its governing design system, proves each finding with contract, runtime, and correction evidence, and produces self-contained implementation plans. ## Core Features & Use Cases - Evidence-based UI audit: Traces rendered paths through components, tokens, and variants, then keeps only findings backed by a binding design contract, a proven runtime relationship, and a deterministic correction. - Read-only safety: Never modifies product source, installs dependencies, or commits changes; all output is written under design-plans/. - Self-contained implementation plans: Generates one plan per selected change using a structured template covering evidence chain, reuse of existing tokens and components, validation steps, and stop conditions. - Use Case: Ask it to review your app's settings page for design-system drift; it reports up to three verified findings with confidence levels, then writes a handoff plan another agent can execute without any prior context. ## Quick Start Use the improve-ui skill to audit the primary product surface, identify supported UI problems, and recommend what to improve first without modifying anything.

Frequently Asked Questions about improve-ui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a UI for design system inconsistencies?

Select one coherent product surface, trace its rendered path through components and tokens, then check each candidate issue against a documented design contract. This Skill automates that workflow and reports only findings with contract, runtime, and correction evidence.

How to prepare a design handoff plan for another developer or agent?

Write one plan per selected change using a template covering the evidence chain, reusable tokens and components, exact file changes, validation steps, and stop conditions. The plan must be self-contained so the executor needs no prior conversation context.

Does this UI audit modify my source code?

No. The audit is strictly read-only on product source. It never installs dependencies, runs formatters, commits, or edits files outside the design-plans directory, and it offers plans instead of implementing fixes directly.

What kinds of UI issues are out of scope for a design audit?

Functional bugs, broken routes, data wiring, performance, accessibility semantics, and code-quality issues are discarded unless the user explicitly requests them or a documented design contract governs them. Only visual, copy, layout, and styling findings qualify.

Why does the audit report no findings even when the UI looks inconsistent?

Repetition, naming similarity, or implementation differences are only candidates, not findings. A finding survives only when a binding design rule governs that property, the runtime path is proven, and exactly one correction is supported by evidence.