design-system
在首次 markdown 转 HTML 转换之前设置品牌设置,或更改这些设置时使用。通过 onboard.py 运行包含 10 个问题的引导流程(颜色、字体、样式、TOC),并通过 brand_palette_validator.py 拒绝未通过 WCAG AA 的调色板。
机器翻译查看英文原文
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.
适用对象:设计与内容创作。自动收录 · 待核查。
原作者说明节选
从固定版本的 SKILL.md 提取,保留原文语言。以下内容属于作者说明,本站尚未验证安装、兼容或运行结果。
查看英文原文
原文涵盖的主题
- 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
这里只展示节选,请以完整原文和当前要求为准。
- 来源仓库
- alirezarezvani/claude-skills
- 源文件
- markdown-html/skills/design-system/SKILL.md
- 固定版本
- 8f082544116fc0d014188e521ca40304cdfc86b0
准备条件
- 本条仅收录原作者的技能元数据;请阅读完整说明,确认依赖、许可与使用条件。
第一件可以尝试的小事
先阅读原作者说明,再决定是否在自己的 AI 工具中使用。
对应 AI 工具说明
作者有说明不等于本站实机验证。没有证据时,不自动标为兼容、安全或免费。
来源与内容状态
本条为自动发现的元数据,尚未完成人工文档核查;适用性与运行结果待核查。
原作者:alirezarezvani/claude-skills · 原作者仓库元数据。文档核查:未核查。最近来源检查:2026-11-09T14:01:46.994Z。
分类由名称、说明与路径规则生成,分类不代表已核实适配。
许可与权利归属
MIT。第三方内容及版权归原作者,使用条件以原文为准。
许可原文 ↗本站没有因同步、复制或用户自报成功而将资源标为运行验证通过。
限制与注意事项
- 元数据收录不代表本站已经安装、适配、实测或进行安全审查。