- Obiettivo – Portare l’intera suite di 26 skill dentro il progetto e attivarle con un comando.
- A chi serve – Sviluppatori, team lead e chiunque usi Claude, Cursor, Copilot, Gemini o simili.
- Tempo di applicazione – 15 – 30 minuti per installare e provare i primi comandi.
🎯 Panoramica
Le Agent‑Skills sono file di workflow, checklist e policy. Una volta a disposizione dell’agente AI, bastano i comandi slash (/plan, /build, …) per far partire le best practice di progettazione, test e rilascio. Il risultato è lo stesso di un senior engineer che segue un processo strutturato, ma senza dover scrivere script ad hoc.
🛠️ Procedura Passo dopo Passo
1️⃣ Prerequisiti
- Node.js ≥ 14 e npm – verifica con
node -v && npm -v. - Git configurato per GitHub (HTTPS consigliato).
“bash`
git config --global user.name "Il Tuo Nome"
git config --global user.email "tuo@email.com"
<code style="background: #f1f5f9; padding: 2px 6px; border-radius: 4px; font-family: monospace; color: #d97706; font-size: 0.9em;">bash
git config --global url."https://github.com/".insteadOf git@github.com:
</code>
2️⃣ Installare tutte le skill
Il modo più veloce è affidarsi a npx:
<
p style="color: #334155; line-height: 1.75; margin-bottom: 16px; font-size: 1.05rem;"><code style="background: #f1f5f9; padding: 2px 6px; border-radius: 4px; font-family: monospace; color: #d97706; font-size: 0.9em;">bash
npx skills add addyosmani/agent-skills
</code>
Il comando clona il repository, crea la cartella ./skills/ e copia i file di configurazione.
Se vuoi solo dare un’occhiata:
`bash`
npx skills add addyosmani/agent-skills --list
3️⃣ Collegare l’agente AI
#### 3.1 Claude (esempio)
`bash`
claude --plugin-dir ./agent-skills
I comandi slash sono ora disponibili. Per evitare conflitti usa il namespace:
``
/agent-skills:review
#### 3.2 Cursor
`bash`
cp -R ./skills/.cursor/skills/ ./my-project/.cursor/skills/
cp -R ./skills/.cursor/rules/ ./my-project/.cursor/rules/
Apri il progetto in Cursor; i comandi verranno riconosciuti automaticamente.
#### 3.3 Gemini CLI
`bash`
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
Esempio di esecuzione:
``
/gemini:build
) non porta le checklist contenute in references/. Per avere la copertura completa, usa l’intero repository o copia manualmente la cartella references/.4️⃣ Usare i comandi slash
| Comando | Cosa fa | Quando |
|---|---|---|
/plan |
Genera un piano di sviluppo da una specifica | Dopo l’idea |
/build |
Crea e implementa il piano in un unico step | Quando vuoi ridurre i passaggi manuali |
/code |
Avvia la scrittura del codice secondo le linee guida TDD | Durante l’implementazione |
/test |
Esegue unit, integrazione e coverage | Dopo ogni commit |
/review |
Lancia revisione di qualità, sicurezza, performance | Prima del merge |
/ship |
Aggiorna changelog, avvia CI/CD | Quando il codice è pronto per la produzione |
Flusso tipico:
``
/plan → /code → /test → /review → /ship
Se l’agente ha già un comando con lo stesso nome, anteponi il namespace (/agent-skills:).
📌 Sintesi Operativa & Risorse
- Usa /build
per generare e implementare l’intero piano; il sistema si ferma su errori, così mantieni il controllo. - Versiona le skill come submodule Git (git submodule add https://github.com/addyosmani/agent-skills.git .agent-skills
) e tieni aggiornate le checklist inreferences/.
Risorse
- Repository GitHub:
- Documentazione: docs/README.md
,docs/cursor-setup.md,docs/gemini-cli-setup.md`
Buon coding.