---
title: "Claude Skills spiegate: come funzionano davvero le Agent Skills"
description: "Le Claude Skills sono cartelle con un file SKILL.md che Claude carica solo quando serve. Cosa sono, dove funzionano e quali vale la pena installare."
type: "guide"
locale: "it"
category: "Claude Code"
canonical: "https://agenticschool.dev/it/guide/claude-skills-explained"
datePublished: "2026-08-28"
dateModified: "2026-08-28"
---

# Claude Skills spiegate: come funzionano davvero le Agent Skills

- Category: Claude Code
- Keywords: claude skills, claude code skills, what are claude skills, claude agent skills, claude skills marketplace, how to use claude skills, claude skills vs subagents, best claude skills, how to add skills to claude code, claude skills example, claude skills github, claude design skills
- Canonical URL: https://agenticschool.dev/it/guide/claude-skills-explained
- Locale: it

> Le Claude Skills sono cartelle con un file SKILL.md che Claude carica solo quando serve. Cosa sono, dove funzionano e quali vale la pena installare.

Le Claude Skills sono cartelle. Ognuna contiene un file SKILL.md il cui frontmatter YAML porta due campi obbligatori, name e description, seguiti da istruzioni in Markdown, e l'agente carica quel contenuto solo quando la tua richiesta corrisponde alla description. Anthropic chiama questa funzionalità Agent Skills, l'ha pubblicata come standard aperto nel dicembre 2025 e la supporta su claude.ai, in Claude Code, nel Claude Agent SDK e sulla Claude Developer Platform. Questa guida alle Claude Skills copre che cos'è una Claude skill, dove funzionano le skill, in che cosa si distinguono da slash command, subagent, MCP server e CLAUDE.md, quali vale la pena installare e come scriverne una in una decina di minuti.

## Cos'è una Claude skill, in tre livelli

Una Claude skill è una directory che contiene un file SKILL.md e, facoltativamente, script, documenti di riferimento e template accanto. Il file si apre con un frontmatter YAML e prosegue come normali istruzioni Markdown. Ciò che fa funzionare il formato non è il file, è il modello di caricamento: Anthropic documenta un processo in tre fasi chiamato progressive disclosure, in cui l'agente legge solo i metadati all'avvio, tira le istruzioni nel contesto quando la tua richiesta corrisponde, e tocca i file allegati solo se il compito ne ha davvero bisogno. È per questo che puoi installare molte skill senza pagare per quelle che non attivi mai.

- Livello 1, metadati: i campi name e description, caricati nel system prompt all'avvio, circa 100 token per skill.
- Livello 2, istruzioni: il corpo dello SKILL.md, caricato solo quando la skill viene attivata, consigliato sotto i 5.000 token.
- Livello 3, risorse: file di riferimento e script allegati, che non costano nulla finché non vengono letti. Uno script che viene eseguito contribuisce solo con il suo output, mai con il suo sorgente.

La description non è documentazione, è la superficie di corrispondenza. È l'unico testo sulla tua skill che sta nel system prompt prima che qualcosa si attivi, quindi è l'unica cosa che separa la tua da tutte le altre skill che Claude può vedere. Anthropic richiede che dica sia che cosa fa la skill sia quando usarla, e una description vaga produce una skill che non si attiva mai.

Tutto quello che c'è in questa pagina è stato letto da fonti primarie il 28 agosto 2026: la Agent Skills overview sulla Claude developer platform, il riferimento sulle skill di Claude Code, la specifica Agent Skills pubblicata e il repository anthropics/skills su GitHub. Le skill sono arrivate nell'ottobre 2025 e la superficie si muove ancora in fretta, quindi controlla le stesse fonti prima di costruire qualcosa di costoso su un singolo dettaglio riportato qui.

## Dove funzionano le Claude Skills, superficie per superficie

Le skill funzionano in Claude Code, su claude.ai e tramite la Claude API, e Anthropic dichiara che anche il Claude Agent SDK e la Claude Developer Platform le supportano. Ciò che cambia da una superficie all'altra è dove vive il file, chi altro può vederlo e quali campi del frontmatter sono ammessi. L'avvertenza che frega tutti è che le skill personalizzate non si sincronizzano tra le superfici: una skill caricata su claude.ai non è disponibile tramite l'API, e le skill di Claude Code stanno nel filesystem e sono separate da entrambe. Installi la stessa cartella una volta per ogni superficie su cui la vuoi.

