Cos'è una skill per agenti (SKILL.md) e come esaminarne una

Una skill è una cartella con un file SKILL.md che si trova dove il tuo agente di coding lo cerca. L'agente legge il file solo quando la tua richiesta corrisponde. Fino ad allora la skill costa circa un centinaio di token, mentre un prompt viaggia con ogni messaggio in cui lo incolli.

Probabilmente hai già incontrato la parola in un README: "installa la skill, poi chiedi all'agente di...". Non c'è nulla di misterioso. Qui sotto: cosa c'è dentro, quando entra nella context window e come esaminarne una prima di lasciarla entrare sulla tua macchina.

Cos'è una skill e in cosa differisce da un prompt#

La documentazione di Anthropic sulle Agent Skills (verificata il 30 ottobre 2026) descrive una skill come una risorsa riutilizzabile basata sul filesystem: una directory con un file SKILL.md, più script, template e file di riferimento opzionali. SKILL.md si apre con un piccolo header YAML (un nome e una descrizione) e prosegue con istruzioni in testo semplice.

Pensa a un nuovo collega. Un prompt sei tu che stai dietro la sua sedia e ripeti le regole ogni mattina. Una skill è un raccoglitore sullo scaffale con un'etichetta sul dorso: "Stile dei messaggi di commit. Leggilo quando qualcuno ti chiede di fare un commit." Lo prende giù solo quando serve.

Due campi dell'header sono obbligatori, e il formato ha delle regole. Nel formato Skills di Claude il name è lungo al massimo 64 caratteri: lettere minuscole, cifre e trattini, e non può contenere le parole "anthropic" o "claude". Il description non può essere vuoto, è limitato a 1.024 caratteri e deve dire sia cosa fa la skill sia quando usarla.

Come una skill entra nella context window#

La documentazione la chiama divulgazione progressiva: l'agente legge una skill in tre fasi, e ogni fase si paga solo se viene raggiunta.

• Livello 1, sempre caricato. Il nome e la descrizione di ogni skill installata, circa 100 token per skill.
• Livello 2, quando attivato. Il corpo di SKILL.md, sotto i 5.000 token.
• Livello 3, solo quando serve. File inclusi e script. Quando l'agente esegue uno script, il codice dello script non entra nel contesto, solo il suo output.

Le cifre sui token sono le approssimazioni della documentazione, non conteggi esatti.

Ecco perché questo conta per la tua bolletta. Supponi di aver installato 20 skill. 20 × 100 = 2.000 token viaggiano insieme dal primo messaggio. Un agente reinvia il suo contesto a ogni passo (l'esempio a 20 passi spiega perché), quindi una sessione di 50 passi trasporta 50 × 2.000 = 100.000 token di input di etichette delle skill. Su DeepSeek-V4-Flash sono $0.0015 ai prezzi attuali.

Ora al contrario. Se quelle venti skill fossero incollate come un unico grande prompt, ogni corpo starebbe in ogni richiesta: fino a 20 × 5.000 = 100.000 token per richiesta, non per sessione. Quel divario è tutto il senso del caricamento su richiesta. Se il termine "context window" è ancora vago, questa spiegazione copre cosa la riempie.

Le skill vivono nel contesto, quindi il modello dietro l'agente ha bisogno di spazio per loro. DeepSeek-V4-Flash su CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) ha una context window di 380K e fino a 32.768 token di output per risposta, un unico prezzo a qualsiasi ora del giorno, e un'API compatibile con OpenAI e Anthropic. Per l'agente da terminale, segui come collegare Claude Code a CheapTokens; per qualsiasi altro strumento, parti da la documentazione. La pagina del modello è qui.

Scrivi una skill minimale in due minuti#

Leggere è più facile dopo averne scritta una. Questa skill fa scrivere all'agente i messaggi di commit in un formato fisso. In Claude Code, le skill personali vivono in ~/.claude/skills/ e le skill di progetto in .claude/skills/, così una skill di progetto può viaggiare con il repository.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

Incolla questo nel file:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Ora apri l'agente in un repository con modifiche in staging e chiedi: "scrivi un messaggio di commit per quello che ho messo in staging". L'agente vede la descrizione, decide che corrisponde, legge le quattro regole e le segue. Se ignora la skill, guarda prima description: deve nominare la situazione, qui "commit", con le parole che useresti davvero.

Un avvertimento: le skill non si sincronizzano tra claude.ai, l'API e Claude Code. Una skill creata in un posto va aggiunta separatamente agli altri.

Skill, AGENTS.md, MCP: chi è chi#

Questi tre vengono confusi continuamente. Un file di regole come AGENTS.md o CLAUDE.md viene letto all'inizio di una sessione e contiene fatti sul progetto (come quel file può andare storto in una cartella Downloads). Un server MCP dà all'agente nuovi strumenti e dati da raggiungere (MCP in parole semplici). Una skill è una procedura: come fare un certo tipo di lavoro, caricata quando quel lavoro si presenta.

Esamina una skill di terze parti prima di installarla#

Una skill è testo che l'agente segue, e a volte codice che l'agente esegue. La documentazione dice di usare le skill solo da fonti affidabili, di controllare ogni file incluso (SKILL.md, script, risorse) e di cercare chiamate di rete o accessi ai file inattesi. Le skill che scaricano URL esterni sono più rischiose. In Claude Code una skill ha lo stesso accesso alla rete di qualsiasi programma sul tuo computer, quindi tratta l'installazione come l'installazione di un software.

Un buon esemplare è universal-modder, un toolkit per il modding di giochi. Il suo README (verificato il 30 ottobre 2026) descrive un insieme di skill con licenza MIT nel formato Agent Skills, una CLI Python chiamata um, un server MCP per la generazione di asset tramite fal, e una knowledge base condivisa di note sul campo. La skill principale, mod-any-game, copre ricognizione, reverse engineering, generazione di asset, test in-game e packaging. Il README elenca Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot e OpenCode come strumenti supportati, e dice che il toolkit rifiuta di aggirare anti-cheat o DRM. In Claude Code si installa con /plugin marketplace add rehan-remade/universal-modder, e la generazione di asset richiede una chiave API fal separata.

Nota cosa contiene quella lista: skill, un programma da riga di comando e un server. Leggere un solo SKILL.md coprirebbe solo una fetta di ciò che stai installando. Quindi esamina i pezzi:

La regola chiave è in come conservare una chiave API in modo sicuro. La pagina del repository non mostra la data dell'ultimo commit, quindi controlla quanto di recente è stato aggiornato il progetto prima di affidarti a esso.