docs(design-md): sync skill with @google/design.md CLI 0.3.0 - #70494
Merged
Merged
Conversation
The design-md skill documented the Apr 2026 (0.1.x) CLI behavior, which has since drifted: - Lint rules: the skill listed 7 rules that no longer exist by those names (duplicate-section, invalid-color, wcag-contrast, unknown-component-property); the 0.3.0 linter runs 9 rules (contrast-ratio, orphaned-tokens, missing-primary, missing-typography, section-order, unknown-key, token-summary, missing-sections, broken-ref). Verified against live lint output. - Colors: any CSS color is now valid (oklch/rgb/named), not hex-only. - Export: json-tailwind (v3) + css-tailwind (Tailwind v4 @theme CSS) formats; 'tailwind' is a back-compat alias. New exit-code semantics (export exits 0 regardless of source lint findings). - Section order / duplicate headings are lint warnings, not file rejection (verified: duplicate + out-of-order sections exit 0). - Windows: documented the designmd dot-free bin alias (the design.md bin name collides with the .md file association); skill declares platforms: [windows]. - New pitfall: typography sub-property typos (fontwight) are silently dropped with no finding as of 0.3.0. All claims verified by running @google/design.md 0.3.0 live (lint, export, duplicate-section, oklch token, starter template lints clean). Docs page regenerated via generate-skill-docs.py.
alt-glitch
added
type/docs
Contributor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Syncs the
design-mdskill with the current@google/design.mdCLI (0.3.0, Jun 2026) — the skill documented the Apr 2026 0.1.x behavior, and several load-bearing claims had drifted.Changes
skills/creative/design-md/SKILL.md:duplicate-section,invalid-color,wcag-contrast,unknown-component-property); the 0.3.0 linter runs 9 rules (broken-ref,contrast-ratio,missing-primary,missing-typography,orphaned-tokens,section-order,unknown-key,token-summary,missing-sections).rgb(),oklch(), named), not hex-only.json-tailwind(Tailwind v3 JSON) +css-tailwind(Tailwind v4@themeCSS block);tailwinddocumented as back-compat alias. Export exit-code semantics (export exits 0 regardless of source lint findings).designmddot-free bin alias documented (thedesign.mdbin name collides with the.mdfile association); the skill declaresplatforms: [windows].fontwight) are silently dropped with no finding as of 0.3.0.website/docs/.../creative-design-md.md: regenerated viagenerate-skill-docs.py(unrelated regen drift reverted).Validation
Every claim verified by running
@google/design.md0.3.0 live:lintoutput (contrast-ratio, orphaned-tokens, unknown-key, ...)oklch()color token## Colors+ out-of-order sectionscss-tailwindexport@theme { --color-*, --text-*, ... }, exit 0templates/starter.mdAlso audited
claude-designin the same pass — it is current (v1.1.0, surface-first + slop diagnostic from #55399, local copy byte-identical to repo).Infographic