no-slop-copyBan cliché headlines & sparkle pill badges
Never open with “Supercharge your workflow with AI”, “Unleash next-gen productivity”, or ✨/🚀 pills above the H1. Name what the software actually does in plain words.
Turn “good taste” into concrete engineering constraints your coding agent actually obeys. Distilled from VibeCheck's deterministic audit rules (@vibecheck/checks) and modern design engineering practice.
no-slop-copyNever open with “Supercharge your workflow with AI”, “Unleash next-gen productivity”, or ✨/🚀 pills above the H1. Name what the software actually does in plain words.
disciplined-paletteKeep canvas and surfaces quiet (#09090b / #111113 dark or #fafafa / #ffffff light). Ban purple-to-cyan gradient text and ambient neon blobs; keep primary buttons crisp ink.
typography-measureTrack display headings tightly (-0.03em to -0.045em) with text-wrap: balance, cap body measure at 65ch, and enable tabular-nums on every score, price, and counter.
asymmetric-rhythmBreak the generator reflex of centered H2 + 3 identical rounded icon cards. Use 1px hairline ledgers, asymmetric 2-column splits, and real interactive UI specimens.
no-fake-proofNever embed pravatar.cc / randomuser.me avatars, placeholder company logos, or unsourced round numbers (“10,000+ users”, “99.9% accuracy”).
clear-ctaKeep one unmistakable primary CTA above the fold using concrete verbs (“Audit a live URL”, “Connect repository”) rather than destination-free “Get Started”.
compositor-motionDeclare explicit transition properties (opacity, transform, color, border-color) at 140–240ms and honor prefers-reduced-motion per rule.
copy-uxNever disable copy buttons during “Copied” feedback. Maintain width with a stacked CSS grid and announce status via a sibling role="status" live region.
layout-resilienceSet min-width: 0 on flex/grid children holding URLs or code, avoid 100vw horizontal scrollbars, and verify layouts at both 1440×900 and 390×844.
ship-hygieneShip unique <title>, meta description, canonical, 1200×630 OpenGraph card, JSON-LD, and verify zero secret keys in client bundles.
Optionally select any captured benchmark from the dropdown (e.g., Linear, Resend, Zed, Emil Kowalski) to embed its verified color tokens and display font right inside your SKILL.md.
.claude/skills/vibecheck-taste/SKILL.md (Claude Code · Codex · Antigravity)---
name: vibecheck-taste-guardrails
description: Use when building, redesigning, or auditing landing pages, SaaS interfaces, and developer tools. Prevents generic AI UI tells (purple glow meshes, cloned 3-card rows, synthetic social proof, emoji pills, buzzword headlines) and enforces semantic tokens, crisp typography, and viewport verification.
---
# Frontend Taste & Conversion Guardrails (VibeCheck)
Drop into `CLAUDE.md`, `AGENTS.md`, or `.cursor/rules/taste.mdc` so coding agents ship distinctive product UI instead of generic templates.
## 1. Visual & Token Discipline
- **Semantic Palette**: Define CSS variables (`--bg`, `--ink`, `--muted`, `--accent`, `--border`) first; keep one deliberate accent color and high ink-on-ground contrast.
- **Typography Hierarchy**: Pair a distinctive display face or tight geometric tracking (`-0.025em` to `-0.04em`) on H1/H2 with comfortable body copy (`max-width: 65ch`, `tabular-nums` on metrics).
- **Asymmetric Rhythm**: Avoid rows of three identical icon-title-blurb cards on every section. Alternate split showcases, hairline ledgers, and real product artifacts.
- **Compositor Motion**: Never write `transition-all`. Scope transitions to `transform`, `opacity`, or `color`/`background-color` (150ms-240ms ease-out), and honor `prefers-reduced-motion: reduce`.
## 2. Copy, Trust & Conversion
- **Concrete Headlines**: State who it is for and what job it completes in plain nouns and verbs. Ban `elevate`, `unleash`, `seamless`, `supercharge`, `next-gen`, and em-dash slogans.
- **Specific Primary CTA**: Name the exact next step (`Run free audit`, `Download macOS app`, `Book 15-min demo`), never bare `Get started` or `#` anchors.
- **Zero Synthetic Proof**: Never use `pravatar.cc`, `randomuser.me`, invented quotes, or unsourced `10,000+ teams` badges. No emojis (`✨`, `🚀`, `⚡`) inside UI pills or headings.
- **Keyboard & Mobile**: Maintain visible `:focus-visible` outlines, `<html lang>`, complete `1200x630` OpenGraph metadata, and zero horizontal overflow at `390x844`.
## Five-Step Delivery Workflow
1. **Tokens before markup**: Declare semantic variables (`--color-bg`, `--color-ink`, `--color-muted`, `--color-accent`, radii, fonts) in `:root` or `@theme` before authoring components.
2. **One concrete hero claim**: Write an active noun-and-verb H1 paired with a real product artifact, live specimen, or terminal output rather than abstract gradient blobs.
3. **Editorial rhythm**: Alternate split showcases, 1px hairline ledgers, and generous negative space instead of repeating centered three-column card grids.
4. **Viewport and keyboard proof**: Inspect at `1440x900` and `390x844` for line-wrapping, contrast, and zero horizontal overflow; verify `:focus-visible` and `prefers-reduced-motion`.
5. **Honest handoff**: Separate verified behavior from unmeasured implementation choices; never invent customer quotes, metrics, or test results.
$claude mcp add --transport http vibecheck https://vibecheck.itool.tech/mcp