PyModel/designer-skill
View on GitHub ↗Plug-and-play MCP that gives your coding agent UI superpowers. One-line install, zero config. Claude Code, Codex, Cursor, VS Code, and more.
27 ★2 forksJavaScriptUpdated 22d ago
What you need to know
Plug-and-play MCP server + skill that gives AI agents UI design superpowers: it routes vague requests like 'make it pop' to the right design verbs, serves 15 reference files (type, color, motion, a11y, anti-slop, redesign loops), and enforces a 44-rule deterministic ship gate so UI stops looking generic.
Install
npm i designer-skill-mcp Register via mcp.json: mcpServers designer-skill with command npx and args ["-y", "designer-skill-mcp@latest"] Plugin install: /plugin marketplace add Pythoughts-labs/designer-skill && /plugin install designer-skill@pythoughts-labs
Usage
- •One-line add in any MCP client — no API key; config examples ship for Pythinker, Codex CLI, Claude Code/Desktop, Cursor, VS Code, Kilo Code, Open Code, and Pi.
- •Run get_design_system, dispatch_intent, then get_reference before writing UI code.
- •Call anti_slop_checklist as the ship gate before declaring UI work done.
- •HTTP mode: node dist/index.js --http --port 3017 serves Streamable HTTP at /mcp for remote clients.
Key features
- ✓10 MCP tools: get_design_system, load_project_context, get_reference, list/get_command, dispatch_intent, detect_antipatterns (44 deterministic rules, no LLM, no API key), get_palette_seed (OKLCH), anti_slop_checklist.
- ✓15 reference files in core (8) and extended (7) tiers covering design principles, differentiation, aesthetic systems, motion, engineering/performance, avoid-ai-slop, and CSS techniques.
- ✓Intent-to-verb mapping table and a 6-step preflight for surface scoping.
- ✓Plugin bundle (mcp.json + skills + /designer-setup, /designer-status commands) for Claude Code, Codex, and Cursor.
- ✓Demonstrated on a live production site (pythinker.com).
Best for
Developers and coding agents who want less generic, AI-slop UI and a consistent design methodology enforced before shipping front-end work.
Caveats
- ⚠HTTP mode has no built-in auth for public exposure — add your own auth/proxy if binding beyond 127.0.0.1.
- ⚠VS Code MCP config requires VS Code 1.99+ or the MCP extension.
- ⚠Use @latest for newest npm release; pin @0.11.0 for teams; skill content updates separately via /plugin update.
- ⚠Skill content and MCP server are separate artifacts packaged together.
Platforms: LocalClients: Pythinker · Codex CLI · Claude Code · Claude Desktop · Cursor · VS Code · Kilo Code · Open Code · Pi
Reviewed 2026-08-18
Topics
ai-agentclaudeclaude-codecodexcoding-agentcursordesign-systemdesigner-skillfrontend-designmcpmodel-context-protocolnpmplug-and-playtypescriptuiui-designux
- Stars
- 27★
- Forks
- 2
- Language
- JavaScript
- License
- MIT
- Created
- 2026-06-09
- Last push
- 2026-08-13