- Claude Code, dove vive: ~/.claude/skills/name/SKILL.md per le skill personali, .claude/skills/name/SKILL.md per un progetto, oppure una cartella skills dentro un plugin.
- Claude Code, chi può usarla: tu, chiunque cloni il repo, o chiunque abbia il plugin abilitato. Il nome della directory diventa la slash command.
- Claude Code, frontmatter ammesso: tutti i campi, incluse le estensioni proprie di Claude Code come disable-model-invocation, allowed-tools, model, effort e paths.
- Claude Code, attenzione a: le skill hanno lo stesso accesso di rete di qualsiasi altro programma sul tuo computer, quindi una skill non fidata è software non fidato.

- claude.ai, dove vive: caricata come file zip tramite Settings e poi Features.
- claude.ai, chi può usarla: solo tu. Anthropic dichiara che lì le skill personalizzate sono individuali per ogni utente e non possono essere gestite centralmente dagli admin. Piani Pro, Max, Team ed Enterprise, con code execution attivo.
- claude.ai, frontmatter ammesso: soltanto i sei campi della specifica, cioè name, description, license, compatibility, metadata e allowed-tools.
- claude.ai, attenzione a: l'accesso di rete varia in base alle tue impostazioni utente e admin, quindi una skill che recupera dati può comportarsi diversamente da come fa sulla tua macchina.

- Claude API, dove vive: creata tramite gli endpoint /v1/skills e referenziata con skill_id nel parametro container di una richiesta.
- Claude API, chi può usarla: tutto il workspace. Anthropic dichiara che le skill personalizzate caricate sono condivise a livello di workspace.
- Claude API, frontmatter ammesso: gli stessi sei campi della specifica di claude.ai. Una chiave inattesa fa fallire il caricamento con un errore duro, invece di essere ignorata.
- Claude API, attenzione a: le skill richiedono il tool code execution e girano in un container in sandbox senza accesso di rete e senza installazione di pacchetti a runtime, quindi sono disponibili solo i pacchetti preinstallati.

Anthropic distribuisce inoltre quattro Agent Skills predefinite per i documenti: PowerPoint, Excel, Word e PDF, referenziate dagli skill id pptx, xlsx, docx e pdf. Sono attive su claude.ai e disponibili tramite l'API, e Anthropic dichiara che non sono disponibili in Claude Code, dove invece arriva già inclusa la skill open source per la Claude API.

## Claude Skills contro agent, subagent, comandi e MCP

Non sono opzioni in concorrenza, risolvono problemi diversi, e confonderle è l'errore più comune di tutta questa area. Claude Skills contro agent è già l'inquadramento sbagliato: un agent è l'intero sistema che fa il lavoro, e una skill è una delle cose che gli passi, non una sua versione ridotta. Una skill è una procedura caricata su richiesta. Una slash command ora è la stessa cosa in un singolo file, perché Anthropic ha unito i custom command nelle skill: un file in .claude/commands/deploy.md e una skill in .claude/skills/deploy/SKILL.md creano entrambi /deploy e si comportano in modo identico, e se esistono tutti e due vince la skill. Un subagent è un contesto separato che svolge il lavoro e riporta indietro una conclusione. Un MCP server è una connessione viva verso un sistema esterno. CLAUDE.md è un insieme di fatti caricato a ogni singolo turno.

- Skill: usala quando continui a incollare la stessa procedura in più passi e la vuoi disponibile senza che venga caricata a ogni turno.
- Slash command: usala quando basta un file Markdown e non c'è nulla da allegare. Crea lo stesso comando di una skill, quindi non c'è motivo di migrarne una che funziona.
- Subagent: usalo quando il lavoro allagherebbe il tuo contesto principale e ti serve solo la conclusione.
- MCP server: usalo quando l'agente ha bisogno di dati in tempo reale o di una API esterna a runtime. Le istruzioni non possono recuperare nulla.
- CLAUDE.md: usalo per i fatti che valgono a ogni turno. Anthropic consiglia di spostare una sezione di CLAUDE.md dentro una skill quando è diventata una procedura invece che un fatto.

