SkillAgentSearch skills...

unslop

Make your vibe-coded app look less like AI slop. 72-rule UI design linter, WCAG + APCA contrast engine, 10 studio design presets, CLI & MCP server for React, Next.js & Tailwind.

Install / Use

claude mcp add avivgerz-hue -- npx -y github:avivgerz-hue/unslop

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

79/100

Supported Platforms

Claude Code
Claude Desktop
Cursor

Our assessment of unslop

unslop scores 79/100 on our quality scale, 3682nd of 4,714 Development & Engineering skills we index.

Its MCP Server is 19 KB long, well organised into 24 sections with 20 code examples: a thorough specification that gives an agent plenty to work with.

It has 49 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
7/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated yesterday, so unslop is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

unslop compared with similar skills

All 4 of these similar skills score higher than unslop; compare them before choosing.

SkillScoreStarsUpdatedFormat
unslop (this skill)by avivgerz-hue79491d agoMCP Server
taste-skillby Leonxlnx100117.8k9d agoCLAUDE.md
Agent-Reachby Panniantong100112.8k10d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md

Frequently asked questions

How do I install unslop?
Run claude mcp add avivgerz-hue -- npx -y github:avivgerz-hue/unslop. The install tabs above show the steps for each supported agent.
Which AI agents does unslop work with?
It is written for Claude Code, Claude Desktop and Cursor, as a MCP Server file. Other agents that read the same format can often use it too.
Is unslop safe to use?
It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is unslop still maintained?
The repository was last updated yesterday, so unslop is actively maintained.

unslop v2.1.1

⭐ If this tool helps your AI coding workflow, please give this repository a Star! It helps more developers discover the project.

