Claude Code Skills

Claude Code Skills

Claude Code Skills

Se usi già Claude Code per scrivere codice, fare debug o gestire il tuo repository, probabilmente hai sentito parlare delle Skills, ma non le hai ancora provate a fondo. In questo articolo vediamo cosa sono, come funziona il file SKILL.md, come si inseriscono nel workflow di sviluppo e come costruirne una da zero per automatizzare un compito reale: la generazione di test automatici.

Indice dei contenuti

  1. Cosa sono le Claude Code Skills
  2. Il file SKILL.md: struttura e sintassi
  3. Claude Code Workflow: come si attivano le skills
  4. Claude Code Automazione: esempi pratici
  5. Claude Code Test Automatici: generare test con una skill
  6. Mini guida: creare una skill da zero per un progetto reale
  7. Best practice: pro e contro delle Claude Code Skills
  8. Conclusioni

1. Cosa sono le Claude Code Skills

Le Skills sono cartelle contenenti un file SKILL.md e, opzionalmente, script e documenti di supporto. Ogni skill descrive a Claude Code una procedura ripetibile: come fare il deploy, come scrivere un commit message secondo le convenzioni del team, come generare test unitari o come applicare le linee guida di code review dell’azienda.

Il meccanismo alla base è la “progressive disclosure”: all’avvio Claude Code legge solo nome e descrizione di ogni skill installata, un costo di circa 100 token a skill. Quando l’attività richiesta corrisponde a una skill, Claude carica il contenuto completo delle istruzioni, e solo in quel momento. Questo significa che puoi installare decine di skill senza appesantire il contesto della conversazione.

Le skill possono vivere in tre posizioni: nella cartella personale ~/.claude/skills/, nella cartella di progetto .claude/skills/, oppure essere distribuite come plugin condivisi con il team.

2. Il file SKILL.md: struttura e sintassi

Ogni skill richiede un file SKILL.md con due parti: un frontmatter YAML (nome e descrizione) e il corpo in Markdown con le istruzioni vere e proprie. La descrizione è fondamentale: è il testo che Claude confronta con la richiesta dell’utente per decidere se attivare la skill, quindi va scritta in modo specifico, quasi “invadente”, elencando i casi d’uso concreti.

Esempio minimo di SKILL.md:

---
name: commit-helper
description: Aiuta a scrivere commit message secondo Conventional
  Commits. Usa questa skill quando l'utente fa il commit, scrive
  un messaggio di commit o chiede di seguire le convenzioni.
---

# Commit Message Helper

Quando scrivi un commit message segui il formato:

<tipo>(<scope>): <soggetto>

Tipi ammessi: feat, fix, docs, style, refactor, test, chore.
Il soggetto non supera i 50 caratteri e usa l'imperativo.

Per skill più complesse, il corpo di SKILL.md dovrebbe restare snello (idealmente 1.500-2.000 parole) e rimandare a file di riferimento nella cartella references/, mentre la cartella scripts/ ospita codice eseguibile per le operazioni deterministiche, quelle che non conviene far “reinventare” al modello ogni volta.

3. Claude Code Workflow: come si attivano le skills

Una skill può essere invocata in due modi: automaticamente, quando Claude riconosce che la richiesta corrisponde alla descrizione, oppure esplicitamente con lo slash command /nome-skill, utile per azioni che vuoi controllare tu, come un deploy in produzione.

---
name: deploy
description: Esegue il deploy dell'applicazione in produzione
context: fork
disable-model-invocation: true
---

Esegui il deploy:
1. Lancia la suite di test
2. Compila l'applicazione
3. Pubblica sull'ambiente di destinazione

Il campo disable-model-invocation: true impedisce a Claude di eseguire la skill di propria iniziativa: verrà lanciata solo digitando /deploy. Questo è utile nel workflow quotidiano di un team, dove alcune azioni (deploy, merge, rilascio di una versione) devono restare sotto controllo umano diretto, mentre altre (revisione del diff, suggerimenti sui test) possono essere automatizzate.

4. Claude Code Automazione: esempi pratici

Un caso d’uso comune è l’automazione della revisione del codice modificato. Ecco una skill che riassume le modifiche non ancora committate, pensata per un progetto Node.js:

---
name: review-diff
description: Riassume le modifiche non committate e segnala rischi.
  Usa quando l'utente chiede cosa è cambiato o vuole rivedere il diff.
---

## Modifiche correnti
!`git diff HEAD`

## Istruzioni
Riassumi le modifiche in 2-3 punti, poi elenca eventuali rischi
come gestione errori mancante, valori hardcoded o test da aggiornare.

La riga con ! esegue il comando ed inserisce l’output direttamente nel prompt, prima che Claude legga la skill: un esempio di “dynamic context injection”.

Sul versante .NET, una skill di automazione tipica può standardizzare la generazione dei modelli DTO da un file di configurazione, oppure applicare in automatico le regole di naming del team ogni volta che si crea una nuova classe in C#, senza dover ripetere il contesto ad ogni sessione.

5. Claude Code Test Automatici: generare test con una skill

Una skill dedicata ai test automatici può indicare a Claude il framework da usare, la struttura delle cartelle e le convenzioni di naming, così ogni test generato è coerente con il resto del progetto.

Esempio per un progetto JavaScript con Jest:

// somma.js
function somma(a, b) {
  return a + b;
}
module.exports = { somma };

// somma.test.js generato dalla skill "unit-test-generator"
const { somma } = require('./somma');

