Repolode
smokeeaasd

smokeeaasd/flawless-ui-ux

A UI/UX design skill for coding agents that guides building, redesigning, and reviewing interfaces, plus a CLI that inspects running pages for accessibility and layout issues.

Stars
80
Forks
1
Open issues
0
Last commit
yesterday

What is it?

flawless-ui-ux is a skill package that gives coding agents such as Codex, Claude Code, OpenCode and Cursor design guidance for interfaces. It connects product audience, content and identity to composition, typography, color, density and interaction, and it covers creating new screens, redesigning existing ones, refining details and reviewing work without editing files.

The project also ships an npm CLI. It collects project context, inspects selected source files or a running development server with a headless browser, and reports accessibility contrast and naming issues, computed font sizes, horizontal overflow, broken images and uncaught JavaScript errors. A saved baseline can be re-run after changes to separate persistent, new and resolved findings.

Installation copies the skill into the project or global directories of the supported agents, and requires Node 22.12 or newer. The CLI checks are sampling tools and do not establish full WCAG conformance or visual quality.

Key features

  • 01Guides creating, redesigning, refining and reviewing interfaces within an existing stack
  • 02Installs into project or global directories for twelve supported coding agents
  • 03Inspects source files and running pages for accessibility and layout issues
  • 04Compares saved baselines to separate persistent, new and resolved findings
  • 05Runs an interactive installer or explicit flags for scripted use

Use cases

  • Asking a coding agent to build a new landing page or dashboard with a clear visual direction
  • Reviewing an existing screen for readability, navigation and generic repeated patterns
  • Checking a local dev server for contrast failures and horizontal overflow at mobile widths
  • Verifying that a round of UI fixes did not leave the same issues behind

Quick start

  1. 1

    Install the skill into your project with npm

    npx flawless-ui-ux@latest install
  2. 2

    Ask your coding agent to build or review an interface using the skill

Things to know

  • Requires Node 22.12 or newer.
  • Running the browser-based inspection needs a Playwright Chromium install.
  • Inspection samples only a few viewports and does not establish full WCAG conformance.

In collections

Topics

FAQ

What is flawless-ui-ux?
A UI/UX design skill for coding agents that guides building, redesigning, and reviewing interfaces, plus a CLI that inspects running pages for accessibility and layout issues. flawless-ui-ux is a skill package that gives coding agents such as Codex, Claude Code, OpenCode and Cursor design guidance for interfaces. It connects product audience, content and identity to composition, typography, color, density and interaction, and it covers creating new screens, redesigning existing ones, refining details and reviewing work without editing files.
Is flawless-ui-ux free to use? What license does it have?
flawless-ui-ux is open source under the MIT license. Check the license terms before using it in commercial products.
Is flawless-ui-ux still maintained?
Actively maintained. The last commit to flawless-ui-ux was on Nov 6, 2026.
What can I use flawless-ui-ux for?
Asking a coding agent to build a new landing page or dashboard with a clear visual direction Reviewing an existing screen for readability, navigation and generic repeated patterns Checking a local dev server for contrast failures and horizontal overflow at mobile widths Verifying that a round of UI fixes did not leave the same issues behind
How do I install flawless-ui-ux?
Install the skill into your project with npm: npx flawless-ui-ux@latest install Ask your coding agent to build or review an interface using the skill
Where can I get flawless-ui-ux?
The source code and installation instructions are on GitHub: https://github.com/smokeeaasd/flawless-ui-ux

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects