Agent skill · Frontend

design-system

Captures the user's brand identity once via a 10-question onboarding wizard (primary/accent HEX + heading + body Google Fonts + design style editorial/technical/minimal/playful + default output directory + syntax theme + TOC behavior + optional logo/company), validates body-text and link contrast against WCAG 2.2 AA, derives 12 CSS custom properties in HSL space, and stores the result for every markdown-html converter to consume. Use before any markdown-html conversion. Triggers on first-run onboarding ("set up the brand", "configure markdown-html", "run onboarding"), on explicit reset ("reset

Alireza Rezvani23,369★ · +428/wk · 1 repos on radarProfile →
claude-codecodexcursorships scriptsMIT
Install
npx skills add alirezarezvani/claude-skills --skill design-system --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 8
SKILL.md size: 11 KB
Bundled scripts: yes
Version: 2.10.0
Declared author: Alireza Rezvani
Path: markdown-html/skills/design-system/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 23,791 · +422 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Design System — Onboarding + Shared Brand Tokens The design-system skill is the **shared brand owner** for the markdown-html plugin. Run its onboarding once. Every converter (`md-document`, `md-review`, `md-slides`) reads the resulting config via `config_loader.py` and applies the same 12 CSS custom properties to its output. Without this, conversions render with placeholder defaults — technically functional but unbranded. This skill ships exactly three Python tools: 1. **`onboard.py`** — interactive (or `--defaults` / `--set` / `--show` / `--reset`) wizard. 2. **`config_loader.py`** — importable customization loader with project > global > defaults precedence and `MARKDOWN_HTML_NO_CONFIG=1` bypass. 3. **`brand_palette_validator.py`** — WCAG-AA contrast checker + HSL palette deriver. All three are stdlib-only and contain no LLM calls (deterministic per Path-B discipline). ## When to invoke | Symptom | Action | |---|---| | User says "convert this markdown to HTML" for the first time in this workspace | Run `python3 markdown-html/skills/design-system/scripts/onboard.py` | | `~/.config/markdown-html/design-system.json` doesn't exist OR `setup_completed_at` is null | Refuse conversion

What's inside
Steps it walks through
  1. When to invoke
  2. Onboarding question set (10 questions)
  3. Hard rules
  4. Derived 12-token palette
  5. Forcing-question library (Matt Pocock grill-with-docs pattern)
  6. Customization in use (worked example)
  7. Assumptions
  8. Non-goals
  9. Distinct from
  10. Output artifact
  11. Anti-patterns (do not)
  12. References
Ships with 7 files
  • assets/design_system_schema.json
  • references/design_token_canon.md
  • references/typography_pairing.md
  • references/wcag_accessibility.md
  • scripts/brand_palette_validator.py
  • scripts/config_loader.py
  • scripts/onboard.py
Commands it runs
First-run onboarding (interactive, walks all 10 questions)
python3 markdown-html/skills/design-system/scripts/onboard.py
Zero-touch defaults for CI / first-test
python3 .../onboard.py --defaults
Change just the primary color and design style
python3 .../onboard.py --set brand.primary=#FF6B35 --set design_style=editorial
Per-repo override
python3 .../onboard.py --scope project --set design_style=minimal
Reset and re-onboard
python3 .../onboard.py --reset
More from claude-skills
All skills →
signup-flow-croWhen the user wants to optimize signup, registration, account creation, or trial activation flows.…Design & Presentationstrategic-alignmentCascades strategy from boardroom to individual contributor. Detects and fixes misalignment between…Otherprocess-mapperUse when a BizOps lead, COO, or process-improvement owner needs to document an end-to-end business…Design & Presentationsaas-scaffolderGenerates complete, production-ready SaaS project boilerplate including authentication, database…Securitysecrets-vault-managerUse when the user asks to set up secret management infrastructure, integrate HashiCorp Vault…Securityab-test-setupWhen the user wants to plan, design, or implement an A/B test or experiment. Also use when the user…Testing & QA
About this skill
What does the design-system skill do?

Captures the user's brand identity once via a 10-question onboarding wizard (primary/accent HEX + heading + body Google Fonts + design style editorial/technical/minimal/playful + default output directory + syntax theme + TOC behavior + optional logo/company), validates body-text and link contrast against WCAG 2.2 AA, derives 12 CSS custom properties in HSL space, and stores the result for every markdown-html converter to consume. Use before any markdown-html conversion. Triggers on first-run onboarding ("set up the brand", "configure markdown-html", "run onboarding"), on explicit reset ("reset

How do I install it?

Run `npx skills add alirezarezvani/claude-skills --skill design-system --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From alirezarezvani/claude-skills, a repository with 23,791 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going
All skills →
The full catalog, by category and by tool.
Open Source Radar →
The repositories these skills come from, watched daily.
The people behind them →
Makers and builders across the ecosystem.