CalosPit - Ingegneria Informatica & Software
Blog 📅 20 Novembre 2026 · 👤 Admin

Agent‑Skills di addyosmani : installazione e uso operativo per AI coding agents

Agent‑Skills di addyosmani: installazione e utilizzo operativo per AI coding agents

📸 Panoramica pratica ed elementi dimostrativi del processo

📌 In Sintesi

  • 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"
`

💡 Consiglio: > Su Windows/macOS, se compaiono errori SSH, reindirizza le URL git con:

<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
`

⚠️ Attenzione: > Installare singole skill (es. –skill code-review-and-quality) 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 in references/.

Risorse

  • Repository GitHub:
  • Documentazione: docs/README.md, docs/cursor-setup.md, docs/gemini-cli-setup.md`
💡 Consiglio: > Salva questa guida in Markdown o PDF; i comandi funzionano offline, senza dipendere dal browser.

Buon coding.

📌 Fonte del contenuto: github.com