Azzeccare questa divisione è gran parte di ciò che separa un setup di agent che sembra veloce da uno che sembra gonfio, ed è la spina dorsale del corso su Claude Code che insegniamo ad Agentic School.

## L'anatomia di un file SKILL.md minimo

Una skill funzionante ha bisogno di esattamente due campi nel frontmatter. La specifica Agent Skills richiede name, al massimo 64 caratteri tra lettere minuscole, numeri e trattini, senza trattini iniziali, finali o consecutivi, e uguale al nome della directory che la contiene. Richiede description, al massimo 1.024 caratteri, che copra sia che cosa fa la skill sia quando usarla. Tutto il resto è opzionale. L'esempio qui sotto è la risposta onesta più breve alla domanda di come creare Claude Skills che girino ovunque: usa solo campi della specifica, quindi la stessa cartella si carica in Claude Code, si carica su claude.ai e si impacchetta per la Skills API senza una sola modifica.

```markdown
---
name: pr-description
description: Writes a pull request description from the current branch diff. Use when the user asks for a PR description, a pull request summary, or release notes for a branch.
---

# PR description

## Steps

1. Read the diff between the current branch and the default branch.
2. Group the changes by area: features, fixes, refactors, tests.
3. Write a title under 70 characters, then a body with a Summary section and a Testing section.
4. List any migration or config change a reviewer has to apply by hand.

## Rules

- Describe behavior a reviewer can check, not the files you touched.
- Never claim a test passed unless you ran it.
- If the diff is empty, say so and stop.
```
Uno SKILL.md completo salvato in .claude/skills/pr-description/SKILL.md. Il nome della directory diventa /pr-description, e la description è ciò con cui il modello confronta la tua richiesta.

- license: la licenza che copre la skill, o un nome di licenza o il nome di un file di licenza allegato.
- compatibility: fino a 500 caratteri che descrivono i requisiti di ambiente, come pacchetti di sistema necessari o accesso di rete.
- metadata: una mappa libera da chiavi stringa a valori stringa, da leggere con il tuo tooling.
- allowed-tools: i tool preapprovati che la skill può usare, marcati come sperimentali nella specifica perché il supporto varia tra gli agent.

Claude Code accetta molti più campi di quei sei, tra cui argument-hint, arguments, disable-model-invocation, user-invocable, model, effort, context, hooks e paths. Sono estensioni di Claude Code, non fanno parte dello standard. Includine uno in una skill che impacchetti per claude.ai o per la Skills API e il caricamento fallisce con un errore di chiave inattesa che nomina il campo colpevole, invece di ignorarlo in silenzio. Scrivi i sei campi portabili se la skill deve viaggiare, e ricorri alle estensioni solo per le skill che resteranno sulla tua macchina.

## Marketplace, library e liste awesome delle Claude Skills

Non esiste un marketplace dedicato alle Claude Skills né una library ufficiale delle Claude Skills come prodotto Anthropic a sé stante. Chi ne cerca uno finisce invece sul sistema di plugin di Claude Code, che è il vero meccanismo di distribuzione. Anthropic pubblica il proprio repository di Claude Skills su GitHub come anthropics/skills, che registri dentro Claude Code come plugin marketplace e poi installi come uno dei suoi due plugin. Anthropic gestisce anche un plugin marketplace ufficiale, e la sua documentazione dichiara che è l'unico marketplace che Claude Code registra da solo. Tutto il resto, comprese le liste awesome di Claude Skills che la gente condivide, è curato dalla community e non verificato.

