Install

Premium products. Pixel-perfect. Every time your agent builds.

View on GitHub ↗
THE PROBLEM

Your AI ships almost right. Then it drifts.

Ask an agent to build a product and you get a different answer every session — inconsistent spacing, off-brand color, generic copy, components that don't match the next page. Each piece looks fine alone and falls apart as a whole. The problem isn't the model. It's that it's guessing.

Session ASession Bgap: 12pxgap: 24pxinconsistent spacing · wrong radius · different accent hue
THE FIX

Give it a system to follow.

  1. 01
    Spec
    Tokens, content, copy — your source of truth.
  2. 02
    Build
    The agent generates against the exported tokens.
  3. 03
    Self-QA
    It audits its own build before calling it done.
  4. 04
    Premium
    A consistent, premium product. Every session.
01
Spec

premium.md encodes the craft as machine-readable docs: an OKLCH design system, a content model, copy specs. Your agent reads {colors.primary.9}, not “blue-ish.”

DESIGN.mdcolors.primarytypography.displayDM Sans · 300 · −0.02emspacing.scaleradius.profile0px sharpmode.primarydark· light/dark toggle
02
Build

It builds from your spec, not its imagination — referencing the exact tokens, records, and component rules. No drift between pages, no invented values.

// tokensprimary.9oklch(0.62 0.14 252)font.displayDM Sansspace.832pxradius.none0pxagent// outputNav.tsxHero.tsxButton.tsxSection.tsxFooter.tsx
03
Self-QA

A built-in acceptance gate checks a11y, Core Web Vitals, token fidelity, and responsiveness — the agent catches its own misses, not you.

ACCEPTANCE GATEPASSA11YCore Web VitalsToken FidelityResponsiveContrastFont Load
04
Premium

The output is pixel-consistent and on-brand on every run — the difference between “almost right” and something you can actually ship.

premium.mdInstall32px24pxPIXEL — PERFECT
WHAT'S INSIDE

Ten templates. One source of truth.

Everything your agent needs to build a whole product — not a UI kit, the system it follows.

01

A real design system

Brand, OKLCH color, type, spacing, components, motion, a11y — as tokens your agent references, not vibes.

colortypespacemotiona11ytokens
02

Single-source content + copy

Reusable records and per-page copy specs, so the same fact or word never drifts across pages.

03

Deterministic intake

A structured questionnaire fills the templates from your answers and derives the palette + dark mode.

04

Self-QA acceptance gate

The agent audits its own build before “done” — a11y, Core Web Vitals, token fidelity, responsive.

05

Discoverability built in

SEO + AEO + GEO — JSON-LD structured data, answer-first patterns, citability.

06

Works with your agent

Claude Code, Codex, Cursor + 30+ agents via the open SKILL.md standard. One npx command.

INSTALL

One command. Every agent.

Install once and it lands in every detected agent — Claude Code, Codex, Cursor, and 30+ more via the open SKILL.md standard. Then just ask, or invoke /premium-product.

View on GitHub ↗
install — premium.md
$ npx skills add …/premium-product
✓ Detected Claude Code
✓ Detected Cursor
✓ Detected Codex
✓ Installed → .claude/skills/premium-product
→ ask, or invoke /premium-product
BY THE NUMBERS
10
markdown templates
~4,090
lines of research
29
research sections
30+
agents supported
MIT
free & open source

Real, from the repo. No fake stars, no invented testimonials.

FAQ

Questions

Yes — premium.md is MIT licensed and free. Fork it, adapt it, ship anything you want.

LINEAGE

Built on a good idea — and given real control.

premium.md builds on the idea behind Google Labs' DESIGN.md (Apache-2.0): a single design-token file. It extends that one file into a full product system — brand, content, copy, and a QA gate — with the pixel-level control a designer needs. Thanks to the Google Labs team.

Google Labs · DESIGN.md ↗

Make your agent build premium.

Free, MIT, and yours to fork.

View on GitHub ↗