Impeccable non è ArtCraft e non fa parte dei prodotti o della suite ArtCraft; questa pagina è una guida indipendente e le informazioni ufficiali sono su impeccable.style e github.com/pbakaus/impeccable.
Impeccable: il vocabolario di design per il tuo agente di codice
Impeccable è uno skill di design e uno strumento da riga di comando open source che dà al tuo agente di programmazione un vocabolario condiviso per rivedere, correggere e rifinire le interfacce. L'ha creato Paul Bakaus, partendo dallo skill frontend-design di Anthropic, con licenza Apache-2.0. Questa pagina è una guida indipendente, non la documentazione ufficiale.
- 24 comandi: critique, polish, audit, typeset, distill e altri
- Rilevatore con 62 regole deterministiche, senza LLM e senza chiave API
- Funziona con Claude Code, Cursor, Codex CLI, Copilot e 19 agenti in totale
Sito ufficialeRepository GitHubDocumentazione
Ultimo aggiornamento: · English
Che cos'è Impeccable
Impeccable è uno skill che si installa nell'agente di codice e gli fornisce un vocabolario di design, insieme a una CLI autonoma. Non apre una tela: trasforma il design in azioni che l'agente può eseguire, dalla critica alla tipografia, passando per pulizia e messa in sicurezza. Nasce dallo skill frontend-design di Anthropic ed è distribuito con licenza Apache-2.0.
Il bersaglio è il gusto predefinito degli agenti: Inter ovunque, gradienti viola-blu, card dentro card, testo grigio su sfondi colorati, una mattonella arrotondata con icona sopra ogni titolo. 62 regole deterministiche segnalano questi tic durante la modifica, senza LLM e senza chiave API.
Dà il meglio su interfacce già esistenti: si indica una pagina o un componente e si itera. Sa costruire anche pagine nuove, ma il progetto stesso ammette che quella modalità è più difficile. Va detto con chiarezza: Impeccable è un progetto open source indipendente, non un prodotto ArtCraft né parte della sua suite.
Installazione e configurazione
Esegui il comando dalla radice del progetto. npx richiede Node 18.19 o superiore. L'installer rileva i tuoi strumenti, chiede se installare per il progetto o globalmente e propone l'hook di design dove l'ambiente lo supporta. Conviene accettarlo.
Poi ricarica lo strumento ed esegui /impeccable init ($impeccable init su Codex). Per gli script puoi passare --providers=claude,codex,cursor e --scope=project|global. Un'installazione esistente si aggiorna con npx impeccable update.
npx impeccable install- Verifica Node 18.19+ e apri la radice del progetto.
- Esegui npx impeccable install, scegli l'ambito di progetto o globale e attiva l'hook di design se disponibile.
- Ricarica lo strumento di codice ed esegui /impeccable init ($impeccable init su Codex) per generare PRODUCT.md.
- Se vuoi fissare il sistema visivo, esegui /impeccable document e crea DESIGN.md; poi tieni tutto aggiornato con npx impeccable update.
Comandi principali
I comandi sono 24. Si usano come «comando + obiettivo», per esempio /impeccable critique the pricing cards; su Codex sostituisci la barra con $. Digitando solo /impeccable compare l'elenco. Questi sono i sette più utili.
| Comando | Cosa fa | Quando usarlo |
|---|---|---|
/impeccable init | Legge il codice, chiede solo ciò che non può dedurre e scrive PRODUCT.md. | Una volta all'inizio del progetto, per dare contesto ai comandi successivi. |
/impeccable critique | Produce una revisione UX con punteggio basata su euristiche di usabilità e ordina le correzioni. | Prima di un restyling o per capire dove si blocca un flusso. |
/impeccable polish | Esegue l'ultimo passaggio prima della pubblicazione. | Quando le funzionalità sono chiuse e il lancio è vicino. |
/impeccable audit | Redige un report tecnico su accessibilità, prestazioni, temi, responsive e integrità dell'implementazione, con rilievi da P0 a P3. | Prima di una release o per smaltire debito implementativo. |
/impeccable typeset | Corregge font, gerarchia, dimensioni e spaziature. | Quando la tipografia appare molle o la gerarchia non si legge. |
/impeccable distill | Toglie ciò che la pagina non richiede. | Quando c'è troppo contenuto e il fuoco si perde. |
/impeccable hooks status|on|off | Mostra, attiva o disattiva l'hook di design, che analizza i file di interfaccia modificati dall'agente. | Per verificare che il controllo automatico funzioni o per sospenderlo. |
Flusso di lavoro consigliato
Prima il contesto, poi lo schermo. init chiede solo ciò che non può dedurre: a chi serve il prodotto, cosa deve fare e quali vincoli esistono. Le risposte finiscono in PRODUCT.md e vengono lette da tutti i comandi successivi. Se esiste già un sistema visivo, esegui document e annota le regole di marca in DESIGN.md, così l'agente non cambia stile a metà strada.
Più l'obiettivo è stretto, migliore è il risultato. Invece di «rifai tutta la pagina», prova «critique sulle card dei prezzi». I comandi ricorrenti si fissano con /impeccable pin audit, che crea la scorciatoia /audit; prima di pubblicare si chiude con audit e poi polish.
- Esegui /impeccable init una volta per progetto e rileggi il PRODUCT.md prodotto.
- Se hai già un design system, lancia /impeccable document e riassumi font, colori e componenti in DESIGN.md.
- Itera per sezioni: /impeccable critique the pricing cards, poi bolder, quieter, distill o typeset per correggere la direzione.
- Prima della pubblicazione esegui /impeccable audit e /impeccable polish, e fissa i comandi più usati con pin.
Agenti supportati
L'elenco ufficiale è ampio: Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness e Veto. L'installazione cambia da strumento a strumento; l'elenco completo è nella documentazione ufficiale.
Claude Code, Copilot e Grok hanno plugin; l'hook di design è disponibile su Claude Code, Cursor, Codex, GitHub Copilot, Grok Build e Hermes Agent. Su Codex va approvato l'hook di progetto in /hooks, su Grok Build serve /hooks-trust, su Hermes va abilitato il plugin.
Se non vuoi installare Node, puoi copiare a mano la cartella dello skill. Per usare solo il rilevatore, npx impeccable detect funziona senza agente. La modalità live supporta Vite, Next, SvelteKit, Astro, Nuxt e HTML semplice, ma modifica solo una copia locale.
Impeccable e ArtCraft MCP
I nomi si somigliano perché entrambi mettono l'agente al lavoro, ma stanno su livelli diversi. Impeccable interviene sul codice sorgente dell'interfaccia; ArtCraft MCP è il MCP/CLI ufficiale per singola app di storytold, che pilota le Crafting Apps locali come PhotoCraft. Non è nemmeno l'API in abbonamento della community che usa il nome artcraft-mcp.
| Dimensione | Impeccable | ArtCraft MCP |
|---|---|---|
| Su cosa agisce | Codice front-end nel repository: componenti, JSX/TSX, CSS e struttura delle pagine. | Crafting Apps locali (per esempio PhotoCraft) e i loro flussi di immagini e video. |
| Cosa produce | Consigli di design, modifiche al codice, report critique/audit e i file PRODUCT.md e DESIGN.md. | Immagini o video e operazioni automatizzate dentro quelle applicazioni. |
| Quando sceglierlo | Per costruire, valutare o rifinire un'interfaccia front-end. | Per generare o elaborare immagini e video in serie e automatizzare il lavoro nelle app. |
| Si completano? | Sì: l'interfaccia con Impeccable, la produzione di materiali con ArtCraft MCP. | Sì, ma solo per gli asset multimediali: non fa revisione di design dell'interfaccia e non sostituisce Impeccable. |
Guida ad ArtCraft MCPCrafting Apps
Confini e sicurezza
Impeccable è uno skill di design front-end e una CLI, non un'app di design né un generatore di immagini. La modalità live modifica solo una copia locale; non inserirla in un sito pubblicato e non allentare la CSP di produzione per farla funzionare.
Gli hook girano fuori dall'approvazione del modello. In Claude Code un hook di comando installato può essere eseguito anche se rifiuti i comandi del modello, e la prima modifica può scaricare il motore. Controlla gli hook prima di esecuzioni non presidiate o disattivali con --settings '{"disableAllHooks": true}'.
La telemetria registra in forma anonima quali direzioni visive sono state mostrate e quale è stata scelta; non invia nome del progetto, file, codice o PRODUCT.md. Si disattiva con npx impeccable telemetry off, DO_NOT_TRACK=1 oppure "telemetry": false in .impeccable/config.json. Nel rilevatore il codice di uscita 2 indica rilievi, 1 un obiettivo non analizzabile.
Guide correlate
Domande frequenti
Che cos'è Impeccable, ed è un prodotto ArtCraft?
Impeccable è uno skill di design e una CLI per agenti di codice creato da Paul Bakaus, con 24 comandi e un rilevatore di 62 regole sotto licenza Apache-2.0. Non è un prodotto ArtCraft e non appartiene alla sua suite. Questa pagina è una guida indipendente; le fonti ufficiali sono impeccable.style e github.com/pbakaus/impeccable.
Come si installa?
Dalla radice del progetto esegui npx impeccable install e ricarica lo strumento. Poi lancia /impeccable init, oppure $impeccable init su Codex, per creare PRODUCT.md. npx richiede Node 18.19 o superiore e npx impeccable update aggiorna un'installazione esistente; i passaggi completi sono su impeccable.style/docs.
Che differenza c'è tra critique e audit?
critique è una revisione UX con punteggio basata su euristiche di usabilità e indica cosa correggere per primo. audit è un report tecnico su accessibilità, prestazioni, temi, responsive e integrità dell'implementazione, con rilievi classificati da P0 a P3. Il primo giudica l'esperienza, il secondo l'ingegneria, e di solito si usano in sequenza.
Serve una chiave API?
Al rilevatore no: le sue 62 regole sono deterministiche e non chiamano LLM né leggono chiavi. Anche lo skill gira dentro il tuo agente, quindi non serve una chiave del modello aggiuntiva. La telemetria si può disattivare con npx impeccable telemetry off o DO_NOT_TRACK=1.
Con quali agenti funziona?
Con Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness e Veto. Installazione e supporto degli hook variano per strumento; l'elenco aggiornato è su impeccable.style/docs.
Impeccable o ArtCraft MCP?
Dipende da cosa vuoi cambiare. Impeccable lavora sul codice dell'interfaccia e restituisce consigli, modifiche e revisioni. ArtCraft MCP pilota app locali come PhotoCraft per produrre immagini e video e automatizzarne i flussi. Si possono combinare, ma ArtCraft MCP non è uno strumento di revisione del design e non sostituisce Impeccable.
Nota di indipendenza
Impeccable è un progetto open source indipendente creato da Paul Bakaus. Non ha legami con ArtCraft, non è un prodotto ArtCraft e non fa parte della sua suite né dei suoi componenti ufficiali. Questa pagina è scritta da terzi per lettori italiani; per comandi, requisiti e novità il riferimento è il sito ufficiale impeccable.style e il repository github.com/pbakaus/impeccable. ArtCraft MCP è un'altra integrazione ufficiale, dedicata alle Crafting Apps, e risolve un problema diverso.
Sources
Every fact on this page comes from the pages below, checked on 3 November 2026.