What is ux-skill?
ux-skill is an open-source design engine by Laith Aljunaidy, installed with pip as uxskill. Given a project brief, it recommends a style, palette, type pairing and components, then lints the generated code against 171 deterministic rules. It runs offline with no LLM calls and installs into 17 coding tools.
ux-skill is a design-intelligence engine for AI coding tools. It ships as a Python package, as a plugin for Claude Code and as a multi-installer that targets 17 tools. The README describes it as offline, free, MIT-licensed and free of LLM calls.
Instead of letting the agent improvise a page, the engine takes a brief with industry, audience, tone and stack, and returns a deterministic recommendation. The same input always produces the same output.
What changes in your agent's output
- The agent works from a recommended style, palette, type pairing and set of components rather than its own default look.
- A linter with 171 rules checks the generated code, and with a CI flag it exits non-zero on Critical or High findings.
- The design system builder writes tokens.css, tokens.json and a plain-language system report from one brand color.
- Text, control and focus color pairs are measured against WCAG thresholds before a system is written; a failing system is not written.
Who it is for and who it is not for
Best for
- Developers shipping landing pages or products with an AI coding agent who want checkable rules.
- Teams that need a CI gate on generic AI-looking output.
- Projects that need right-to-left and Arabic text handled, which the README says is built in.
Not for
- Someone who wants one short SKILL.md. This is a package with a CLI, data manifests and sub-agents; frontend-design is the single-file route.
- Matching a Figma file pixel for pixel. Its inputs are a brief and brand values, not a design file.
- Teams who dislike Python tooling, since the engine needs Python 3.10 or newer.
Use it with UiChemy
ux-skill shapes how the page looks and checks the code. When the finished build has to become an editable WordPress page, UiChemy AI to WordPress imports an existing AI build. Click Get Started on uichemy.com.
How to install ux-skill: Design Intelligence Engine for AI Coding Agents
pip install uxskillThe MCP server needs the extra: pip install 'uxskill[mcp]'.Install the package
Run the command above with Python 3.10 or newer. The README also documents pipx and an npx wrapper that bootstraps through pipx.
Detect your tool
Run uxskill init. The README says it auto-detects your IDE and installs the right artifact.
Or use the Claude Code plugin
In Claude Code, run /plugin marketplace add Laith0003/ux-skill, then /plugin install ux@ux-skill, then /ux-init.
Lint a project
Run uxskill lint . in your project folder to scan it against the anti-pattern rules.
Check that it loaded
Run uxskill stats. It should print JSON with the version and the manifest counts, including 171 anti-patterns.
Key features
- Brief to recommendationIndustry, audience, tone, stack and region go in; a style, palette, type pairing, motion presets and components come out, the same every time for the same input.
- 171-rule linterEach rule is a pattern, and many add a check on parsed CSS and markup so a match counts only in its context. It runs without network access.
- CI and pre-commit useThe README shows a lint run that fails the build on high findings, plus a staged-files hook for pre-commit.
- Design system builderOne command turns a brand color and a brief into tokens.css, tokens.json, font files and a system report.
- WCAG gatePairings are measured at standard and high contrast. A system that fails is not written, and the message says what to change.
- 18 slash commandsCommands cover discovery, page and component generation, audit, polish and fix loops, copy, motion and accessibility.
- 12 data manifestsQueryable JSON for styles, palettes, type pairings, components, industries, charts, stacks, UX laws, motion presets and brand specs.
- Five sub-agentsFrontend, motion, copy, research and design-system roles, each with a dispatch protocol in the README.
- MCP serverAn optional extra exposes 25 tools, including one that builds the design system and returns the gate result.
- Seventeen tool installerThe init command detects your IDE and installs the matching artifact. The README lists Cursor, Windsurf, Cline and Codex among the targets.
Frequently asked questions
What is ux-skill?
ux-skill is an open-source design-intelligence engine for AI coding tools, published as the uxskill Python package. It recommends a design system from a brief, builds tokens with a WCAG check, and lints generated code against 171 anti-AI-slop rules. The README says it runs offline and never calls an LLM.
How do I install ux-skill?
Run pip install uxskill with Python 3.10 or newer, then uxskill init to detect your IDE. The README also documents pipx, an npx wrapper, and a Claude Code route through the plugin marketplace. Run uxskill stats afterwards to confirm the version and manifest counts.
Does ux-skill work in Cursor, Windsurf, Cline and Codex?
The README says it ships into 17 tools and names Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Codex, Kiro, Cline and others. The init command picks the right artifact for each. Behaviour inside a given tool depends on that tool, so test it on a small page first.
What does the anti-AI-slop linter check?
It applies 171 rules covering patterns the README ties to generic AI output, such as purple-to-blue gradients, three equal cards and default 300ms transitions. Many rules inspect parsed CSS and markup. The README says a lint run can fail a CI job on high findings.
Is ux-skill free?
Yes. The repository is MIT licensed, and the README describes the engine as free and offline. It needs no API key for the engine itself. Your coding agent and its own access are separate. The optional MCP server needs an extra Python install.
What is the design system builder?
A command that takes one brand color and an optional brief, then writes tokens.css, fonts.css, tokens.json and a system report. It measures color pairings against WCAG thresholds first and refuses to write a failing system. The README says it will not overwrite a differing file without a force flag.
How is ux-skill different from frontend-design?
frontend-design is a single SKILL.md that guides the agent through a plan-first process. ux-skill is a larger package with a CLI, a linter, data manifests and an MCP server. The first suits a quick start; this one suits teams that want checks in CI. For another rule pack with commands, see UX UI Agent Skills.
Can ux-skill build a WordPress site?
No. It produces design decisions and front-end code. To bring an AI build into WordPress as an editable page, UiChemy AI to WordPress imports it. Click Get Started on uichemy.com to begin. For a design review step first, see UI UX Pro Max.


