Una cronologia di commit fatta di «fix», «update», «modifiche varie» è un muro: per capire cosa è successo devi aprire ogni diff. Questa skill scrive messaggi che si leggono dalla cronologia, non dal diff.

Le dai un diff e produce un messaggio in formato Conventional Commits: tipo(ambito): descrizione all'imperativo, con il tipo scelto dal contenuto reale della modifica (se corregge un bug è fix, anche se tu hai detto «ho migliorato»), e un corpo che spiega il perché solo quando serve. Se il diff mescola cambiamenti scollegati, te lo segnala: andrebbero in commit separati.

Quando usarla

Ogni volta che scrivi un commit su un progetto vivo, dove la cronologia la leggerà qualcun altro (o tu stesso fra sei mesi).

Come installarla

Scarica il file delle istruzioni: semantic-commits.md.

• Claude Code: mettilo nella cartella delle skill del progetto (.claude/skills/), e l’assistente scriverà i commit in questo formato.
• Claude Projects o GPT personalizzati: incolla il contenuto nelle istruzioni permanenti.
• Qualsiasi assistente: incolla le istruzioni prima del diff.

Il formato di riferimento è quello dei Conventional Commits. Per vedere skill scritte da altri e imparare a comporne, il repository anthropics/skills è un buon punto di partenza.