Creazione di agenti con le Skills: equipaggiare gli agenti per lavoro specializzato

Le Skills racchiudono competenze settoriali in file a cui gli agenti possono accedere e che possono applicare, trasformando gli agenti generici in specialisti competenti per lavori reali.

Nell'ultimo anno sono cambiate molte cose. MCP è diventato lo standard per la connettività degli agenti, con una rapida adozione da parte dei leader del settore e della community degli sviluppatori. Claude Code è stato lanciato come agente di coding generico. Abbiamo inoltre lanciato Claude Agent SDK, che ora fornisce un agente pronto per la produzione.

Tuttavia, man mano che abbiamo sviluppato e distribuito questi agenti, ci siamo imbattuti continuamente nella stessa lacuna: gli agenti dispongono di intelligenza e funzionalità, ma non sempre delle competenze necessarie per affrontare con efficacia il lavoro reale. Questo ci ha portato a creare le Agent Skills. Le Skills sono raccolte organizzate di file che racchiudono competenze specifiche del settore — flussi di lavoro, best practice, script — in un formato a cui gli agenti possono accedere e che possono applicare. Trasformano un generalista competente in uno specialista esperto.

In questo post, spiegheremo perché abbiamo smesso di creare agenti specializzati e abbiamo iniziato a creare Skills e come questa svolta stia cambiando il nostro modo di pensare all'estensione delle capacità degli agenti.

Il nuovo paradigma: tutto ciò che serve è il codice

Eravamo soliti pensare che gli agenti in ambiti diversi avrebbero avuto un aspetto molto diverso. Un agente di codifica, un agente di ricerca, uno per la finanza, uno per il marketing: ognuno sembrava aver bisogno dei propri strumenti e delle proprie strutture. Il settore ha adottato inizialmente questo modello di agenti specifici di dominio. Tuttavia, man mano che i modelli miglioravano in termini di intelligenza e le capacità degli agenti progredivano, abbiamo convergito su un approccio diverso.

Siamo giunti a considerare il codice meno come un semplice caso d'uso e più come un'interfaccia tramite cui gli agenti possono svolgere pressoché qualsiasi attività digitale. Claude Code è un agente di codifica, ma anche un agente di uso generale che si trova a operare attraverso il codice.

Considera l'utilizzo di Claude Code per generare un report finanziario. Può chiamare API per la ricerca, archiviare dati nel file system, analizzarli con Python e sintetizzare informazioni approfondite. Tutto ciò avviene tramite codice. La struttura diventa semplice come bash e un filesystem.

Tuttavia, le capacità generali non coincidono con le competenze specialistiche. Quando abbiamo iniziato a utilizzare Claude Code per lavori reali, è emersa una lacuna.

Il pezzo mancante: le competenze di dominio

Chi vorresti che presentasse la dichiarazione dei redditi: un genio della matematica che la risolve partendo dai primi principi o un professionista fiscale esperto che ha presentato migliaia di dichiarazioni? La maggior parte delle persone sceglierebbe il professionista fiscale. Non perché siano più intelligenti, ma perché dispongono delle competenze giuste.

Gli agenti di oggi sono simili a quel genio della matematica: brillanti nel ragionare in situazioni inedite, ma spesso privi delle competenze accumulate da un professionista esperto. Possono fare cose sorprendenti con una guida adeguata. Tuttavia, spesso non dispongono di un contesto importante, non riescono ad assorbire facilmente le competenze della tua organizzazione e non imparano automaticamente dalle attività ripetute.

Le Skills colmano questa lacuna racchiudendo le competenze specifiche del settore in un formato che gli agenti possono progressivamente consultare e applicare.

Cosa sono le Agent Skills?

Le Skills racchiudono competenze settoriali e conoscenze procedurali per gli agenti.

anthropic_brand/
├── SKILL.md
├── docs.md
├── slide-decks.md
└── apply_template.py

La semplicità delle Skills è voluta. I file sono una primitiva universale che funziona con ciò che già possiedi. Puoi creare versioni con Git, archiviarle in Google Drive e condividerle con il tuo team. Questa semplicità significa anche che la creazione di competenze non è riservata ai soli ingegneri. Product manager, analisti ed esperti di settore stanno già creando Skills per codificare i propri flussi di lavoro.

Divulgazione progressiva

Le Skills possono contenere informazioni estese. Per proteggere la finestra di contesto e rendere componibili le Skills, si ricorre alla divulgazione progressiva: al momento dell'esecuzione, al modello vengono mostrati solo i metadati (nome e descrizione tratti dal frontmatter YAML).

