StyleSeed
Design-method engine · open source

Give your coding agent a design method it can repeat.

StyleSeed compiles your chosen design rules into an artifact-level contract, builds against it, and keeps the decisions in your repo so the next screen and the next update stay coherent.

Works with Codex, Claude Code, Cursor, and other skills-compatible agents.

Advanced: use the full one-paste workflow ↓
Install StyleSeed: `npx skills add bitjaru/styleseed` (or read https://styleseed-demo.vercel.app/llms.txt). Use `/ss-*` in Claude Code or `$ss-*` in Codex. Before building, choose the output grammar, surface adapter, brand recipe, and semantic palette. If the direction is still open, run `/ss-studio` or `$ss-studio` to produce three directions, require my selection, plan image/video assets and interaction scenes, then build a working prototype before recording a reel. If my references are not modeled, compile a project-local rule set with `/ss-reference` or `$ss-reference` instead of copying them. Save approved decisions to STYLESEED.md, resolve them, build, score to ≥80, then inspect the rendered screen and temporal interaction before showing me.

Use this when you need the full workflow in one portable prompt.

  1. 01

    Choose

    Pick the output grammar, surface, brand recipe, and bounded project decisions.

  2. 02

    Compile

    Turn those choices into a small, exact contract for this artifact — not a giant handbook.

  3. 03

    Build

    Generate against the contract and keep approved decisions in the repo for the next update.

  4. 04

    Prove

    Run code checks, build the product, inspect real pixels, and record what actually passed.

The same product built by an AI agent's defaults versus with StyleSeed's rules — before shows default indigo, gradient text, and placeholder mocks; after shows a chosen accent, the real product, and one focal point.
Same product, same prompt — only the rules changed. This page first scored 58/100 on our own gate. See the receipt → The benchmark records a 5.3-point improvement for both Codex and Claude Code. Read BENCH-V1 →
design rules
74
core skills
23
output grammars
8
surface adapters
5
Studio pipeline

Direction, color, motion.
One working scene.

Studio turns a brief into three structurally different directions, requires a human selection, then compiles interaction scenes, image and video jobs, and a working prototype before it records the showcase reel.

Eight semantic palette recipes recommend refined canvas, chrome, action, status, focus, and generated-media colors for the product job. Every required pair is contrast-checked; color does not replace the selected design grammar.

StyleSeed engine architecture
Latest v4 revision

The method can learn.
Updates stay exact.

A caller-attested accepted correction can now become a privacy-minimized local candidate. Separately, every maintained engine payload carries an exact revision hash, so a same-version rule or skill fix is still detectable without overwriting project code.

Optional extension

Caller-attested local learning

Not included in the core install. Capture only on request, review separately, block known high-risk identity patterns, and keep the result local. This is a guardrail, not an anonymization guarantee; review the exact package before exposure.

See the privacy boundary
engineRevision

Same version, exact payload

$ss-update compares the installed, project-recorded, and published revision before refresh and re-resolution.

Read the update architecture
Codex package

23 core skills, no learning payload

The repository includes a repository development Codex package boundary. The implemented default/core install contains neither ss-learn nor a learning MCP. Public installation remains npx skills add bitjaru/styleseed until a plugin-directory release is independently verified.

Open the Codex guide
Get started

Install once. Keep the method in the repo.

The core install gives your agent the resolver, builder, score, and visual gate. Approved choices persist in project files instead of disappearing with the chat.

Full setup guide

Works with Codex, Claude Code, Cursor, and other skills-compatible agents.

What the install changes

A repeatable loop, not a one-off style prompt

When invoked, StyleSeed resolves only the rules selected for the artifact, builds against that bundle, records the code and rendered checks that actually ran, and preserves the approved lock for later updates. The core package contains 23 skills; optional local-learning tools are distributed separately.

# Claude Code: /ss-resolve → /ss-build · Codex: $ss-resolve → $ss-build
One engine, many looks

Same product. Six aesthetic profiles. One ss-restyle away.

Profiles coordinate radius, density, color, weight, motion, type, and one signature move. The selected output grammar still owns the product job and composition — a technical profile cannot turn a shop into an observability console. Distinctive isn’t a coat of paint. Each profile is a coherent coordinate across the dial axes — radius, density, color, weight, motion, plus a font and a signature move — so every look reads designed, never generic. Trend gimmicks (glass, neumorphism) are deliberately left out.

The same Relay product rendered in six StyleSeed presets — swiss, editorial, technical, warm-dtc, minimal-mono, brutalist-lite. Each is coherent and distinct, none looks generic.
/ss-restyle swiss · $ss-restyle swiss/ss-restyle editorial · $ss-restyle editorial/ss-restyle technical · $ss-restyle technical/ss-restyle warm-dtc · $ss-restyle warm-dtc/ss-restyle minimal-mono · $ss-restyle minimal-mono/ss-restyle brutalist-lite · $ss-restyle brutalist-lite
Why it works

Other repos give your AI components. We give it the reasoning.

Every decision in a StyleSeed UI has a stated reason — the rule it follows and why that rule makes the result look designed. That’s what an AI can actually read, apply, and repeat. Walk a real screen, decision by decision.

A StyleSeed UI annotated with the design rule behind each decision — deliberate hierarchy, stable color roles, coherent geometry, accessible signals, and real states.
The decision
Balance 48px, unit 24px
The rule
Rule 4 · Numbers 2:1 with units
Why it works
The eye locks onto magnitude first; equal sizes flatten it into noise.
See how it thinks — the full walkthrough
Vs other design-AI skills

Other design skills make your UI coherent.
StyleSeed also fights the generic-AI look — and enforces it.

CapabilityComponent kitsDESIGN.md packsStyleSeed
Teaches judgment 74 rules — with the reasoning
Fights the AI-look bans the tells by name
Scored gate ≥80 self-reviews & fixes first
Anti-drift lock decisions persist across prompts
Works in every agent Claude Code · Cursor · Codex · Gemini
PricePaid tiersFreeFree · MIT
“Why not just use the official frontend-design skill?”

Use both. Anthropic’s official frontend-design skill scaffolds a clean screen fast — it’s a great starting point. StyleSeed is the layer on top: it names and bans the generic-AI tells, scores every screen to a ≥80 gate and fixes it before you see it, and locks your design decisions so they don’t drift across prompts. The official skill is strong at visual direction; StyleSeed carries that judgment across screens, sessions, reference sets, and verification.

Named peer · observed 2026-08-13

Impeccable is a serious execution-layer reference.

Its current public package documents 23 commands, 60 deterministic rules, CLI checks for local files and URLs, JSON output for CI, and hooks for major coding agents.

StyleSeed focuses on compiling a bounded contract for each artifact, persisting approved project decisions, and binding code, build, pixel, and temporal evidence to the exact source revision. This is a capability-specific snapshot, not an overall ranking.

Also in the box: 7 brand skins from one data-skin attribute, 5 motion seeds plus 20+ keyword moves, and a drop-in engine/ — no build step, no lock-in. The rules are open: propose new ones via PR. See the before/after →

Showcase

15 examples · 8 grammars · 5 surfaces.

Not static templates — each one is the engine’s output, re-skinning across 7 brand DNAs and 5 motion seeds live in the browser. Copy the source, rules and all.

Skins are inspired-by token sets — brand-flavored color/radius/shadow/motion values, not recreations of those companies’ design languages. Restructuring the actual design is the presets’ job (/ss-restyle).

View all 15
Motion system

Vibe words for personality. Keywords for flair.

5 named seeds (each with five spreadable recipes) plus a library of 20+ scroll-stopping keyword moves — tilt-3d, magnetic, glow-pulse. Try them live below, or browse the full gallery.

Personality · pick a vibe word
Spring · bouncy, energetic, playful
Entrance
how it appears
Hover
point at the square
Press
tap the button
Flair · scroll-stopping named moves
20+ moves
hover
tilt-3d
magnetic
live
glow-pulse
confetti-pop
<motion.button {...spring.press} {...spring.hover}>
  Save
</motion.button>
What’s new
v4.1.02026-08-20 · 74 rules · 8 grammars · 9 recipes · 5 adapters · 23 skills
Latest revision sha256:f563a15b158… · 80 maintained files · 2026-08-20

StyleSeed 4.1 binds artifact-level contracts and evidence to exact source revisions, makes engine and skills updates independently verifiable, and packages a deterministic 23-skill core. The optional learning extension remains outside the default/core archive, and public plugin-directory release is not verified.

Private learning Release notes Full changelogUpdate with /ss-update · $ss-update

Stop redrawing. Start shipping.

Works with Codex, Claude Code, Cursor, and other skills-compatible agents.

One command to make the method available to every future project prompt.

MIT licensed · no telemetry · browse the showcase