- Repository di skill di Anthropic: aggiungi anthropics/skills come plugin marketplace in Claude Code, poi installa il suo plugin document-skills o example-skills. Limite: Anthropic lo etichetta come materiale dimostrativo, non codice di produzione.
- Plugin marketplace ufficiale di Anthropic: anthropics/claude-plugins-official, l'unico marketplace che Claude Code registra da sé. Limite: nomi come agent-skills sono riservati proprio perché qui il rischio di impersonificazione è reale.
- Impostazioni di claude.ai: carica una cartella di skill come zip tramite Settings e poi Features. Limite: la skill resta privata sul tuo account e gli admin non possono gestirla centralmente.
- Skills API: crea e carica tramite gli endpoint /v1/skills per un accesso a livello di workspace. Limite: richiede il tool code execution, e il container non ha accesso di rete.
- Liste della community: ComposioHQ mantiene awesome-claude-skills su GitHub, una lista curata di skill e tool della community. Limite: una lista awesome è un indice, non una revisione. Niente di ciò che contiene è stato verificato per te.

Anthropic pubblica inoltre sul suo sito di risorse un lungo PDF intitolato The Complete Guide to Building Skills for Claude, che è la cosa più vicina a un manuale ufficiale di scrittura per questo formato.

Anthropic è netta sul rischio: usa solo skill che hai creato tu stesso o che hai ottenuto da Anthropic, perché una skill può indurre Claude a eseguire codice e a chiamare tool in modi che non corrispondono allo scopo dichiarato. Leggi ogni file di una skill prima di installarla, non solo lo SKILL.md, e tratta una skill che recupera dati da un indirizzo esterno come la categoria a rischio più alto, dato che il contenuto recuperato può portare istruzioni proprie. Installare una skill da un repository GitHub significa installare software di uno sconosciuto.

## Le Claude Skills da installare per prime

Ogni skill nominata qui sotto è stata verificata il 28 agosto 2026 leggendo il suo SKILL.md nel repository anthropics/skills, non copiando il riassunto di qualcun altro. Abbiamo scelto per ampiezza invece che per classifica: due che ti rendono più bravo a costruire tooling per agent, due che alzano la qualità di ciò che consegni, e tre skill di design, la categoria più cercata dopo il termine generico. La maggior parte di quel repository è sotto Apache 2.0; le skill per i documenti Word, Excel, PowerPoint e PDF sono source-available e non open source.

- skill-creator: crea e modifica skill, ed esegue eval che misurano quanto affidabilmente una description si attiva. Ideale per chi scrive più di due skill. Limite: sistema struttura e attivazione, non la tua conoscenza del dominio.
- mcp-builder: costruisce MCP server in Python con FastMCP oppure in Node e TypeScript con l'MCP SDK. Ideale quando una skill è lo strumento sbagliato e ti serve una connessione viva. Limite: solo progettazione del server, non hosting né auth.
- webapp-testing: guida una web app locale con Playwright per verificare il comportamento del frontend, catturare screenshot e leggere i log del browser. Ideale per controllare una modifica nell'app in esecuzione, non solo nei test. Limite: solo app locali.
- frontend-design: direzione estetica per una UI nuova o rifatta, con l'obiettivo di un risultato che non sembri un template di default. Ideale per chi costruisce da solo senza designer. Limite: dà forma alla tipografia, non conosce il tuo brand.
- canvas-design: trasforma una filosofia di design scritta in poster e altri pezzi statici in PNG e PDF. Ideale per asset visivi una tantum. Limite: output statico, e ha istruzione di creare lavoro originale invece di copiare un artista.
- theme-factory: applica uno dei dieci temi di colori e font preimpostati a una presentazione, a un documento o a una pagina HTML, oppure ne genera uno nuovo. Ideale per far sembrare un unico sistema output sparsi. Limite: dà lo stile, non fa il layout.
- claude-api: un riferimento aggiornato sulla Claude API e sugli SDK che copre model id, prezzi, streaming, tool use e caching in otto linguaggi. Ideale per scrivere codice contro Claude. Limite: arriva già insieme a Claude Code.

Due riserve oneste sull'intero insieme. Primo, Anthropic allega a quel repository un disclaimer esplicito: le skill sono fornite a scopo dimostrativo ed educativo, e ciò che Claude fa davvero può differire da ciò che la skill descrive. Secondo, le migliori skill di Claude Code per te non sono quasi mai quelle famose. Una skill di tre righe che codifica come il tuo team scrive i messaggi di commit si attiva dieci volte al giorno; una skill di design costruita magnificamente che hai installato perché sembrava impressionante resta lì a costarti 100 token a sessione per sempre.