---
name: Anthropic Brand Style Guidelines
description: Anthropic's official brand colors and typography…
---

Se Claude determina che una Skill è necessaria, legge l'intero file SKILL.md. Per ulteriori dettagli, le Skills possono includere una directory references/ con documentazione di supporto caricata solo su richiesta.

Questo approccio a tre livelli consente di dotare un agente di centinaia di Skills senza sovraccaricarne la finestra di contesto: i metadati utilizzano circa 50 token, i file SKILL.md completi circa 500 token e i file di riferimento oltre 2.000 token, e solo quando specificamente necessario.

Le Skills possono includere script come strumenti

Gli strumenti tradizionali presentano problemi: alcuni hanno istruzioni scritte in modo scadente, il modello non è sempre in grado di modificarli o estenderli e spesso gonfiano la finestra di contesto. Il codice, d'altra parte, si documenta autonomamente, è modificabile e non ha bisogno di essere nel contesto in ogni momento.

Di seguito un esempio reale: abbiamo visto Claude scrivere lo stesso script per applicare lo stile di Anthropic alle diapositive. Abbiamo chiesto a Claude di salvarlo come strumento per sé:

# anthropic/brand_styling/apply_template.py
import sys
from pptx import Presentation

if len(sys.argv) != 2:
    print("USAGE: apply_template.py <pptx>")
    sys.exit(1)

prs = Presentation(sys.argv[1])
for slide in prs.slides:
    ...

La documentazione corrispondente in slide-decks.md fa semplicemente riferimento a questo script:

## Anthropic Slide Decks
- Intro/outro slides
  - background color: `#141413`
  - foreground color: oat
- Section slides:
  - background color: `#da7857`
  - foreground color: `#141413`

Use the `./apply_template.py` script to update a pptx file in-place.

L'ecosistema delle Skills

L'ecosistema delle Skills è emerso rapidamente e finora sono stati sviluppati tre tipi principali di Skills:

Skills di base

Queste forniscono le funzionalità principali di cui tutti hanno bisogno: lavorare con documenti, fogli di calcolo, presentazioni ecc. Codificano le best practice per la generazione e la manipolazione dei documenti. Puoi vedere come si presenta nella pratica esplorando le Skills di base nel nostro repository pubblico.

Skills per i partner

Man mano che le Skills standardizzano il modo in cui gli agenti interagiscono con capacità specializzate, le aziende stanno sviluppando Skills per rendere i propri servizi accessibili agli agenti. K-Dense, Browserbase, Notion e molti altri stanno creando Skills che integrano direttamente i propri servizi, estendendo le capacità di Claude in settori specifici, mantenendo al contempo la semplicità del formato delle Skills.

Skills aziendali

Le organizzazioni creano Skills proprietarie che codificano i processi interni e le competenze di settore. Le Skills consentono di acquisire i flussi di lavoro specifici, i requisiti di conformità e le conoscenze istituzionali che rendono un agente utile per le attività aziendali.

Tendenze che vediamo

Con la crescita dell'adozione delle Skills, stanno emergendo diversi pattern che indicano la possibile direzione di questo paradigma. Queste tendenze influenzano il modo in cui pensiamo alla progettazione delle Skills e agli strumenti che stiamo creando per supportare gli sviluppatori di Skills.

Crescente complessità

Le prime Skills erano semplici riferimenti alla documentazione. Oggi assistiamo a flussi di lavoro sofisticati in più fasi che coordinano il recupero dei dati, calcoli complessi e output formattati su più strumenti.

Semplice: "Scrittore di report sullo stato del servizio" (~100 righe): modelli e formattazione
Intermedio: "Creatore di modelli finanziari" (~800 righe): recupero dei dati, modellazione Excel con Python
Complesso: "Pipeline di sequenziamento dell'RNA" (oltre 2.500 righe): coordina HISAT2, StringTie, analisi DESeq2

Skills e MCP

Le Skills e i server MCP interagiscono in modo naturale. Una skill di analisi della concorrenza potrebbe coordinare la ricerca sul web, i database interni tramite MCP, la cronologia dei messaggi Slack e le pagine Notion per sintetizzare un report completo.

Adozione da parte di non sviluppatori

La creazione di Skills si sta espandendo oltre gli ingegneri, raggiungendo product manager, analisti ed esperti di settore di varie discipline. Possono creare e testare la loro prima skill in meno di 30 minuti utilizzando lo strumento skill-creator, che li guida in modo interattivo attraverso il processo. Stiamo lavorando per rendere la creazione di skill ancora più accessibile, grazie a strumenti e modelli migliorati che consentono a chiunque di acquisire e condividere le proprie competenze.

