ux

ux-skill: the design intelligence engine for Claude Code, Cursor, and every other AI coding tool
**A design-intelligence engine that makes AI-generated UI distinctive instead of generic.** Drop it into any of 17 AI coding tools and your output stops reading as AI-built. Free, MIT, offline, no LLM.
**Star ux-skill on GitHub** if this is useful, it is the single cheapest way to help the project. New here? Start with the 60-second tour or see it live at uxskill.laithjunaidy.com.
*Before: generic stock-photo SEO slop. After: real construction-photo hero under a dark scrim, editorial headline with an amber accent, quote form in the hero. Same AI coding tool, same prompt, different result when ux-skill supplies the constraints.*
> **v3.1.0, THE BRAIN, now brand-true + responsive.** The strongest UX plugin for AI coding. A Python reasoning core with a deterministic 7-axis synthesizer, 12 queryable JSON manifests (84 styles, 176 palettes, 70 type pairings, 148 components, 184 industries, 35 chart types, 57 motion presets, 112 UX laws, 152 anti-pattern rules, 25 tech stacks, 160 brand specs), 25 slash commands, 5 sub-agents, 18 MCP tools, and a deterministic anti-AI-slop linter. Cross-IDE: ships into Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Codex, Kiro, Cline, Continue, Aider, Zed, JetBrains AI, Pieces, Tabby, Tabnine, CodeWhisperer, and Roo Cline.
> **The brand name is ux-skill.** The PyPI / npm package name stays uxskill. The GitHub repo lives at Laith0003/ux-skill.
**Author:** Laith Aljunaidy, designer and CTO in Amman · **Site:** uxskill.laithjunaidy.com · **Compare vs every Claude UX plugin:** compare.html · **GitHub:** Laith0003/ux-skill · **PyPI:** uxskill · **npm:** uxskill
New in v3.1: brand-true, responsive, alive
- **Brand fidelity is enforced, not hoped.** The primary color is read from the LOGO's pixels (not the most-painted CSS); default fonts are rejected for the logo's letterform style. The extracted brand travels recommend -> synthesize, and a **hard floor** in evaluate FAILS any output that drops the brand color/logo or ships no real imagery. Two-way interop with the open brand.md convention (render + ingest).
- **Mobile-first, gated.** New craft foundations (responsive.md, component-behaviors.md) plus a wrap-aware gate that fails on horizontal scroll, a wrapping nav/wordmark/button label, or an over-tall sticky header.
- **The wow layer.** The engine derives 2-3 coordinated signature moments per page, the "wow can only come from the user" doctrine is overturned.
- **Sharper linter** (152 rules): imagery-mandatory + icon-only detection, placeholder-token and 100vw rules; seeded picsum kept, random stripped.
Tests **310 passing**. Offline. Deterministic. No LLM ever called. Full notes in CHANGELOG.md.
What's new in v3
- **Brand specs become training data, not templates.** The 160 brand specs are no longer a catalogue the recommender picks from, they're vocabulary the synthesizer distills from. Output is novel every call.
- **7-axis synthesizer** (warmth, contrast, density, geometry, formality, motion, type_personality). Briefs map deterministically to axis values; axis values compile to fresh palette + type + spacing + radius + motion tokens.
- **Three auto-dispatched modes**: strict_brand (100% of one brand), brand_anchor (70% one brand + 30% axis-adapted siblings), pure_synthesis (no brand named, distill from 8 axis-matching exemplars).
- **Decisions ledger drives the recommender.** .ux/decisions.jsonl re-ranks candidates by past wins in the same (industry, ui_type) bucket. Cold-start safe. Counts only lint_score >= 80 + user_accepted = true decisions.
- **Axis interaction matrix**: explicit conflict resolution between competing axes (dense + corporate → 4px, airy + corporate → 12px, soft + playful → 18px radius). No more silent ad-hoc rules.
- **/ux-evolve auto-loop**: lint → polish → re-lint until score ≥ 90 or plateau or 5 rounds. Quality gate at 65.
- **3 new MCP tools** (15 → 18): ux_synthesize, ux_decisions_query, ux_decisions_stats.
- **Local stats dashboard**: uxskill stats --html writes .ux/stats.html showing what YOUR install has learned. No telemetry, no global aggregate.
- **223 tests pass.** Offline. Deterministic. No LLM ever called.
Full details in CHANGELOG.md.
Star history
---
What is ux-skill
ux-skill is a **design intelligence engine** for AI coding tools. It runs as a Python package (pip install uxskill), as a Claude Code plugin, and as a 17-IDE multi-installer. The engine ingests a project brief (industry, audience, tone, must-haves, forbidden moves, stack, region) and returns a complete recommended design system: style, palette, type pair, motion presets, components, brand exemplars to study, and the anti-pattern guardrails that must hold. The recommendation is deterministic, same input always produces the same output.