flawless-ui-ux skill

A skill and CLI for interfaces: build, redesign and review around a product's audience, content and identity

  • 232 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • The CLI launches Chromium through Playwright and opens your dev server address
  • The installer copies skill files into the chosen agents' directories
All reasons and checks

smokeeaasd/flawless-ui-ux

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/flawless-ui-ux

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The CLI launches Chromium through Playwright and opens your dev server address
  • The installer copies skill files into the chosen agents' directories

This is third-party code. Review the repository files before installing.

What it does

flawless-ui-ux is a skill for interface design and implementation with a CLI that checks the result. The skill ties product context to composition, typography, color, density, imagery and interaction; separate reference files support creation, redesign, refinement and review in your stack. Refinement develops the interface's character, and generic copy and repetitive decoration are reviewed in context. The CLI gathers evidence: context reads project context, inspect analyzes selected files or a running interface, verify compares a run with a saved one. Checks cover accessibility through axe (contrast and accessible names), font sizes and horizontal overflow at sampled widths, broken images and JavaScript errors. The agent makes the edits; the CLI only records what was checked. The installer asks for scope (project or global) and agents, and flags such as --codex or --claude-code pick a target directly.

Who it is for. Developers and designers who build or redo interfaces with an agent and want to verify results with measurements.

Good fit when

  • A landing page or dashboard is built from scratch for a specific audience and content
  • An account screen is redone for mobile while keeping the palette and behavior
  • You want a dashboard reviewed for readability, navigation and accessibility without editing files
  • Before release you compare the interface before and after edits against a saved run

Not a fit when

  • You need backend or infrastructure work: the skill targets interfaces
  • There is no browser to check a running interface: the CLI then stays with source files
  • You want a fully automatic redesign without an agent: the CLI edits nothing itself

Example request

Use flawless-ui-ux to build a finance dashboard for freelancers, then check it for readability and accessibility

Limitations

The CLI needs Node.js 22.12 or newer. Checking a running interface requires Playwright's Chromium (npx playwright@1.64.1 install chromium) and the address of a running dev server. Checks cover selected axe rules and sampled widths, so they do not amount to a full accessibility audit. Missing confirmed targets and changed conditions are left unverified by the CLI.

How to disable. Delete the flawless-ui-ux skill folder from the agent's skills directory where the installer placed it. Check reports live in the directory you passed to --output.

FAQ

Which agents does it work with?

The installer supports Codex, OpenCode, Antigravity, Kiro, Cursor, Kilo Code, GitHub Copilot, Claude Code, Pi, Grok, Devin, DeepSeek and more. In Codex the skill is invoked as $flawless-ui-ux, in hosts with slash commands as /flawless-ui-ux.

What does inspect check?

Selected axe rules for contrast and accessible names, font sizes and horizontal overflow at sampled widths, broken images, uncaught JavaScript errors, repeated phrases and arrow cues in copy.

How do I compare before and after?

Run inspect with --url and --output for a baseline, make edits and call verify with the run.json file. Findings split into persistent, new and no-longer-observed.

Can I only review without edits?

Yes. A request such as reviewing a dashboard for readability, navigation and accessibility without editing files runs review mode: the skill reports findings and edits nothing.

How do I install for a single project?

Run npx flawless-ui-ux install --project ./app. For a personal install add --global, and for several agents list flags such as --codex --devin.

Discussion

No questions or reviews yet.

Skills

A UI design skill: art direction per product, a shared DESIGN.md, tokens, and layout and accessibility checks in a browser.

SkillExtended access51Repository stars

Skills for design engineers: quick UI cleanup, accessibility, metadata and animation performance fixes

SkillMinimal access11KRepository stars

A skill and CLI for agents: UI without the templated look, 25 commands, rule-based anti-slop checks and a 0 to 100 quality score

SkillExtended access452Repository stars

A skill for interfaces without the generic AI look: typography, color, motion, component states and a critique of the result.