## Quanto ti costa davvero una skill in contesto

Una skill che non attivi mai costa circa 100 token, secondo la tabella sulla progressive disclosure di Anthropic stessa: il name e la description di ogni skill installata stanno nel system prompt fin dall'avvio, e nient'altro. Il costo che morde arriva dopo l'attivazione, perché in Claude Code il contenuto renderizzato di una skill invocata entra nella conversazione come un singolo messaggio e resta lì per il resto della sessione. Claude Code non rilegge il file nei turni successivi, quindi una skill lunga è una tassa di lunga durata.

- 30 skill installate a circa 100 token di metadati ciascuna: circa 3.000 token spesi all'avvio, che tu ne usi una o nessuna.
- Un corpo di skill al tetto consigliato di 5.000 token, invocato una volta: 5.000 token che restano nella conversazione per il resto della sessione.
- Cinque skill di questo tipo invocate in una sola sessione: circa 25.000 token, che è esattamente il budget combinato che Claude Code riaggancia dopo la compattazione automatica.
- Dopo la compattazione Claude Code tiene solo i primi 5.000 token di ogni skill riagganciata e riempie quel budget di 25.000 token partendo dall'ultima invocata a ritroso, quindi le skill invocate presto possono sparire del tutto.
- Claude Code limita per impostazione predefinita l'elenco delle skill all'1 per cento della context window del modello, e limita ogni voce a 1.536 caratteri di testo della description, scartando per prime le descrizioni delle skill che usi di meno quando va in overflow.

La regola che esce da questi conti: tieni la description affilata e il corpo corto, e spingi tutto ciò che è lungo in file di riferimento che si caricano solo quando il compito li va a prendere. La specifica di Anthropic consiglia di tenere lo SKILL.md sotto le 500 righe esattamente per questo motivo. È la stessa disciplina di budget del contesto che il nostro materiale su Claude Code applica al resto di una sessione di agent, ed è il motivo per cui la lunghezza di una skill è un vincolo di progetto e non un dettaglio.

## Quando non scrivere affatto una skill

Gran parte di ciò che la gente impacchetta come skill non dovrebbe essere una skill. Un'istruzione una tantum va nel prompt che stai già scrivendo. Un fatto che vale a ogni turno va in CLAUDE.md, dove è sempre caricato. Una fonte di dati esterna in tempo reale va in un MCP server, perché le istruzioni scritte non possono recuperare nulla. Il lavoro che allagherebbe il tuo contesto principale va in un subagent. E tutto ciò che deve accadere ogni volta, senza che il modello abbia voce in capitolo, va in un hook. Una skill è la risposta giusta solo per una procedura ripetibile che vuoi disponibile ma non caricata in permanenza.

- Istruzione una tantum: mettila nel prompt. Una skill che invochi una volta ti è costata il tempo di scriverla e poi circa 100 token di metadati in ogni sessione successiva.
- Regola o fatto di progetto: mettilo in CLAUDE.md. Anthropic traccia la linea esattamente qui, notando che il corpo di una skill si carica solo quando viene usata mentre il contenuto di CLAUDE.md no.
- Dati in tempo reale o una API esterna: costruisci un MCP server. Una skill può descrivere una API, non può chiamarne una a cui l'agente non ha alcuna connessione.
- Un'indagine lunga che riempirebbe il tuo contesto: affidala a un subagent e tieni solo la conclusione.
- Una garanzia invece di un suggerimento, come bloccare un commit sbagliato: usa un hook. Una skill è un insieme di istruzioni che il modello può rifiutarsi di seguire, e Anthropic consiglia gli hook quando un comportamento va imposto in modo deterministico.

Il test più semplice è se riesci a dire ad alta voce quando la skill dovrebbe attivarsi. Se non ci riesci, non lo dirà nemmeno la sua description, e hai scritto un documento invece di una skill.

## Che cosa dovresti configurare questa settimana

Tre cose decidono ogni volta: su quale superficie lavori davvero, se la skill deve viaggiare tra superfici, e se ciò che stai impacchettando è una procedura o un fatto. Una volta sistemate quelle tre, la costruzione in sé è una cartella e un file.

