Agent-Skills: il Google Engineer che ha insegnato AI coding agent a lavorare come senior (e GitHub e' impazzito)

AGENT-SKILLS: IL GOOGLE ENGINEER CHE HA INSEGNATO AI CODING AGENT A LAVORARE COME SENIOR SVILUPPATORI (E GITHUB E' IMPAZZITO) ================================================================= INTRO Immaginate un developer junior che, appena assunto, scrive codice tutto il giorno, non scrive mai un test, non fa code review, non documenta niente, e considera "fatto" qualsiasi cosa passi in compilazione. Ora immaginate che quel junior sia un coding agent AI — e che sia miliardi di volte più veloce a scrivere codice inaffidabile. Questo è il problema che Addy Osmani, engineering lead di Google Chrome, ha deciso di risolvere con un progetto open source apparentemente semplice: agent-skills. Il risultato? 62.704 stelle su GitHub, 11.684 stelle solo nell'ultima settimana, articoli su O'Reilly, sessioni live, e una community che — per una volta — non sta hypando aria fritta. ================================================================= COS'E' AGENT-SKILLS Agent-skills è una collezione di file markdown (sì, avete letto bene, markdown) che trasformano qualsiasi AI coding agent — Claude Code, Cursor, Gemini CLI, Windsurf, Copilot — in qualcosa che si comporta come un senior engineer con vent'anni di esperienza. Ogni "skill" non è un tutorial, non è una lista di best practice, non è un saggio. E' un WORKFLOW: una sequenza di passi che l'agente deve eseguire, con checkpoint che producono evidenza verificabile e criteri di uscita ben definiti. Il repository offre 7 slash command che mappano il ciclo di vita dello sviluppo software classico: /spec — Definisci cosa costruire (spec prima del codice, sempre) /plan — Pianifica come costruirlo (task atomici, piccoli) /build — Implementa incrementalmente (una fetta alla volta) /test — Dimostra che funziona (i test sono la prova) /review — Rivedi prima del merge (migliora la salute del codice) /code-simplify — Semplifica il codice (chiarezza > furbizia) /ship — Metti in produzione (più veloce è più sicuro) Il tocco geniale? Ogni skill include una tabella di ANTI-RASIONALIZZAZIONE: scuse tipiche che un agente (o uno sviluppatore stanco) potrebbe usare per saltare il workflow, accompagnate da una confutazione scritta. Esempio: "Questo task è troppo semplice per avere una spec" → "Accettato. Scrivi tre righe che spieghino cosa stai facendo." Sembra una banalità. E invece è l'unica cosa che funziona. ================================================================= PERCHE' E' VIRALE Il motivo per cui agent-skills sta spopolando non è perché è complesso. E' perché è ONESTO. Negli ultimi due anni, abbiamo assistito a un'esplosione di coding agent AI. Claude Code, Cursor, Copilot, Gemini CLI — tutti promettono di scrivere codice più velocemente. E lo fanno. Il problema è che il codice che scrivono è tecnicamente funzionante ma praticamente insostenibile. Il comportamento predefinito di ogni AI coding agent è prendere la strada più breve verso "fatto". Chiedi una feature, scrive la feature. Non chiede se hai una spec. Non scrive un test prima dell'implementazione. Non considera se il cambiamento attraversa un confine di sicurezza. Non controlla come apparirà la PR a un reviewer umano. Addy Osmani lo spiega benissimo: "Il senior engineer di ogni task include lavoro che non appare nel diff: esplicitare assunzioni, scrivere la spec, suddividere il lavoro in chunk reviewabili, scegliere il design noioso, lasciare evidenza che il risultato è corretto." E la community ha risposto. A febbraio il repo aveva qualche centinaio di stelle. A giugno ha superato 62.000. Sono state aperte centinaia di pull request con nuove skill, traduzioni, adattamenti per tool diversi. La sessione live su YouTube con Addy ha fatto il pienone. La differenza con altri "AI rules" repo? Agent-skills non è un saggio di 2000 parole sul testing. E' una sequenza di passi che l'agente PUO' ESEGUIRE. Processo, non prosa. ================================================================= COME FUNZIONA Se avete mai lavorato in un'azienda di software seria, riconoscerete immediatamente lo schema. E' lo stesso SDLC che ogni organizzazione funzionante adotta, solo in vocaboli diversi. Google lo chiama design doc, review, implementation, readability review, launch checklist. Amazon lo chiama working-backwards memo e bar raiser. Ogni team sano ha una versione di questo loop. Il problema è che gli agenti AI saltano la maggior parte di queste fasi di default. Agent-skills li costringe a passare attraverso le stesse fasi che un senior engineer si impone, perché shipare codice senza passare da lì è il modo più veloce per produrre incidenti. L'installazione è semplicissima. Per Claude Code, si installa come plugin dal marketplace con un comando: /plugin marketplace add addyosmani/agent-skills Per Cursor, basta copiare gli SKILL.md in .cursor/rules/. Per Gemini CLI, si installa come skill nativa. E così via per Windsurf, Copilot, OpenCode, e Kiro. Una feature complessa potrebbe attivare undici skill in sequenza. Un piccolo bug fix ne usa tre. Il router decide quali applicare. Il punto è che il workflow scala allo SCOPO REALE, non allo scopo presunto. E poi c'è il tocco di classe: /build genera automaticamente il piano e implementa ogni task in un unico passaggio approvato. Tu approvi il piano una volta, e poi l'agente esegue in autonomia — ma ogni task è test-driven e committato individualmente, e si mette in pausa sugli errori e sui passi rischiosi. ================================================================= IL VERDETTO Agent-skills non è il progetto più sexy del momento. Non genera video, non clona voci, non fa analisi di mercato. E' un insieme di file markdown che dicono agli agenti AI di comportarsi da adulti. Ed è proprio per questo che sta spopolando. Perché la verità, che tutti gli sviluppatori sanno ma pochi ammettono, è che il codice non è il problema. Il problema è tutto quello che sta intorno al codice: la spec, il test, la review, la documentazione, il deployment sicuro. Gli agenti AI sono fantastici a scrivere codice. Sono terribili a fare il resto. Agent-skills non risolve la scarsità di codice. Risolve la scarsità di disciplina — che è, ironicamente, il problema che nessun tool AI aveva mai affrontato seriamente. Vale la pena provarlo? Sì, se usate AI coding agent in produzione. No, se pensate che il vostro agente sia già perfetto così. Ma in questo caso, preparatevi alla chiamata delle 3 di notte per l'incidente che il vostro agente ha causato mentre voi eravate convinti che "funzionasse". E se siete sviluppatori in Italia che stanno sperimentando con Claude Code o Cursor, questa è probabilmente la cosa più utile che possiate installare oggi. Perché un agente che segue le regole è meglio di un agente che segue l'ispirazione. Sempre.