Repolode
educlopez

educlopez/ui-craft

An agent skill and CLI that teach AI coding agents to produce polished, production-quality UI instead of generic AI-looking interfaces.

Stars
435
Forks
23
Open issues
3
Last commit
22 hours ago

What is it?

UI Craft is a design engineering system for AI coding agents. It packages opinionated interface design rules, a set of slash commands for building, reviewing and polishing screens, and deterministic checks that flag common AI-generated UI patterns such as purple gradients, bounce easing and identical card grids. It is stack-agnostic and adapts to Tailwind, CSS Modules, styled-components, vanilla CSS and single-file component styles.

It can be installed through a cross-platform Go CLI (`ui-craft install`), as a Claude Code plugin, as a Cursor plugin, or via the Agent Skills spec for other harnesses. The CLI writes skill, commands, MCP quality gates and review agents into each harness's native config, with backups and rollback. Build surfaces such as dashboards, landing pages and auth screens are guided by named composition recipes and an acceptance checklist.

The companion `ui-craft-detect` package is a zero-dependency scanner with 43 rules covering anti-patterns, accessibility, forms and placeholder copy. It can scan local source, a live URL, or only changed lines, and can install edit-time hooks for Claude Code and Cursor as well as pre-commit and GitHub Actions workflows.

Key features

  • 01Design rules and craft guidance that steer AI agents toward hierarchy, restrained motion and project-specific tokens.
  • 02Slash commands for building, critiquing, polishing and animating individual surfaces.
  • 03Named recipes for dashboards, landing pages and auth screens with a pre-ship acceptance bar.
  • 04Cross-harness installer for Claude Code, Cursor, Codex, Gemini and OpenCode with backup and rollback.
  • 05Zero-dependency detector with 43 anti-pattern, accessibility and copy rules, usable in CI or git hooks.

Use cases

  • Having an AI coding agent build dashboards or marketing pages that look production-ready on the first pass.
  • Reviewing an existing frontend for generic AI patterns and accessibility gaps before merging.
  • Adding a CI gate that fails pull requests only when they introduce new UI anti-patterns.
  • Standardizing design decisions across sessions with a persisted brief and design tokens.

Quick start

  1. 1

    Install the ui-craft CLI with Homebrew (macOS)

    brew install --cask educlopez/tap/ui-craft
  2. 2

    Run the official install script for your OS from the README (macOS/Linux or Windows)

  3. 3

    Detect your AI coding harness and wire up the skill, commands, and gates

    ui-craft install
  4. 4

    In your agent, ask for a surface using the craft command

Things to know

  • macOS on Intel is built and published but never tested.
  • Linux arm64 and Windows arm64 binaries are built but not exercised in CI.

In collections

Topics

FAQ

What is ui-craft?
An agent skill and CLI that teach AI coding agents to produce polished, production-quality UI instead of generic AI-looking interfaces. UI Craft is a design engineering system for AI coding agents. It packages opinionated interface design rules, a set of slash commands for building, reviewing and polishing screens, and deterministic checks that flag common AI-generated UI patterns such as purple gradients, bounce easing and identical card grids. It is stack-agnostic and adapts to Tailwind, CSS Modules, styled-components, vanilla CSS and single-file component styles.
Is ui-craft free to use? What license does it have?
ui-craft is open source under the MIT license. Check the license terms before using it in commercial products.
Is ui-craft still maintained?
Actively maintained. The last commit to ui-craft was on Nov 6, 2026.
What can I use ui-craft for?
Having an AI coding agent build dashboards or marketing pages that look production-ready on the first pass. Reviewing an existing frontend for generic AI patterns and accessibility gaps before merging. Adding a CI gate that fails pull requests only when they introduce new UI anti-patterns. Standardizing design decisions across sessions with a persisted brief and design tokens.
How do I install ui-craft?
Install the ui-craft CLI with Homebrew (macOS): brew install --cask educlopez/tap/ui-craft Run the official install script for your OS from the README (macOS/Linux or Windows) Detect your AI coding harness and wire up the skill, commands, and gates: ui-craft install In your agent, ask for a surface using the craft command
Where can I get ui-craft?
The source code and installation instructions are on GitHub: https://github.com/educlopez/ui-craft

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

Related projects