What is the flawless-ui-ux skill?
flawless-ui-ux is a UI and UX design skill plus a local inspection CLI for coding agents. The skill guides layout, typography, color and interaction through 26 selectively loaded references, while the CLI checks source and rendered pages and compares results before and after your fixes.
flawless-ui-ux is a UI and UX design skill and a local inspection CLI. It helps agents create, redesign, refine and review interfaces around a product's audience, content and identity, for web, native mobile and desktop.
For new interfaces and broad redesigns, the agent considers at least three meaningfully different compositions internally before it builds. Focused refinements keep the scope and decisions you already made.
What the CLI adds to the skill
- Inspects selected source files and running pages, then reports findings with evidence.
- Checks selected axe contrast and accessible-name rules, text sizes, horizontal overflow, broken images and uncaught JavaScript errors.
- Samples 1440 by 900 and 390 by 844 viewports by default; you can pass others.
- Saves a baseline, then verify separates persistent, new and no-longer-observed findings after your fixes.
- Optional HTML report with findings, coverage and captured screens.
Who flawless-ui-ux is for
Best for
- Developers who want an agent to redesign or review a screen and then prove what changed.
- Teams that keep product facts in Markdown and want the agent to reuse them across tasks.
- Projects that pair this with critique style reviews before release.
Not for
- A full accessibility sign-off. The README says the samples do not establish WCAG conformance or complete keyboard journeys.
- Teams without Node 22.12 or newer, which the CLI requires.
- Native app verification. The rendered checks cover browser interfaces only.
Use it with UiChemy
Run the review on the page your WordPress build produces. Pages made with UiChemy Composer or imported from an AI build are real markup, so the inspection checks what visitors load. Click Get Started on uichemy.com.
How to install Flawless UI UX Skill: Design Guidance and Inspection CLI
npx flawless-ui-ux@latest installThe README also documents a skills CLI route and a Bash installer for checkouts. Requires Node 22.12 or newer.Run the installer
From your project directory run the command. In a terminal you choose project or global scope, select agents and confirm destinations before anything is copied.
Or name the agent
Use flags such as --codex, --claude-code --global or --project ./app. The yes flag skips the menu and installs for all supported agents in the project.
Prepare a browser
For rendered checks run npx [email protected] install chromium once, then inspect your dev-server URL.
Invoke the skill
Describe the interface and name flawless-ui-ux. Start a new session after install if discovery needs to refresh.
Check that it loaded
Run npx flawless-ui-ux@latest doctor for your agent. It reports installed paths, recorded versions, modified copies and a browser launch check.
Key features
- Product-aware design guidanceConnects product context to composition, typography, color, density, imagery and interaction instead of applying a fixed style.
- 26 selective referencesDecision procedures for typography, layout, color, tables, charts, forms, state transitions, copy, motion, performance and platform conventions load only when needed.
- Worked casesTen original cases connect diagnosis to implementation, including eight web studies that run without a build step.
- Multi-composition thinkingNew interfaces and broad redesigns weigh at least three different compositions before one is chosen.
- Source and browser inspectionThe inspect command reads selected files and a running URL, and records what was actually checked.
- Verify after fixesCompares a saved run against the same scope and separates persistent, new and no-longer-observed findings.
- Context filesOptional product and design Markdown, created by the init command, that the agent reads back with the context command.
- Flow checksAn explicit flow file can exercise defined UI actions and named states in a permitted test environment, with network writes and popups blocked.
- Honest scope limitsFindings support review; the README says they are not a design score or full accessibility certification.
Frequently asked questions
What is flawless-ui-ux?
It is a UI and UX skill for coding agents with a local inspection CLI. The skill guides layout, typography, color and interaction, and the CLI inspects source and running interfaces so the agent can find issues and verify corrections.
Which agents does flawless-ui-ux support?
The README lists twelve supported agents, including Codex, OpenCode, Antigravity, Kiro, Cursor, Kilo Code, GitHub Copilot CLI, Claude Code, Pi, Grok Build, Devin CLI and DeepSeek Harness. Hosts that read the agents skills folder share one project copy.
How do I install flawless-ui-ux?
Run npx flawless-ui-ux@latest install in your project and follow the prompts, or pass an agent flag. Node 22.12 or newer is required. A separate update command refreshes copies already installed, and doctor checks them.
Does it give me an accessibility score?
No. It checks selected axe contrast and accessible-name rules, text size and overflow. The README states these samples do not establish full WCAG conformance, complete keyboard journeys or visual quality, so manual testing is still needed.
Does the CLI change my files?
No. Inspection does not edit files, start servers or download browsers. Your agent makes the changes, and the CLI provides observations. Ordinary inspection also does not perform UI actions or submit forms.
Can it review a page and compare before and after?
Yes. Save an inspection with an output folder, fix the issues, then run verify on the saved run. It reports findings as persistent, new or no longer observed, and marks changed conditions as unverified.
What are good companions?
Pair it with critique for heuristic feedback, a11y-ally for deeper WCAG audits with axe-core and Lighthouse, and design-token-audit when you need hard-coded values found. ui-ux-pro-max is a data-driven alternative if you want searchable style data instead of references.


