Agent Skills that make coding agents design distinctive frontends, using art direction, real photos and a browser self-check instead of generic AI landing pages.
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
Install the skill into your project with npm
npx flawless-ui-ux@latest install - 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
A set of 24 open-source agent skills that steer Claude Code, Codex, Cursor and opencode toward less generic, more deliberately designed UI output.
An interface design skill for AI agents that explores distinct design directions, compares them side by side, and refines them against real screenshots.
Rules and skills that make an AI coding agent avoid generic-looking UI, marketing copy, and AI-styled code comments.
An agent skill and CLI that teach AI coding agents to produce polished, production-quality UI instead of generic AI-looking interfaces.
An agent skill that gives coding agents like Claude Code and Cursor design judgment to generate and iterate on UI, slide decks, and graphics.