Skills
.Work. You
Rest

design-spec-author

Community

Generate a codebase-grounded DESIGN.md

Design & Creative#documentation#consistency#ui-ux#design-tokens#codebase-audit#design-spec
AuthorElvinOuyang
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Prevents DESIGN.md (the design source of truth) from drifting or being invented by forcing the spec to be derived from the existing codebase and only asking humans for the judgment calls that truly require taste and intent.

Core Features & Use Cases

  • Extracts observed design values from an iOS (SwiftUI/xcassets) or web (Tailwind/CSS vars/tokens) codebase and organizes them into a consistent 6-section DESIGN.md schema.
  • Authors DESIGN.md from scratch when none exists, then routes future work into audit/refresh when drift is detected.
  • Refreshes an existing DESIGN.md section-by-section using explicit decision options (spec wins / impl wins / mark divergence) rather than dumping a large diff.
  • Redirects appropriately when the user lacks a codebase signal (e.g., visual exploration should go to visual-ideation-moodboard, not spec authoring).

Quick Start

Ask the skill to draft or refresh DESIGN.md from the current codebase by saying: "Draft a DESIGN.md from this repo so it matches our current implementation, and resolve any inconsistent token choices with me."

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: design-spec-author
Download link: https://github.com/ElvinOuyang/claude-skill-collection/archive/main.zip#design-spec-author

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.