VibeFoundry Agent Suite: 🎨 unslop — UI Design DNA & Anti-Slop Engine (npx -y unslop-mcp@latest init) · 🛡️ vibe-shield — Security Scanner for AI Code (npx -y @vibefoundry/vibe-shield@latest scan .) · 👻 ghost-qa — Autonomous Headless Browser QA (npx -y ghost-qa@latest test http://localhost:3000)

npm version npm downloads CI Node.js 20.19+ MIT license

Live Terminal Demo

npx -y unslop-mcp@latest init

Your agent can write the code. unslop gives it a measurable design engineering protocol.

unslop preview

unslop is a zero-runtime-dependency UI/UX Design Engineering CLI, native MCP Server, and AI Agent Skill. It audits 72 rules across seven design craft pillars, installs ten studio-grade archetypes, extracts Design DNA, exports four token formats, and turns every finding into an exact, prioritized transformation blueprint for JSX/TSX, HTML, Vue, Svelte, CSS, and Tailwind codebases.

Works natively with Claude Code, OpenCode, OpenAI Codex, Cursor, Windsurf, GitHub Copilot, Cline/Roo Code, Zed, and universal Agent Skills.

Human-readable CLI audits and refactor plans include a copyable badge for the calculated grade and a GitHub star link. Commands that do not calculate a score show a clearly labeled example badge. JSON and MCP stdio are never decorated.

Before and after unslop: a generic purple-gradient AI landing page transformed into a precise, token-driven Linear Dark dashboard

npx -y unslop-mcp init --preset linear-precision
npx -y unslop-mcp audit .
npx -y unslop-mcp refactor-plan . --report UNSLOP-REPORT.md

Supported Coding Agents (Claude Code, OpenCode, Codex, Cursor, Windsurf, Copilot, Cline, Zed)

Install the latest universal integrations directly from GitHub in any project (the published npm version may lag behind main):

npx -y github:avivgerz-hue/unslop#main init --preset linear-precision

| Agent | Native files generated by unslop init | | --- | --- | | Claude Code | .mcp.json, CLAUDE.md, .claude/skills/unslop/SKILL.md, .claude-plugin/plugin.json | | OpenCode | opencode.json with mcp.unslop-mcp, plus AGENTS.md | | OpenAI Codex CLI / Universal Agents | AGENTS.md and .agents/skills/unslop/SKILL.md | | Cursor | .cursor/mcp.json, .cursor/rules/unslop.mdc, and legacy .cursorrules | | Windsurf | .windsurfrules | | VS Code / GitHub Copilot | .vscode/mcp.json and .github/copilot-instructions.md | | Cline / Roo Code | .clinerules | | Zed | .zed/settings.json under context_servers |

Restart or reload the agent after installation so it discovers the new MCP server and Skill. Existing instructions outside Unslop's managed block, unrelated MCP servers, settings, inputs, and custom fields are preserved. Running init again is byte-for-byte idempotent.

This repository itself includes root AGENTS.md, CLAUDE.md, opencode.json, .claude-plugin/plugin.json, and both Claude/Codex Skill paths for immediate auto-discovery.

The result is not a generic prompt. It is a versioned token contract, a Design Craft Score from 0–100, a seven-pillar scorecard, exact before/after translations, and file-level steps your agent can execute in one coherent pass.

v2 at a glance

| Capability | v2 contract | | --- | --- | | Design Craft Engine | 72 rules · 7 pillars · A+–F grades | | Color analysis | Exact WCAG 2.1 AA/AAA plus APCA-inspired perceptual checks | | Studio archetypes | 10 complete production design systems; five v1 IDs remain compatible | | Token formats | Tailwind v4 @theme, Tailwind v3 config, CSS custom properties, W3C Design Tokens JSON | | Transformation | refactor-plan CLI and unslop_refactor_plan MCP tool generate UNSLOP-REPORT.md | | Agent protocol | Five-step principal UI/UX design engineer SKILL.md | | Runtime | Node.js 20.19+, JSON-RPC 2.0 stdio, zero runtime dependencies |

The 7-Pillar Design Craft Engine

Run a deterministic baseline before letting an agent rewrite the interface:

npx -y unslop-mcp audit . --json
Design Craft Score: 78/100 (C)
7-Pillar Scorecard:
  Color & Contrast: 82/100 (B) · 3 findings
  Typography & Hierarchy: 76/100 (C) · 4 findings
  Layout & Spatial Rhythm: 70/100 (C) · 5 findings
  Surface & Elevation: 88/100 (B) · 2 findings
  Copy & Microcopy: 82/100 (B) · 3 findings
  Interaction & Motion: 58/100 (F) · 7 findings
  Theme & Token Architecture: 90/100 (A) · 2 findings

| Pillar | Canonical rules | What the engine detects | | --- | --- | --- | | 1 · Color, Atmospheric Polarity & Contrast Math | SLOP-COLOR-* | Purple/pink/indigo clone gradients, neon glows, absolute black/white glare, muddy grays, hardcoded component colors, low-opacity text, exact WCAG AA/AAA, APCA-inspired polarity | | 2 · Typography & Scannable Hierarchy | SLOP-TYPE-* | Fixed display scales, monotonous heading weights, paragraphs beyond readable measure, missing tabular-nums, cramped body leading, loose display leading, untracked uppercase labels | | 3 · Layout, Spatial Rhythm & Grid Craft | SLOP-LAYOUT-* | Centered three-card clones, nested cards, off-grid arbitrary values, excessive container rounding, arbitrary grids, missing content measures, conflicting spacing and radii | | 4 · Visual Restraint & Surface Elevation | SLOP-SURFACE-* | Glassmorphism overuse, heavy dark-mode shadows, decorative blur blobs, icon badge clutter, unanchored raw elevation, ad-hoc shadow stacks | | 5 · Copywriting & Microcopy Anti-Slop | SLOP-COPY-* | 100+ cliché variants, including “Unleash the power,” “Revolutionize,” “Supercharge your workflow,” “Seamless integration,” “Next-generation,” hype, filler, superlatives, and emoji spam | | 6 · Interactive Ergonomics, Motion & States | SLOP-UX-* | Clickable divs, missing labels and keyboard rings, incomplete hover/active/disabled states, small targets, positive tabindex, transition-all, missing reduced-motion behavior | | 7 · Theme Parity & Token Architecture | SLOP-TOKEN-* | Broken Canvas → Surface-1 → Surface-2 → Interactive → Border order, asymmetric dark overrides, missing dark companions, off-grid or mistyped tokens |

Legacy slop/* IDs remain in output for compatibility. Canonical SLOP-* findings drive the v2 seven-pillar score, with location-level deduplication so compatibility output does not double-penalize a finding.

Scores with an action attached

Every audit includes exact file:line:column diagnostics and refactoring instructions. The overall score is the rounded mean of seven independently capped pillar scores; 95–100 is A+. Use --fail-under in CI or agent loops:

npx -y unslop-mcp audit . --fail-under 95
npx -y unslop-mcp audit . --prompt
npx -y unslop-mcp audit src --json --no-fail

Static analysis never replaces rendered verification. Keyboard operation, responsive behavior, actual contrast, content overflow, and reduced motion still need explicit inspection.

Design Transformation Blueprint

unslop_refactor_plan turns the audit into an executable Design Transformation Blueprint instead of a list of vague taste suggestions:

npx -y unslop-mcp refactor-plan . --preset linear-precision --report UNSLOP-REPORT.md

The report contains:

  1. Design Craft Score and 7-Pillar Scorecard.
  2. Before → After Class & Token Translation Table mapping detected classes, hex/RGB literals, off-grid values, and cliché copy to exact replacements from the selected archetype.
  3. Prioritized P0/P1/P2 file:line steps covering the entire interface transformation.
  4. Acceptance criteria for reaching 95–100 without suppressing rules or losing accessible states.

Example translations:

| Before | After | | --- | --- | | from-purple-500 via-pink-500 to-indigo-500 | bg-[var(--surface-1)] text-[var(--text-primary)] | | shadow-xl | border border-[var(--border-subtle)] shadow-[var(--shadow-md)] | | p-[13px] | p-[var(--spacing-12)] | | rounded-3xl | rounded-[var(--radius-lg)] | | transition-all | transition-colors motion-reduce:transition-none | | #777777 | var(--text-primary) | | “Unleash the power” | A concrete product capability and verifiable user outcome |

Use --json for the complete machine-readable blueprint:

npx -y unslop-mcp refactor-plan src --preset swiss-editorial --report reports/DESIGN.md --json

10 Studio-Grade Design Archetypes

Inspect and install a complete token and agent-rule contract:

npx -y unslop-mcp presets
npx -y unslop-mcp presets anthropic-warm-editorial
npx -y unslop-mcp init --preset anthropic-warm-editorial

| Archetype | Visual and engineering thesis | | --- | --- | | swiss-editorial | High-contrast editorial grid, warm paper, serif/grotesk pairing, crisp hairline rules | | linear-precision | Obsidian craft, luminance borders, compact tracking, subtle layers, tabular precision | | stripe-atmospheric | Refined slate atmosphere, crisp white surfaces, cobalt trust, layered micro-shadows | | vercel-monochrome | Architectural monochrome, geometric rhythm, zero decorative bloat, semantic status color | | teenage-engineering | Tactile industrial UI, monospace labels, international orange, physical grid borders | | anthropic-warm-editorial | Parchment and stone, literary serif headings, calm clay accents, generous reading measure | | bloomberg-terminal-dense | Ultra-high data density, strict numeric alignment, compact workflows, semantic tickers | | raycast-command | Frosted graphite command palette, keyboard-first selection, crisp shortcut badges | | fintech-institutional | Deep forest-navy authority, legible financial hierarchy, restrained brass and emerald | | neo-brutalist-craft | Intentional ink borders, offset hard shadows, bold geometric contrast, disciplined rhythm |

Each archetype includes full surface hierarchy, explicit light/dark companions, typography scale and weights, spacing rhythm, radii, shadow/border elevation, layout contract, motion curve and spring values, plus ten archetype-specific design laws.

The v1 IDs linear-dark, swiss-grid, stripe-minimal, apple-glass, and neo-brutalist remain loadable for existing installations; the canonical v2 gallery contains the ten systems above.

Four token formats — presets or extracted DNA

Use the same deterministic exporter for a built-in archetype or extracted Design DNA.

Tailwind v4 @theme

npx -y unslop-mcp export-tokens --preset linear-precision --format tailwind-v4 --out tokens.css

Produces @theme, :root, and .dark contracts with semantic colors, fonts, fluid type, tracking, weights, radii, shadows, spacing, motion, and layout values.

Tailwind v3 configuration fragment

npx -y unslop-mcp export-tokens --preset linear-precision --format tailwind-v3 --out tailwind.config.js

Emits a mergeable theme.extend fragment with semantic utilities.

Pure CSS custom properties

npx -y unslop-mcp export-tokens --preset l

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars49
CategoryDevelopment
Updated1d ago
Forks5

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info