Che cos'è una "skill" nel contesto dell'IA e come se ne costruisce una per il tuo flusso di lavoro?

Question

Accepted Answer

Una **skill** racchiude un flusso di lavoro riutilizzabile e su richiesta per un agente IA: **istruzioni** per un'attività ricorrente (quando farla e come), più **script o risorse facoltativi** che l'agente carica solo quando l'attività è pertinente. È la differenza tra rispiegare una procedura ogni volta e insegnarla una sola volta.

## Che cosa è una skill

```text
SKILL = a self-contained folder the agent can pull in on demand:
  SKILL.md   → metadata + instructions (the TRIGGER + the STEPS)
  scripts/   → optional helper scripts the agent runs (e.g. a linter, a generator)
  resources/ → optional templates, examples, reference files
→ loaded ONLY when relevant → keeps the base context small, the workflow repeatable
```

Il vantaggio è la **divulgazione progressiva**: l'agente conosce l'esistenza della skill da una breve descrizione e carica le istruzioni e gli script completi solo quando compare un'attività corrispondente — quindi dozzine di skill non appesantiscono ogni conversazione.

## Costruirne una

Una skill ha tre parti: il **trigger** (quando), i **passaggi** (come) e tutti gli **script di supporto** (strumenti). Mantienila focalizzata e componibile — un lavoro fatto bene, non un miscuglio di tutto.

```markdown
---
name: changelog-entry
description: Add a CHANGELOG entry. Use when finishing a user-facing change.
---
# Add a changelog entry

## Steps
1. Read the latest commits since the last release tag.
2. Categorize each as Added / Changed / Fixed.
3. Prepend a dated section to CHANGELOG.md under [Unreleased].
4. Run `scripts/validate.sh` to check the format.
```

La `description` è il **trigger** — dice all'agente quando ricorrere a questa skill. L'elenco numerato è costituito dai **passaggi**, e `validate.sh` è uno **script di supporto** che applica la correttezza in modo che l'agente non debba ragionare sul formato da zero. Poiché la skill è piccola e a scopo unico, si compone bene con altre (ad es. una skill "release" separata può chiamarla).

## Perché è importante

Le skill trasformano un agente da un assistente generico che devi riaggiornare costantemente in uno che conosce *le tue* procedure ricorrenti. Incapsulando il trigger, i passaggi e gli script in un'unità focalizzata e componibile che si carica solo su richiesta, codifichi una volta la conoscenza istituzionale e la riutilizzi in modo affidabile — ottenendo risultati coerenti su attività ripetitive senza rispiegare, e senza pagare il costo del contesto di ogni flusso di lavoro su ogni richiesta.