- Una persona sola che consegna in Claude Code: crea ~/.claude/skills/name/SKILL.md per le due procedure che riscrivi più spesso e usa il frontmatter completo di Claude Code. Non ti serve la portabilità dei sei campi finché una skill non lascia la tua macchina.
- Un piccolo team su un repo: metti le skill in .claude/skills/ e committale, così la procedura viaggia con il codice e la prossima persona assunta la eredita. Aggiungi disable-model-invocation: true a tutto ciò che ha un effetto collaterale, come un deploy.
- Lavoro su documenti e comunicazione su claude.ai: le skill predefinite PowerPoint, Excel, Word e PDF sono già attive e non richiedono configurazione. Carica una skill personalizzata per il tuo stile di casa, e ricorda che resta privata sul tuo account.
- Costruire sulla Claude API: carica tramite gli endpoint /v1/skills per un accesso a livello di workspace, tieni il frontmatter ai sei campi della specifica, e progetta per un container senza accesso di rete e senza installazione di pacchetti.

Se fai una cosa sola: prendi la procedura che hai incollato due volte in una chat questa settimana, mettila in una cartella con uno SKILL.md, e scrivi una description che nomini le parole che diresti davvero quando la vuoi. Il corso gratuito su Claude Code di Agentic School mostra come costruirne una dall'inizio alla fine.

## Steps

### 1. Scegli la procedura che continui a ripetere

Scegli qualcosa che hai incollato in una chat più di due volte: una checklist di release, una routine di review, un formato di report. Se è un fatto invece che una procedura, il suo posto è in CLAUDE.md.

### 2. Crea la cartella della skill

Crea una directory il cui nome sia fatto di lettere minuscole, numeri e trattini, al massimo 64 caratteri, senza trattini iniziali, finali o consecutivi. In Claude Code quel nome di directory diventa la slash command che digiti.

### 3. Scrivi i due campi obbligatori del frontmatter

Crea SKILL.md dentro la cartella, aprendo con un frontmatter YAML che imposta name, uguale al nome della directory, e description, fino a 1.024 caratteri che dicano sia che cosa fa la skill sia quando usarla. La description è l'unico testo caricato all'avvio, quindi mettici dentro le parole che la attivano.

### 4. Scrivi il corpo come istruzioni, non come prosa

Sotto il frontmatter, scrivi passi numerati e regole esplicite. Tieni lo SKILL.md sotto le 500 righe, che è la raccomandazione di Anthropic, e sposta il materiale di riferimento lungo in file separati nella cartella, così si carica solo quando il compito ne ha bisogno.

### 5. Metti la cartella dove la superficie la legge

Per Claude Code usa ~/.claude/skills/name/ per una skill personale o .claude/skills/name/ dentro il repo per una di progetto. Per claude.ai comprimi la cartella in zip e caricala tramite Settings e poi Features. Per l'API creala tramite gli endpoint /v1/skills. Le skill non si sincronizzano tra queste superfici, quindi installala su ognuna dove la vuoi.

### 6. Tienila portabile se deve viaggiare

Se la stessa skill dovrà girare su più di una superficie, limita il frontmatter ai sei campi della specifica: name, description, license, compatibility, metadata e allowed-tools. Un campo esclusivo di Claude Code come argument-hint fa fallire un caricamento su claude.ai o sulla Skills API con un errore di chiave inattesa.

### 7. Verifica che sia stata caricata

In Claude Code chiedi quali skill sono disponibili e conferma che la tua sia elencata con la sua description, poi invocala direttamente con la sua slash command. Se il comando funziona ma la description manca, il YAML non è stato interpretato: esegui claude plugin validate sulla tua directory delle skill, oppure avvia con il flag di debug per vedere l'errore di parsing.

## FAQ

### Cosa sono le Claude Skills?

Le Claude Skills sono cartelle che danno a Claude una capacità specifica. Ogni cartella contiene un file SKILL.md con un frontmatter YAML che porta due campi obbligatori, name e description, seguiti da istruzioni in Markdown, più eventuali script o file di riferimento che vuoi allegare. Anthropic chiama questa funzionalità Agent Skills e l'ha pubblicata come standard aperto nel dicembre 2025. Claude carica all'avvio solo i circa 100 token di metadati e legge le istruzioni complete soltanto quando la tua richiesta corrisponde alla description.

