Una skill Claude SEO è una cartella con dentro un file Markdown. Il file dice all'agente cosa fa la skill, quando usarla e come eseguire il lavoro. Claude Code, Codex e gli altri agenti che supportano questa convenzione leggono lo stesso formato: un breve blocco di metadati in cima, poi le istruzioni.
La domanda su cui ogni team inciampa dopo un paio di settimane è quali installare. Se le installi tutte ti preoccupi di riempire la finestra di contesto. Se non ne installi nessuna torni a copiare prompt da un'app di note.
Abbiamo misurato la nostra libreria per rispondere, e la risposta si divide nettamente in due. Una skill non costa quasi nulla finché resta ferma inutilizzata. Costa contesto reale quando si attiva. La mediana nella nostra libreria è 107 token di metadati in attesa e 1.851 token di istruzioni. Quei due numeri dovrebbero svolgere ruoli diversi nella tua decisione.
La misurazione
Abbiamo analizzato ogni file SKILL.md nelle due radici delle skill su una macchina e tagliato ogni file al confine del frontmatter.
Misura | Valore |
|---|---|
File di skill analizzati | 76 |
Nomi di skill distinti | 75 |
Blocco di metadati totale | 8.231 token (stimati) |
Corpo delle istruzioni totale | 222.952 token (stimati) |
Rapporto corpo/metadati | 27 a 1 |
I conteggi dei token sono stimati a quattro caratteri per token, una buona approssimazione per la scrittura tecnica in inglese ma non esatta. Trattali come valori comparativi, non letterali. La scoperta sta nel rapporto e nella distribuzione; il valore assoluto si sposterà con i tuoi file.
Perché il costo a scaffale resta piccolo
I sistemi di skill usano la divulgazione progressiva. Il blocco di metadati viene caricato perché l'agente sappia che la skill esiste e quando si applica. Il corpo viene letto solo quando la skill è invocata.
Questo disegno produce una distribuzione che vale la pena guardare.
Percentile | Costo in attesa per skill | Costo del corpo per skill |
|---|---|---|
Più piccolo | 43 token | 428 token |
Mediana | 107 token | 1.851 token |
90° percentile | 161 token | 7.125 token |
Più grande | 246 token | 21.702 token |
L'intera libreria di 76 file porta 8.231 token di metadati in attesa. È all'incirca la dimensione di un articolo lungo, ed è il prezzo perché l'agente sappia che esistono 75 skill prima di aver fatto qualsiasi cosa. Il singolo blocco di metadati più grande della libreria è di 246 token.
Il massimo è quello interessante. La skill più prolissa della libreria spende 246 token per dire all'agente quando usarla, e resta comunque abbastanza piccolo perché uno scaffale di skill non affondi una sessione. Se temi che installare cinque skill SEO tolga spazio ai tuoi dati, la misurazione dice che l'affollamento non avviene sullo scaffale.
Dove vive davvero il costo
Il corpo è dove diventa concreto, e la dispersione è ampia. 15 delle 75 skill caricano meno di 1.000 token quando si attivano. 11 caricano oltre 5.000. La più grande carica 21.702.
Per un programma SEO, è su quell'intervallo che va impostata la pianificazione, perché corrisponde a quanto lavoro fa la skill. Una skill che analizza una pagina costa poco. Una skill che esegue una scansione completa del sito, confronta con una baseline e scrive un report ha molte istruzioni perché ha molti passaggi.
Il costo di invocazione si addensa in basso e poi si allunga, con 11 skill sopra 5.000 token.
Ecco il nostro insieme di ricerca e misurazione, misurato allo stesso modo.
Skill | In attesa | All'attivazione |
|---|---|---|
tool-cluster-builder | 70 token | 428 token |
seo-tools-local | 102 token | 638 token |
geo-operator | 101 token | 665 token |
dataforseo-toolkit | 238 token | 849 token |
ahrefs-2026-content-refresh | 51 token | 958 token |
search-engine-visibility-audit | 49 token | 1.121 token |
codex-link-equity-audit | 96 token | 1.163 token |
gsc | 116 token | 1.309 token |
bing-webmaster | 135 token | 1.685 token |
seo-beginner-automation | 98 token | 1.836 token |
Tutte e dieci insieme | 1.055 token | 10.652 token |
Dieci skill SEO costano circa 1.000 token sullo scaffale e circa 10.000 token quando si attivano tutte.
Da questa tabella cadono due cose.
La colonna dell'attesa è quasi piatta. Dieci skill SEO costano 1.055 token per essere disponibili. È un errore di arrotondamento accanto a una pagina di risultati di ricerca o a un export di scansione, ed è l'argomento per installare lo scaffale che vuoi, non quello che pensi di poterti permettere.
La colonna dell'invocazione non è piatta. L'insieme va da 428 a 1.836 token, un fattore quattro. In pratica ne attivi raramente più di una o due per sessione, quindi il numero onesto per la pianificazione non è 10.652. Sono qualche migliaio di token in più rispetto ai dati che la sessione già porta.
Cosa significano i numeri quando scegli una skill
Tre regole di selezione che derivano dalla misurazione.
Giudica il corpo, non la descrizione. Il blocco di metadati è la pubblicità della skill. Una skill può avere una descrizione di 50 token e un corpo di 7.000. Leggi il file prima di installarlo, e controlla la lunghezza di tutto ciò che sta sotto il frontmatter. Se vuoi un filtro rapido, dimensione del file e numero di righe sono un proxy decente di quanto la skill tirerà dentro.
Preferisci skill che leggono i dati a skill che li incorporano. Una skill che chiama un'API e legge la risposta costa un importo fisso, non importa quante keyword tu abbia. Una skill che porta dentro il Markdown una tabella di lookup o una libreria di template costa lo stesso, che tu abbia bisogno della tabella o no. È per questo che un wrapper DataForSEO da 849 token in pratica costa meno di quanto sembri, e per questo una grande skill di contenuti guidata da template costa più di quanto suggerisca la sua descrizione.
Metti a budget la sessione, non lo scaffale. Il numero che conta è il totale dei token in una sessione attiva, e le skill sono un input tra diversi. Una sessione con un export di scansione incollato e tre skill caricate è un problema di contesto. Una sessione con venti skill disponibili e una caricata non lo è.
Quando una skill è la scelta giusta e quando no
Skill e server MCP risolvono metà diverse dello stesso problema, e usare la metà sbagliata per il lavoro è il motivo per cui i team finiscono senza nessuna delle due.
Una skill è istruzione e non sa nulla. È la forma giusta per un giudizio ripetibile, come triage di un calo di posizioni, come strutturare l'output di un audit, o quali prove servono a una revisione del profilo link. Il suo costo è il contesto, e si paga a sessione.
Un server MCP è una connessione viva. È la forma giusta per dati che l'agente non raggiunge altrimenti, come Search Console o un indice di backlink. Il suo costo è configurazione, credenziali e permessi, e si paga una volta. Se vuoi sapere cosa espongono davvero queste connessioni prima di collegarne una, il nostro confronto tra quattro server MCP SEO è in questa prova.
La coppia che funziona: una connessione per fonte di dati, una skill per giudizio ricorrente. Nel nostro flusso di lavoro la connessione a Search Console è un server e la routine di monitoraggio quotidiana è una skill, perché il giudizio è la parte che si ripete.
Cosa controllare prima di installarne una
Un breve passaggio di verifica, perché il formato è facile da scrivere e facile da scrivere male.
- Leggi il frontmatter e conferma che la descrizione nomini un trigger specifico. Una descrizione che dice "aiuta con la SEO" si caricherà nei momenti sbagliati.
- Conta le righe sotto il frontmatter. Sotto le 100 righe è una skill focalizzata. Oltre le 500 righe, controlla se il dettaglio è materiale di riferimento che dovrebbe essere un file separato che la skill legge su richiesta.
- Cerca nel file credenziali e percorsi scritti in duro. Una skill dovrebbe leggere la configurazione dall'ambiente, non portarsi dietro un token.
- Controlla se scrive sul tuo sito. Una skill che legge soltanto è sicura da provare su una proprietà reale. Una skill che modifica file dovrebbe avere un passaggio di revisione prima che qualcosa cambi.
- Eseguila una volta su una proprietà che non ti interessa e leggi l'output. La maggior parte delle skill viene giudicata dal formato dell'output, non dalle istruzioni.
Domande frequenti
Le skill installate rallentano ogni sessione? Solo dei loro blocchi di metadati. Nella nostra libreria la mediana è 107 token e il totale sui 76 file è 8.231 token. Le istruzioni si caricano quando la skill viene usata, non prima.
Quante skill SEO dovrei tenere installate? Nel nostro insieme, dieci skill di ricerca e misurazione costano circa 1.000 token di metadati in attesa. Il limite è raramente il contesto. Il limite vero è la tua capacità di ricordare a cosa serve ciascuna.
Un file di skill grande è un brutto segno? Non automaticamente. Le skill ricche di materiale di riferimento sono legittimamente lunghe. Ma la lunghezza dovrebbe essere giustificata da ciò che la skill fa. Se una skill di 500 righe esegue una sola chiamata API con molte spiegazioni, quello è un problema di documentazione, non di capacità.
Posso scrivere una mia skill Claude SEO? Sì, ed è l'opzione con il rendimento più alto appena hai una routine che si ripete. Inizia eseguendo il lavoro a mano due volte, annota i passaggi che non sono cambiati e mettili nel corpo. Tieni il frontmatter sotto i 150 token e descrivi il trigger con precisione.
Questi numeri valgono specificamente per Claude Code? Il formato e il modello di divulgazione progressiva sono condivisi tra gli agenti che supportano SKILL.md, inclusi Claude Code e Codex. La misurazione viene dalla nostra libreria, quindi aspettati che la tua distribuzione sia diversa in base alla dimensione dei tuoi file.
Vista Auspia: installa lo scaffale che vuoi, poi verifica cosa si attiva. Il costo in attesa di una libreria di skill è abbastanza piccolo da smettere di preoccuparsene, e il costo di invocazione è il punto in cui una skill scritta male fa davvero male. Se non hai mai misurato il tuo insieme, contare le righe sotto il frontmatter in ogni file richiede una decina di minuti e ti dice dove sta il peso. La separazione dettagliata tra skill e server per il lavoro GEO è trattata nelle nostre note sulle skill GEO.
Scritto da: Alice Monroe, analisi di strumenti AI SEO con copertura di oltre 150 strumenti in Auspia. Scrive di strumenti AI SEO, architettura di skill e server, e di quanto costa davvero ogni livello di uno stack di agenti.
