Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Design & UI

skillshare-ui-website-style

Skillshare frontend design system for the React dashboard (ui/) and Docusaurus website (website/). Use this skill whenever you: build or modify a dashboard page or component in ui/src/, style or layout website pages or custom CSS in website/, create new React components for the dashboard, add pages to the dashboard, fix visual bugs in either frontend, or need to know which design tokens, ss-* classes, components, or patterns to use. Covers the two dashboard styles (Clean / Playful) in light and dark, design tokens, the ss-* class system, component API, page structure, accessibility, keyboard shortcuts, and anti-patterns. Even if the user just says "fix the styling" or "add a card", use this skill to ensure consistency.

runkids · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add runkids/skillshare --skill skillshare-ui-website-style

About this skill


name: skillshare-ui-website-style description: >- Skillshare frontend design system for the React dashboard (ui/) and Docusaurus website (website/). Use this skill whenever you: build or modify a dashboard page or component in ui/src/, style or layout website pages or custom CSS in website/, create new React components for the dashboard, add pages to the dashboard, fix visual bugs in either frontend, or need to know which design tokens, ss-* classes, components, or patterns to use. Covers the two dashboard styles (Clean / Playful) in light and dark, design tokens, the ss-* class system, component API, page structure, accessibility, keyboard shortcuts, and anti-patterns. Even if the user just says "fix the styling" or "add a card", use this skill to ensure consistency. metadata: targets: [claude, universal]

Enforce the skillshare design system across the two frontends. $ARGUMENTS is the file or area being worked on.

Before acting, run python3 scripts/ai-context.py frontend. That topic and the CSS/source files it identifies are the source of truth; this skill retains the component catalog and visual QA checklist.

AspectUI Dashboard (ui/)Website (website/)
StackReact 19 + Vite + Tailwind CSS v4Docusaurus 3 + custom CSS
Source of truthui/src/components.css (tokens + ss-* classes), ui/src/index.css (Tailwind mapping)website/src/css/custom.css (docs), website/src/pages/*.module.css (homepage, features)
LooksTwo styles, Clean and Playful, each in light and darkDocs: clean. Homepage: hand-drawn string board

This file names tokens and classes and says when to use them. It does not copy their values. Colours, radii, fonts and shadows change; read them from the CSS when you need one.


UI Dashboard (ui/)

Reference pages: ui/src/pages/TargetsPage.tsx (list page), ui/src/pages/HubPage.tsx (tabs), ui/src/pages/ResourcesPage.tsx (list + tiles + bulk toolbar).

Design rules and the reasoning behind them: references/STYLE_GUIDE.md.

Two styles, two modes

Style and mode are independent, so every screen has four looks.

AxisValuesHow it is set
StyleClean, Playful (default)html[data-theme="playful"]; attribute absent = Clean
Modelight, dark, systemhtml.dark

Set by ui/src/context/ThemeContext.tsx, switched in ThemePopover.tsx. ?theme=clean|playful|dark|light in the URL forces one, which is handy for screenshots.

All four looks come from CSS variables alone. A page that uses only tokens and ss-* classes gets all four for free; a hardcoded colour, radius or shadow breaks three of them.

  • Clean: system font, 1px hairlines, soft shadows, ink-coloured primary button.
  • Playful: Kalam headings, 2px ink borders, hard offset shadows, dashed separators, yellow primary, pastel accents, dot-grid background, sticky-note tiles.
  • Style-only markup: .ss-only-clean / .ss-only-playful (Dashboard shows a count strip in Clean and a pin board in Playful).

Design tokens

Defined per look at the top of ui/src/components.css. ui/src/index.css exposes them to Tailwind through @theme inline, so text-ink-2, bg-surface, border-line all follow the active look.

GroupTokensUse
Surfaces--bg --side --surface --sunkenPage, sidebar, cards and inputs, recessed headers and footers
Text--ink --ink-2 --ink-3Primary, secondary, tertiary and placeholder
Lines--line --line-2 --line-softFrames, control borders, soft dividers
Borders--sep --frame --bwWhole border values: row separator, box frame, control border width
Action--pri --on-pri --accent --accent-bg --sel --sel-inkPrimary button, links and focus, selected nav and menu items
Status--ok --warn --bad, each with -bgText or dot colour, plus its tinted background
Kind--c-skill --c-agent --c-extra --c-mcp --c-plugin --c-target, each with -bgResource-kind colour, used by .ss-cat
Pastels--pa --pb --pc --pd --pePlayful only. Never reference outside a [data-theme="playful"] rule
Type--f --fh --fm --h1 --h2Body, heading (Kalam in Playful), mono, heading shorthands
Shape--r-ctl --r-btn --r-box --r-tagControls, buttons (pill), boxes, tags
Shadow--sh-box --sh-btn --sh-float --sh-dialogBoxes, buttons, menus and toasts, dialogs

Tailwind names: bg side surface sunken ink ink-2 ink-3 line line-2 line-soft sel pri on-pri ok warn bad (with -bg) and link / link-bg for --accent.

Legacy names: pencil, pencil-light, paper, paper-warm, muted, muted-dark, success, warning, danger, blue, info, accent still resolve as aliases for markup not yet migrated. Do not use them in new code. When you touch a line that has one, replace it:

LegacyUse
text-penciltext-ink
text-pencil-lighttext-ink-2
text-muted-darktext-ink-3
bg-paper / bg-paper-warmbg-bg / bg-side
border-mutedborder-line
text-success / text-warning / text-dangertext-ok / text-warn / text-bad
text-blue / text-infotext-link

ui/src/design.ts (radius, shadows, palette) forwards to the same variables, for inline styles only.

The ss-* classes

All in @layer components in ui/src/components.css. List what exists today:

grep -o '\.ss-[a-z0-9-]*' ui/src/components.css | sort -u

State and variant are short modifier classes on the same element: .on (selected or checked), .sel (selected row or tile), .ok .warn .bad .inf (tone), .sm .lg (size).

AreaClasses
Page.ss-wrap (1080px column, 28px
Read the complete source ↗