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.
Target: Design & content creation. Automatically collected · unverified.
Excerpt from the author’s documentation
Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.
Read the original English text
Topics in the source
- Design System — Onboarding + Shared Brand Tokens
- When to invoke
- Onboarding question set (10 questions)
- Hard rules
- Derived 12-token palette
- Forcing-question library (Matt Pocock grill-with-docs pattern)
- Customization in use (worked example)
- Assumptions
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). | 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
This is an excerpt. Refer to the complete source and its current requirements.
- Source repository
- alirezarezvani/claude-skills
- Source file
- markdown-html/skills/design-system/SKILL.md
- Fixed revision
- 8f082544116fc0d014188e521ca40304cdfc86b0
Sources and evidence
This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.
Author: alirezarezvani/claude-skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-09T14:01:46.994Z.
Categories are inferred from names, descriptions and paths. They do not establish compatibility.
License and attribution
MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.
Original license ↗Synchronization, copying and user-reported success do not mark a resource as runtime-tested.
Limitations and notes
- Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.