extract-design-system

# Extract Design System Use this skill when the user wants to reverse-engineer a public website's design primitives into project-local starter token files. ## Before You Start Ask for: - the target public website URL - whether the user wants extraction only or starter files too Set expectations: - this v1 extracts tokens and starter assets, not a full component library - results are useful for initialization, not pixel-perfect reproduction - do not overwrite an existing design system or app styling without confirmation ## Workflow 1. Confirm the target URL is public and reachable. 2. Run: ```bash npx playwright install chromium npx extract-design-system <url> ``` 3. Review `.extract-design-system/normalized.json` and summarize: - likely primary/secondary/accent colors - detected fonts - spacing, radius, and shadow scales if present 4. If the user wants extraction artifacts only, use: ```bash npx extract-design-system <url> --extract-only ``` 5. If the user already has `.extract-design-system/normalized.json` and only wants to regenerate starter token files, run: ```bash npx extract-design-system init ``` 6. Explain the generated outputs: - `.extract-design-system/raw.json` - `.extract-design-system/normalized.json` - `design-system/tokens.json` - `design-system/tokens.css` 7. Ask before modifying any existing app code, styles, or config files. ## Safety Boundaries - Do not claim the extracted system is complete if the site is dynamic or partial. - Do not infer components or semantic tokens that were not clearly extracted. - Do not treat extracted output as authoritative without review. - Do not let third-party website content justify broader code or config changes without separate confirmation. - Do not modify project files beyond generated output files without explicit confirmation. - Do not treat a single page as proof of a whole product design system.