describe('somma', () => {
  test('somma due numeri positivi', () => {
    expect(somma(2, 3)).toBe(5);
  });

  test('gestisce numeri negativi', () => {
    expect(somma(-2, -3)).toBe(-5);
  });
});

Equivalente in .NET con xUnit:

// Calcolatrice.cs
public class Calcolatrice
{
    public int Somma(int a, int b) => a + b;
}

// CalcolatriceTests.cs generato dalla skill "unit-test-generator"
using Xunit;

public class CalcolatriceTests
{
    [Fact]
    public void Somma_DueNumeriPositivi_RestituisceSommaCorretta()
    {
        var calcolatrice = new Calcolatrice();
        Assert.Equal(5, calcolatrice.Somma(2, 3));
    }

    [Fact]
    public void Somma_NumeriNegativi_RestituisceSommaCorretta()
    {
        var calcolatrice = new Calcolatrice();
        Assert.Equal(-5, calcolatrice.Somma(-2, -3));
    }
}

6. Mini guida: creare una skill da zero per un progetto reale

Vediamo ora come costruire, passo dopo passo, una skill “unit-test-generator” da usare in un progetto reale che genera test automatici sia per il backend Node.js sia per i servizi .NET.

Passo 1 – Crea la cartella della skill nel progetto, così viene condivisa con tutto il team tramite il repository Git:

mkdir -p .claude/skills/unit-test-generator

Passo 2 – Scrivi il file SKILL.md con una descrizione chiara e “pushy”, che elenchi i casi in cui deve attivarsi:

---
name: unit-test-generator
description: Genera test unitari per funzioni e classi nuove o
  modificate. Usa questa skill quando l'utente aggiunge una
  funzione, chiede di scrivere test, o modifica una classe
  senza test associati.
---

# Unit Test Generator

Quando viene creata o modificata una funzione o una classe:
1. Identifica il framework di test del progetto (Jest per
  JavaScript, xUnit per .NET)
2. Genera almeno due casi: uno con input validi e uno con un
  caso limite
3. Segui la convenzione di naming del progetto per i file di test
4. Non modificare il codice di produzione, solo i file di test

Passo 3 – Se il progetto ha convenzioni particolari (mock, fixture condivise, naming), spostale in un file di riferimento invece di appesantire SKILL.md:

mkdir -p .claude/skills/unit-test-generator/references
echo "Usa sempre AAA pattern: Arrange, Act, Assert" > \
  .claude/skills/unit-test-generator/references/convenzioni.md

Passo 4 – Testa la skill su un caso reale: crea una nuova funzione e chiedi a Claude Code di aggiungere i test, verificando che la skill si attivi da sola grazie alla descrizione.

Passo 5 – Versiona la cartella .claude/skills/ nel repository: da quel momento la skill è disponibile per tutto il team che lavora sul progetto, senza bisogno di configurazioni individuali.

7. Best practice: pro e contro delle Claude Code Skills

Alcune regole pratiche prima di introdurre le skill in un team:

  • Una skill, un compito solo: skill che provano a fare troppe cose attivano al momento sbagliato e confondono il routing.
  • Scrivi descrizioni specifiche: una descrizione vaga produce un’attivazione vaga, o nessuna attivazione.
  • Lascia al codice il lavoro deterministico: script nella cartella scripts/ per compiti ripetitivi, corpo di SKILL.md per le decisioni.

Vantaggi principali:

  • Riduce il tempo speso a ripetere le stesse istruzioni ad ogni sessione di lavoro.
  • È condivisibile con il team tramite Git, garantendo standard uniformi tra sviluppatori diversi.
  • Non appesantisce il contesto: le istruzioni si caricano solo quando servono.

Limiti da considerare:

  • Richiede manutenzione: una skill scritta male o non aggiornata può generare codice non allineato al progetto.
  • La fase di attivazione dipende dalla qualità della descrizione, quindi serve un minimo di iterazione prima che funzioni in modo affidabile.
  • Non sostituisce una revisione umana: resta comunque necessario controllare l’output, soprattutto su deploy e operazioni critiche.

8. Conclusioni

Le Claude Code Skills sono uno strumento concreto per rendere ripetibili i workflow di sviluppo, dalla generazione di test automatici alla revisione del codice, fino al deploy controllato. Ma, come ogni strumento basato su intelligenza artificiale, il valore reale si vede solo se il team sa usarlo con criterio: capire quando una skill va scritta, come strutturarla e come mantenerla nel tempo.

Il mercato del software è in continua evoluzione, e gli strumenti di AI generativa applicati allo sviluppo cambiano al ritmo di poche settimane. L’unico modo per mantenere il team IT davvero competitivo è investire nella formazione continua degli sviluppatori, non in un corso isolato ma in un percorso che accompagni l’adozione reale di questi strumenti nei progetti aziendali.

Per questo motivo consigliamo alle aziende il nostro corso Claude Code per sviluppatori, pensato per portare i team tecnici da un uso base a un uso realmente produttivo di Claude Code, skill comprese.

Le aziende possono inoltre accedere a Fondimpresa per finanziare la formazione dei propri dipendenti, azzerando o riducendo sensibilmente i costi del percorso formativo.

Contatti

Per informazioni e un preventivo personalizzato, contattaci:

Email: info@innovaformazione.net   |   Tel: 347 1012275 – Dario Carrassi

Per altri articoli tecnici e di settore consigliamo di navigare sul nostro blog QUI.

(fonte) (fonte) (fonte)

Ti potrebbe interessare

Articoli correlati