Skip to content
Tech News
← Back to articles

Show HN: StyleSeed – a design-rules engine so AI agents stop building generic UI

read original more articles

Get started in 30 seconds

The fastest way — paste this one sentence into Claude Code, Codex, Cursor, or any AI agent. It installs StyleSeed and runs the whole loop:

Install StyleSeed so its checks actually run: `npx skills add bitjaru/styleseed` (if you can't, read https://styleseed-demo.vercel.app/llms-full.txt instead). Then use it for every UI in this project. First, in plan mode, lock my key color, font, and motion with me and save them to STYLESEED.md so they don't drift. Build to the rules with ONE focal point and one accent. Before showing me anything, run the quality gate (`/ss-score` in Claude Code, `$ss-score` in Codex) to ≥ 80 and fix what fails. For a full screen, run `/ss-build` in Claude Code or `$ss-build` in Codex — it enforces this whole loop.

Why the prompt installs first: the quality gate is the step that makes output stop looking generic — but the ss-score and ss-build skills can only run if they are installed. Point an agent at the rules-URL alone and the "gate" degrades to an honor-system self-check it usually skips. Installing makes the loop real: the lock persists in STYLESEED.md (no drift), and the gate actually scores and fixes before you see anything. Can't install? The URL still teaches the rules — just weaker. Works with Claude Code ( CLAUDE.md ), Codex / Amp / Gemini CLI ( AGENTS.md ), and Cursor ( .cursorrules ) — StyleSeed ships all three. (Planning first is what keeps the result from looking random — see Troubleshooting.)

What your agent actually does with StyleSeed loaded:

you ▸ build me a billing settings page agent ▸ (plan mode) key color? for billing I'd go deep teal — #0F766E, mood: sharp · calm · trustworthy (not the default indigo). Motion: Snap. ok? ▸ y agent ▸ ✓ wrote STYLESEED.md — skin, accent, font, radius, motion locked, re-read every prompt agent ▸ building… running the quality gate before I show you anything gate ▸ ✗ two accent colors ✗ "normal" rows colored ✗ no empty state → fixing agent ▸ ✓ 88/100 — one accent, grey normal states, real empty/error states. here's the page.

The STYLESEED.md lock is the anti-drift mechanic. Your skin, key color, radius, and motion get written once and the rules make every agent re-read and obey them on every prompt — so the design stops being different each session. The Quality Gate then self-reviews and fixes the UI (rainbow lists, two accents, missing states) before you ever see it — and it can retrofit an old generic build too.

The rules are the product — and they need zero install or permissions. They're plain markdown ( CLAUDE.md / AGENTS.md / DESIGN-LANGUAGE.md ), so the prompt above — or just copying those files in — is 90% of StyleSeed with nothing to approve.

Want the 19 ss-* agent skills too (optional automation: setup wizard, review, score)?

npx skills add bitjaru/styleseed

... continue reading