### Come aggiungo le skill a Claude Code?

Crea una directory in ~/.claude/skills/nome-della-tua-skill/ per una skill personale, oppure .claude/skills/nome-della-tua-skill/ dentro un repository per una skill di progetto, e mettici un file SKILL.md con name e description nel frontmatter. Il nome della directory diventa la slash command. Claude Code carica le skill anche dai plugin, quindi puoi installare un insieme pubblicato aggiungendo un plugin marketplace, per esempio il repository anthropics/skills di Anthropic, e installando il suo plugin document-skills o example-skills.

### Come creo una Claude skill?

Crea una cartella, aggiungi un file SKILL.md e dagli due campi nel frontmatter. Il name deve essere al massimo di 64 caratteri tra lettere minuscole, numeri e trattini, non deve iniziare né finire con un trattino, non deve contenere trattini consecutivi e deve corrispondere al nome della cartella. La description deve essere al massimo di 1.024 caratteri e deve dichiarare sia che cosa fa la skill sia quando usarla, perché è il testo con cui il modello confronta la tua richiesta. Tutto ciò che sta sotto il frontmatter sono normali istruzioni Markdown, e Anthropic consiglia di tenere il file sotto le 500 righe.

### Qual è la differenza tra le Claude Skills e i subagent?

Claude Skills contro subagent è una differenza di natura, non di dimensione. Una skill è contenuto: istruzioni e file caricati nella conversazione in corso quando la tua richiesta corrisponde alla sua description, con un costo di circa 100 token di metadati finché non si attiva. Un subagent è un contesto separato che parte, lavora con i propri tool e restituisce solo una conclusione, ed è questo che impedisce a un'indagine lunga di riempire la tua context window principale. Usa una skill quando vuoi che l'agente segua una procedura nota. Usa un subagent quando è il lavoro stesso ad allagare il tuo contesto e ti serve solo la risposta.

### Esiste un marketplace ufficiale di Claude Skills?

Non esiste un prodotto marketplace di skill separato di Anthropic. La distribuzione passa dal sistema di plugin di Claude Code: Anthropic pubblica un plugin marketplace ufficiale su anthropics/claude-plugins-official, che la sua documentazione descrive come l'unico marketplace che Claude Code registra da solo, e le sue skill open source vivono nel repository anthropics/skills, che puoi registrare tu stesso come plugin marketplace. Su claude.ai carichi uno zip tramite Settings e poi Features, e sulla Claude API carichi tramite gli endpoint /v1/skills. Indici della community come awesome-claude-skills di ComposioHQ elencano skill di terze parti ma non ne verificano nessuna.

### Le Claude Skills funzionano fuori da Claude Code?

Sì. Anthropic dichiara che le Agent Skills sono supportate su claude.ai, in Claude Code, nel Claude Agent SDK e sulla Claude Developer Platform, e il formato è stato rilasciato come standard aperto perché altri prodotti per agent possano adottarlo. Il problema è che le skill personalizzate non si sincronizzano tra le superfici: una skill caricata su claude.ai non è disponibile tramite l'API, e le skill di Claude Code stanno nel filesystem e sono separate da entrambe. Anche il frontmatter cambia, dato che claude.ai e la Skills API accettano solo i sei campi della specifica mentre Claude Code ne accetta molti di più.

### Quali sono le migliori Claude Skills?

Per la maggior parte di chi costruisce, le migliori Claude Skills sono quelle piccole che scrivi tu, perché una skill che codifica come lavora davvero il tuo team si attiva ogni giorno mentre una famosa di solito resta inutilizzata a circa 100 token a sessione. Se vuoi un insieme di partenza dal repository di Anthropic, skill-creator ti aiuta a scrivere e valutare altre skill, mcp-builder copre la costruzione di MCP server in Python o TypeScript, webapp-testing guida un'app locale con Playwright, e frontend-design, canvas-design e theme-factory sono le skill di design. Anthropic etichetta quel repository come materiale dimostrativo ed educativo, quindi verifica qualsiasi cosa prima di installarla.