Here's the problem. Every AI coding agent (Cursor, Codex, Claude Code, whatever) is trained on millions of websites. Most of those websites are average. So when you prompt "build me a landing page," the model gives you the average of everything it's seen: a centered hero, a purple gradient, three equal feature cards, Inter font, ease-in-out
, done. It's not broken. It's just mediocre by default.
I'm 17 and I got tired of fighting this in every conversation. So I built VibeCurb: a collection of strict constraint skill files, that force AI agents to actually think about design before they touch code.
Every skill follows the same four-phase pipeline:
Design Read - The agent reads your reference image, existing codebase, or brief and extracts design signals: typography, palette, layout, focal element, spacing. No code is written here.
Quality Gate - The extraction has to pass before the agent is allowed to generate anything. It must prove it understands the design direction, not just spit out defaults.
Precise Build - Code generation happens against the extraction, not against the model's built-in idea of what a "website" looks like. Each skill has its own build sequence.
Visual Diff - The output is checked against the reference using PASS/FAIL tables across composition, typography, color, motion, and responsiveness. If it drifts, it gets caught.
There's also an inline drift rejection layer. It catches known AI defaults (CSS keyword easings like ease-in-out
, AI-purple #7c3aed
gradients, generic glassmorphic cards, placeholder Lorem ipsum
content) and flags them before they make it into the output.
Each skill constrains a specific problem space:
awwwards-hero
awwwards-sections
awwwards-motion
prefers-reduced-motion
gating, no exceptions.pixel-perfect
visual-redesign
imagegen-frontend
brandkit-gen
Each SKILL.md
is a standalone markdown file with YAML frontmatter. No runtime dependency, no npm package to install. You drop the file into .cursor/rules/
, .agents/skills/
, or paste it directly into a conversation. Any agent that reads markdown context can consume it.
npx vibecurb-cli add awwwards-hero
Each phase gates the next. The agent can't skip ahead because the instructions explicitly block code generation until prior phases pass. It's not a suggestion, it's a hard protocol.
Works with Cursor, Claude Code, Codex, ChatGPT, Gemini CLI, v0, Lovable, AI Studio. Anything that reads markdown context.
A prompt says "make it look good." A constraint says "extract the palette first, prove you understand the typography hierarchy, then build against the extraction, then diff against the reference." The difference is that constraints are verifiable. The agent either passed the quality gate or it didn't. There's no ambiguity.
AI defaults to the mean. VibeCurb is the constraint that pulls it off the mean.
Live Showcase: vibecurb.pages.dev
GitHub: github.com/Yu-369/VibeCurb