L'architettura completa

Riassumendo, l'architettura degli agenti emergente sembra una combinazione di:

Loop dell'agente: il sistema di ragionamento principale che decide cosa fare dopo
Runtime dell'agente: ambiente di esecuzione (codice, file system)
Server MCP: connessioni a strumenti e fonti di dati esterne
Libreria delle Skills: competenze settoriali e conoscenze procedurali

Ogni livello ha uno scopo chiaro: il loop ragiona, il runtime esegue, MCP connette e le Skills guidano. Questa separazione rende il sistema comprensibile e consente a ciascuna parte di evolversi in modo indipendente.

Consideri cosa succede quando si aggiunge una singola skill a questa architettura. La skill di progettazione frontend trasforma istantaneamente le funzionalità frontend di Claude. Fornisce una guida specializzata su tipografia, teoria del colore e animazione, attivandosi solo durante la creazione di interfacce web. Il progressive disclosure significa che viene caricato solo quando pertinente. Aggiungere nuove funzionalità è semplice.

Distribuzione delle Skills in nuovi settori verticali

Questo modello emergente di agenti generali dotati di server MCP e Skills ci sta già aiutando a distribuire Claude in nuovi settori verticali.

Servizi finanziari

Subito dopo il lancio delle Skills, abbiamo potenziato Claude per il settore dei servizi finanziari con Skills che rendono Claude più utile per i professionisti della finanza:

Creatore di modelli DCF: costruisce modelli di flusso di cassa attualizzato con calcoli WACC corretti e analisi di sensibilità
Analisi di società comparabili: genera tabelle comparative con multipli pertinenti e benchmarking
Analisi degli utili: elabora i risultati trimestrali e crea report di aggiornamento sugli investimenti
Inizio copertura: crea report di ricerca completi con modelli finanziari
Due diligence: struttura l'analisi di M&A con framework standardizzati
Materiali per i pitch: crea presentazioni per i clienti secondo gli standard del settore

Sanità e Scienze della vita

Abbiamo inoltre potenziato le nostre offerte per il settore sanitario e le scienze biologiche con Skills che rendono Claude più utile per ricercatori, medici e sviluppatori sanitari:

Pacchetti bioinformatici: Skills per scVI-tools e i deployment Nextflow, essenziali per la gestione delle pipeline genomiche e il sequenziamento dell'RNA unicellulare
Generazione di protocolli per studi clinici: accelera lo sviluppo di protocolli per la ricerca clinica
Selezione dei problemi scientifici: aiuta i ricercatori a identificare e inquadrare domande di ricerca d'impatto
Sviluppo FHIR: aiuta gli sviluppatori a scrivere codice più preciso per l'interoperabilità dei dati sanitari, collegando i sistemi sanitari più rapidamente e con meno errori
Verifica delle autorizzazioni preventive: riduce gli oneri amministrativi e accelera l'accesso dei pazienti alle cure necessarie confrontando i requisiti di copertura, le linee guida cliniche e le cartelle cliniche

Standardizzazione delle Agent Skills

Per realizzare questa visione, stiamo pubblicando le Agent Skills come standard aperto. Come MCP, siamo convinti che le Skills dovrebbero essere portatili su strumenti e piattaforme diversi. La stessa Skill dovrebbe funzionare indipendentemente dal fatto che si utilizzi Claude o altre piattaforme di IA. Abbiamo collaborato con i membri dell'ecosistema per sviluppare lo standard e siamo entusiasti di vederne l'adozione iniziale.

Quando qualcuno inizia a utilizzare un agente IA per la prima volta, dovrebbe già sapere cosa interessa a te e al tuo team, perché le Skills catturano e trasferiscono tali competenze. Con la crescita di questo ecosistema, una Skill sviluppata da qualcun altro nella community può rendere il tuo agente più utile, affidabile e capace, indipendentemente dalla piattaforma IA utilizzata.

Per iniziare

Stiamo convergendo verso un'architettura per agenti di uso generale e le Skills rappresentano un paradigma per il rilascio e la condivisione di nuove funzionalità. Il valore reale emerge dalla knowledge base collettiva che costruiamo insieme: acquisendo le competenze, trasferendole tra i team e rendendo ogni agente più capace del precedente.

Risorse:

Riconoscimenti:

Barry Zhang, Mahesh Murag, Keith Lazuka, Ryan Whitehead