KeiSeiKit-1.0/skills/design-system/SKILL.md
Parfii-bot a4e667de10 KeiSeiKit-public — clean state
Single-commit clean baseline after security scrub of niche-tells,
project codenames, internal jargon, and contributor-email leaks.

Contents:
- 100 Rust crates (_primitives/_rust/)
- 37 agent manifests (_manifests/) + generated specs (_generated/)
- 67 user-invocable skills (skills/)
- 33 hooks (hooks/)
- Composition blocks (_blocks/)
- Documentation (docs/, README.md)
- TS adapter packages (_ts_packages/)
- Assembler (_assembler/)
- Roles (_roles/)
- Templates (_templates/)
- Forgejo CI (.forgejo/)

Author: Denis Parfionovich <info@greendragon.info>

License: see LICENSE.
2026-05-01 12:09:03 +08:00

1.9 KiB

name description arguments
design-system Use when building a design system — tokens, base components, Tailwind config, dark mode, docs
name description required
name Design system / project name true
name description required
style Visual direction: minimal, playful, corporate, editorial false

Design System Workflow

Step 1: Define Tokens

Design tokens (adapt to existing project if any):

Colors

  • Primary: main brand color + 50-950 scale
  • Secondary: accent color + scale
  • Neutral: gray scale for text, borders, backgrounds
  • Semantic: success, warning, error, info
  • Surface: background levels (0, 1, 2, 3)

Typography

  • Font families: heading, body, mono
  • Size scale: xs, sm, base, lg, xl, 2xl, 3xl, 4xl
  • Weight: normal, medium, semibold, bold
  • Line heights: tight, normal, relaxed

Spacing

  • Scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24

Other

  • Border radius: none, sm, md, lg, full
  • Shadows: sm, md, lg, xl
  • Transitions: fast (150ms), normal (300ms), slow (500ms)

Step 2: Tailwind Config

  • For Tailwind 4: declare tokens in CSS via @theme { ... } (no tailwind.config.ts)
  • For Tailwind 3: generate tailwind.config.ts with all tokens
  • CSS custom properties for runtime theming
  • Dark mode: class strategy with token overrides

Step 3: Base Components

Core primitives (adjust to framework):

  • Button (primary, secondary, ghost, destructive + sizes)
  • Input (text, textarea, select + states)
  • Card (surface levels, padding variants)
  • Badge (status colors + sizes)
  • Typography components (Heading, Text, Label)

Step 4: Dark Mode

  • Map all color tokens to dark equivalents
  • Test contrast ratios (WCAG AA minimum: 4.5:1 text, 3:1 large text)
  • Surface hierarchy inverts (dark bg, lighter cards)

Step 5: Documentation

  • Token reference table
  • Component API (props, variants, examples)
  • Usage guidelines (do's and don'ts)