Agent skill · design visual · alirezarezvani
design-system
Use when setting up brand settings before the first markdown-to-HTML conversion, or changing them. Runs a 10-question onboarding with onboard.py (colors, fonts, style, TOC) and refuses palettes that fail WCAG AA via brand_palette_validator.py.
Why this skill is useful
Adds a set of three Python scripts for onboarding and validating brand identity that are not commonly found in public documentation.
What it needs
Requires python3 installed locally. About 6k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
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 configloader.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. configloader.py — importable customization loader with project > global > defaults precedence and MARKDOWNHTMLNOCONFIG=1 bypass. 3. brandpalettevalidator.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 setupcompletedat is null Refuse conversion, surface onboarding User wants per-repo brand override python3 .../onboard.py --scope project User wants to change a single field non-interactively python3 .../onboard.py --set brand.primary=#FF6B35 User wants to reset and re-onboard python3 .../onboard.py --reset then re-run User wants zero-touch defaults (CI, ephemeral session) python3 .../onboard.py --defaults Headless / containerized run that should ignore saved config MARKDOWNHTMLNOCONFIG=1 ... …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/design-system--debe5a