Skip to content

README: surface the DESIGN.md standard and fix "upload" wording#32

Merged
Owl-Listener merged 1 commit into
mainfrom
claude/readme-surface-design-md
May 31, 2026
Merged

README: surface the DESIGN.md standard and fix "upload" wording#32
Owl-Listener merged 1 commit into
mainfrom
claude/readme-surface-design-md

Conversation

@Owl-Listener

Copy link
Copy Markdown
Owner

What this does

Two small accuracy/visibility fixes in the Key Features section.

1. Fix misleading "upload" wording

The "Design taste" entry said "Upload an existing design system and it extracts..." — but nothing is uploaded. The design-taste skill reads a file that's already in your project, or one you point it at, and the design-md skill is explicit that it "does not fetch files from the internet." "Upload" implies an import feature that doesn't exist.

  • Before: "Upload an existing design system and it extracts the taste signals..."
  • After: "Point it at an existing design system — tokens, style guide, or Figma — and it reads them to extract the taste signals..."

The extraction capability itself is real and unchanged (it's verbatim from the skill) — only the mechanism wording is corrected.

2. Surface the DESIGN.md standard

DESIGN.md (Apache-2.0, google-labs-code/design.md, from Google Labs' Stitch) is a genuine selling point — an open, interoperable design-system format that works across Cursor, Copilot, and Stitch — but it was only mentioned in a single skill-table cell. This adds a proper "Open DESIGN.md standard" entry to Key Features, noting the high-fidelity token-driven build, the WCAG overlay Designpowers layers on top, and the design-library shelf.

Scope & safety

  • Surgical: 4 insertions, 2 deletions. The only existing line changed is the taste paragraph (reworded); one new paragraph added. Nothing else touched.
  • scripts/check-consistency.sh passes (exit 0); counts unaffected (still 36 skills / 10 agents).

Generated by Claude Code

Two small accuracy/visibility fixes in Key Features:

1. The "Design taste" entry said "Upload an existing design system" — but the
   skill never uploads; it reads a file already in your project or one you
   point it at (design-md is explicit: it does not fetch from the internet).
   Reworded to "Point it at an existing design system — tokens, style guide,
   or Figma — and it reads them to extract the taste signals..."

2. Added an "Open DESIGN.md standard" feature entry. DESIGN.md (Apache-2.0,
   google-labs-code/design.md, from Google Labs' Stitch) is a real selling
   point — interoperable with Cursor, Copilot, Stitch — but was only buried
   in one skill-table cell. Now surfaced in Key Features, with the WCAG
   overlay and the design-library shelf noted.

Additive/surgical: 4 insertions, 2 deletions, only the taste paragraph
reworded and one paragraph added. Consistency check passes (exit 0).
@Owl-Listener Owl-Listener marked this pull request as ready for review May 31, 2026 20:30
@Owl-Listener Owl-Listener merged commit b5c4a8c into main May 31, 2026
1 check passed
@Owl-Listener Owl-Listener deleted the claude/readme-surface-design-md branch May 31, 2026 20:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants