improve-ui

Audit product interfaces against design evidence and write implementation plans.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill improve-ui-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-ui
Source: https://github.com/Chia1104/agent-air/tree/main/skills/shared/improve-ui
Command: npx skills add https://github.com/Chia1104/agent-air --skill improve-ui-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? UI reviews often produce vague, unsupported opinions or changes that break a product's identity. This Skill audits a product surface strictly against its own governing design system, so every reported problem is backed by cited evidence and every fix reuses existing tokens, components, and patterns. ## Core Features & Use Cases - Evidence-gated UI audit: Traces the rendered path of one coherent surface, reconstructs its local design system, and keeps only findings that pass contract, runtime, and correction proofs. - Read-only safety: Never modifies product source, installs dependencies, or commits changes; output is limited to a findings report and plan files under design-plans/. - Self-contained implementation plans: Writes one plan per selected change using a structured template covering evidence chain, reuse, scope, validation, and stop conditions, so another agent can execute without prior context. - Use Case: Ask it to review your app's settings page. It traces the routes and components, checks them against your DESIGN.md and tokens, reports up to three verified inconsistencies (e.g., a button variant that bypasses the documented primitive), and drafts a handoff plan for the fix you choose. ## Quick Start Use the improve-ui skill to audit the main dashboard surface for design-system drift and report supported findings without changing any code.

Frequently Asked Questions about improve-ui

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

FAQPage Schema
Why does the audit report fewer than three findings?▼

Findings must survive a falsification pass where every cited source is re-opened and counterevidence is checked. Candidates with ambiguous corrections, multiple valid fixes, or unproven runtime connections are deleted before reporting.