Kleros Skills — Landing Page Design SpecLegacy format

Design documentation for Kleros Skills V2 — a single-page landing site distributing machine-readable knowledge packs to AI agents with a hybrid warm paper/dark terminal aesthetic

Headline
Aa
Search
Body
Aa
Label
Aa
Label

Typography

base'Inter', system-ui, ... · 15px · Regular

Every letter tells a story worth reading, and every typeface gives that story a new voice waiting to be heard.

mono'JetBrains Mono', IBM Plex Mono,... · 10.5px · Bold

Every letter tells a story worth reading, and every typeface gives that story a new voice waiting to be heard.

h2'Inter', system-ui, ... · 28px · Bold

Every letter tells a story worth reading, and every typeface gives that story a new voice waiting to be heard.

h3'Inter', system-ui, ... · 20px · SemiBold

Every letter tells a story worth reading, and every typeface gives that story a new voice waiting to be heard.

h3-setup'Inter', system-ui, ... · 19px · SemiBold

Every letter tells a story worth reading, and every typeface gives that story a new voice waiting to be heard.

hero-tagline'Inter', system-ui, ... · 17px · Regular

Every letter tells a story worth reading, and every typeface gives that story a new voice waiting to be heard.

body'Inter', system-ui, ... · 15px · Regular

Every letter tells a story worth reading, and every typeface gives that story a new voice waiting to be heard.

Design documentation for Kleros Skills V2 — a single-page landing site distributing machine-readable knowledge packs to AI agents with a hybrid warm paper/dark terminal aesthetic

Components

Buttons

Cards

Card Title

Sample body text for the card component.

Modal

default

Do's & Don'ts

Do

Use exactly one accent hue (#6b2fd6) in light context, #c084ff in dark
Apply mono font for code, labels, tags, and uppercase elements
Use 'SKILL.md' paths in all components

Don't

Add gradients or secondary accent colors

Icons

Unknown

Unknown

Icon preview not available for this library

copygithubimagerycurrentcolor

Library: Unknown · Size: 15px

1. Concept

A single-page landing site that distributes machine-readable knowledge packs ("skills")

to AI agents. The page must read as developer-native and agent-first — it should feel

like documentation/CLI tooling, not a marketing splash. The core action is *copy a prompt

and paste it into your agent*.

Aesthetic direction: a hybrid of warm paper UI and a dark terminal. The body is a calm,

cream-colored reading surface; the hero and code surfaces are dark "terminal" panels. The

contrast frames the product as a bridge between human-friendly docs and machine-facing code.

---

2. Color

Light cream body with dark terminal accents and a single violet brand hue (Kleros purple).

### Light surface (body)

| Token | Value | Use |

|---|---|---|

| --bg | #f6f1ea | Page background (warm cream) |

| --bg-soft | #efe7dc | Inset rows, tab bar |

| --card | #ffffff | Cards, panels |

| --border | #e3d8c8 | Primary borders |

| --border-soft | #ece2d2 | Subtle dividers, dashed rules |

| --ink | #1f1530 | Primary text |

| --ink-dim | #6b5f7e | Secondary text |

### Accent (Kleros violet)

| Token | Value | Use |

|---|---|---|

| --accent | #6b2fd6 | Links, CTAs, active states, left card rule |

| --accent-soft | #f0e6ff | Tag/chip backgrounds, code highlight |

### Dark surface (hero + code blocks)

| Token | Value | Use |

|---|---|---|

| --dark | #1a1426 | Hero panel, code block bg |

| --dark-panel | #221a33 | Nested dark surfaces |

| --dark-border | #3a2f55 | Dark borders, terminal dots |

| --dark-accent | #c084ff | ASCII art, accents on dark |

| --dark-fg | #ebe6f7 | Text on dark |

| --dark-dim | #9b8fc4 | Muted text on dark |

| --danger | #c94a4a | Error states (modal load failure) |

Rule: exactly one accent hue (violet). It appears on light as #6b2fd6 and lifts to

#c084ff on dark for contrast. No gradients, no secondary accent colors.

---

4. Layout

Centered column, max-width: 1180px, 56px side padding (20px on mobile).

Vertical rhythm between major sections: padding-top: 72px.

Generous radii: panels 14–18px, cards 12px, code blocks 8px, chips 3px.

Shadows are soft and long, low-opacity, violet/ink-tinted — used sparingly on the

hero panel and on hover, never as decoration.

### Page structure (top → bottom)

1. Top nav — brand mark (K in a dark rounded square) + kleros / skills + beta tag; right-side anchor nav + GitHub link.

2. Hero panel (dark) — terminal chrome dots + path, large ASCII Kleros logo + ASCII wordmark, one-line tagline.

3. Primary CTA (light card) — "① Paste this into your agent", the one-line prompt in an inset row with a big Copy button.

4. Works with strip — Claude · ChatGPT · Cursor · Codex · OpenClaw · … any agent.

5. Skills — 2-up responsive grid of skill cards (collapses to 1 column < 760px).

6. Persistent setup — tabbed widget (Codex / Cursor / Claude Code / OpenClaw / Scripts) with copyable code blocks.

7. Contribute — PR call-to-action panel.

8. Footer — license, links, SKILL.md.

---

7. Interaction & motion

Transitions are short (.15s) and limited to color/border/transform.

Hover affordances: card lift, button border/color shift.

Copy actions give a 1.5s "Copied!" confirmation (label swap or checkmark).

Modal: fadeIn backdrop + slideUp box (~0.2–0.25s).

No scroll-jacking, parallax, autoplay, or looping decorative animation.

---

8. Voice & copy

Terse, imperative, developer-to-developer. Numbered steps ("① Paste this…"). Mono for

anything a machine consumes (paths, commands, URLs). Honest scale signals ("2 live",

"beta"). Both "humans and agents" addressed as readers.

---

9. Responsive

< 880px: hero ASCII stacks vertically, shrinks.

< 760px: skills grid → single column.

< 720px: nav text links hidden, page padding → 20px.

< 540px: hero padding tightens, wordmark shrinks, CTA row wraps.

---

10. Provenance

Adapted from [ethskills](https://github.com/austintgriffith/ethskills). Bot-readable by

design — each skill lives at //SKILL.md; the site is the human-facing index over

that same content. MIT licensed.

Download .md

License MIT
Uploaded 1 months ago
Version v1
File size 6.9 KB
Downloads 37
Copies 6

Use with MCP

Using designmd mcp, download the design system https://designmd.ai/jaybuidl/kleros-skills and implement it in my code

Don't have the MCP? Install it here