Nelle parole della skill
Questa skill legge una codebase frontend e scrive un DESIGN.md che catturi il suo linguaggio visivo, senza compilare o renderizzare l'app. Rileva il framework da package.json e dai file di configurazione (React, Vue, Svelte, Angular, Tailwind, CSS-in-JS, CSS puro), quindi analizza atmosfera, palette di colori e ruoli, tipografia, stili dei componenti, principi di layout e note per la generazione con Stitch.
L'output viene salvato in .stitch/DESIGN.md e deve iniziare con un blocco frontmatter YAML contenente name e una mappatura colors, perché altre skill lo analizzano. Pensata per designer e sviluppatori che fanno reverse engineering, audit o migrazione del design system di un progetto esistente.
Che cosa produce
- Un documento DESIGN.md assemblato nel formato standard del design system.
- Un blocco frontmatter YAML con name e una mappatura colors in cima al file, seguito dalle sezioni markdown.
- Una sezione finale di note del design system per la generazione con Stitch, che copre linguaggio, riferimenti ai colori e prompt dei componenti.
Come funziona
- 01Rilevare il Framework e lo Stack
Esamina la root del progetto in cerca di file rivelatori come package.json, tailwind.config.js, postcss.config.js, theme.js o tokens.js, poi legge package.json per capire il framework, gli strumenti CSS e le eventuali librerie di design token.
- 02Leggere il Riferimento del Framework Corrispondente
React/Next/Tailwind, Vue/Nuxt, Svelte, Angular e CSS puro dispongono ciascuno di un file di riferimento con pattern specifici per il framework per individuare colori, tipografia e spaziatura.
- 03Estrarre la Palette di Colori e Assegnare i Ruoli
I colori provengono da proprietà personalizzate CSS, configurazione Tailwind, file di tema, stili dei componenti, classi con scope e oggetti CSS-in-JS, poi vengono raggruppati per funzione piuttosto che per tonalità.
- 04Analizzare Componenti e Layout
La skill esamina bottoni, card, navigazione, campi di input e componenti specifici del dominio, oltre a griglia, spazio bianco, allineamento e comportamento responsive.
- 05Scrivere il DESIGN.md
Tutto viene assemblato nel formato standard di DESIGN.md e scritto in una directory .stitch, creata se non esiste.
- 06Passare Facoltativamente a Stitch
Se l'utente vuole che il design system venga caricato in Stitch, il file DESIGN.md scritto diventa l'input per lo skill manage-design-system.