SkillMinimal access95Repository stars

A skill with 2026 UX and UI principles: WCAG 2.2, forms, mobile, AI chat, dark patterns and 25 reference files

SkillMinimal access98Repository stars

A Codex skill: three distinct visual concepts, screenshot review and cutting excess, so interfaces look less templated.

SkillMinimal access137Repository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialRepository starsMain difference
flawless-ui-ux (this card)no232
UI UX Pro Maxno148,899a base of styles and palettes, while flawless-ui-ux adds a CLI check of a running interface
Impeccableno108,873review and polish commands, here the focus is before-and-after run comparison

README in short

The README starts with the skill's jobs, then shows a one-command install for npm, pnpm and Bun, sample requests (create, redesign, refine, review), how it works and CLI commands with a table of collected evidence. The project docs are listed below and evaluation cases live in evals.

README badge

Original SKILL.md

---
name: flawless-ui-ux
description: Create, redesign, refine, or review web interfaces with product-specific visual design and usable interactions.
---

# Flawless UI/UX

Translate product intent into specific visual decisions. Quality combines functioning behavior, accessibility, identity, and finish. Build richness through hierarchy, proportions, rhythm, imagery, and detail suited to the product.

## Work directly

Inspect the requested target, surrounding components, content, and available assets. Establish what the user needs to understand or do, what may change, and which facts and behaviors must remain. Ask only when an unresolved fact materially changes the scope, identity, or outcome.

- **Create:** build the requested surface and interactions; inherit the surrounding system when one exists.
- **Redesign:** replace authorized visual decisions while preserving required content and behavior.
- **Refine:** develop the existing intention; preserve everything outside the requested intervention. Keep wording fixed in visual-only work and presentation fixed in copy-only work.
- **Review:** report prioritized findings without changing project files. Planning delivers a proposal rather than an implementation.

Make a coherent composition from the actual material: choose what leads, how supporting information relates, and how the main action works. Select typography, color, density, imagery, and detail together. Carry that treatment through the whole target. A short brief still permits confident design choices; routine work can proceed without a written brief, concept presentation, or separate planning artifact.

Use the project's stack and implement the requested behavior. Add interface elements because the task needs them, rather than creating extra product features to fill a conventional layout.

## Use references for a decision

For a new visual direction, start with [Direction](references/direction.md). For existing work, the entry point and project context may suffice. Otherwise read the relevant section below when it answers a concrete question; this table is not a reading sequence. Reuse material already read.

| Question | Reference |
|---|---|
| How should navigation, records, forms, or content work together? | [Product structure](references/structure.md) |
| How should type, spacing, color, imagery, or responsive layout be executed? | [Craft](references/craft.md) |
| How should controls, feedback, keyboard access, and states behave? | [Interaction](references/interaction.md) |
| What should change in a broad visual refinement? | [Calibration](references/calibration.md) |
| Which recurring patterns need inspection? | [Contextual prevention](references/anti-slop.md) |
| Would a worked composition clarify the design? | The relevant [design study](references/design-studies.md) |
| Is a critique or deeper diagnosis needed? | [Review](references/review.md) |

## Check the result

Observe the primary task, affected states, and wide/narrow layouts with available tools. Check hierarchy, readable content, navigation, and overflow as well as calculations and controls.

Before delivering a creation or redesign, read and perform the [final pattern pass](references/anti-slop.md#final-pass) on the completed target. For refinement, apply its affected checks within the authorized scope. Inspect actual copy and icons in source even when rendering is unavailable; correct observed repetition rather than merely claiming a review.

Measure contrast against actual backgrounds. Run relevant project checks and meaningful tests; repeat affected checks after corrections. If rendering is unavailable, continue useful source work and state the limit. Static checks cannot establish visual quality.

When the local CLI is available, use [executable inspection](references/inspection.md) for scoped evidence and corresponding verification. Read its coverage; contextual signals still require judgment.

Report a problem