Inizia a usare gli Agent Skills nell’API
Scopri come usare gli Agent Skills per creare documenti con la Claude API in meno di 10 minuti.
Questo tutorial ti mostra come usare gli Agent Skills per creare una presentazione PowerPoint. Imparerai come abilitare gli Skills, effettuare una richiesta e accedere al file generato.
Prima di iniziare
Ti servono un SDK client per il tuo linguaggio, oppure curl e jq, e una familiarità di base con l’esecuzione di richieste API.
Crea un account Claude Console
Registrati per un account Claude Console, oppure accedi a quello che hai già.
Scegli come autenticarti
L’accesso tramite la CLI è consigliato per lo sviluppo locale.
CLIChiave API
Installa la CLI
brew install anthropics/tap/antPer gli ambienti Linux, scarica direttamente il binario della release.
VERSION=2.12.0 OS=$(uname -s | tr '[:upper:]' '[:lower:]') case $(uname -m) in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \ | sudo tar -xz -C /usr/local/bin antPuoi trovare tutte le release nella pagina delle release su GitHub.
Puoi anche installare la CLI dal codice sorgente con
go install, che richiede Go 1.26.10 o successivo.go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo installposiziona il binario in$(go env GOPATH)/bin. Aggiungi quella directory al tuoPATHse non è già presente:export PATH="$PATH:$(go env GOPATH)/bin"Accedi
ant auth loginUna volta completato l’accesso, gli SDK e la CLI rileveranno automaticamente le tue credenziali.
Crea una chiave API
Crea una chiave API nella Claude Console.
Imposta la variabile d’ambiente
Gli SDK e la CLI leggono la tua chiave da
ANTHROPIC_API_KEY:export ANTHROPIC_API_KEY="your-api-key-here"
Per eseguire gli esempi della CLI, installa la CLI:
brew install anthropics/tap/antPer gli ambienti Linux, scarica direttamente il binario della release.
VERSION=2.12.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
x86_64) ARCH=amd64 ;;
aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin antPuoi trovare tutte le release nella pagina delle release su GitHub.
Puoi anche installare la CLI dal codice sorgente con go install, che richiede Go 1.26.10 o successivo.
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo install posiziona il binario in $(go env GOPATH)/bin. Aggiungi quella directory al tuo PATH se non è già presente:
export PATH="$PATH:$(go env GOPATH)/bin"Panoramica degli Agent Skills
Gli Agent Skills predefiniti estendono le capacità di Claude con competenze specializzate per attività come la creazione di documenti, l’analisi di dati e l’elaborazione di file. Anthropic fornisce i seguenti Agent Skills predefiniti nell’API:
- PowerPoint (pptx): Crea e modifica presentazioni
- Excel (xlsx): Crea e analizza fogli di calcolo
- Word (docx): Crea e modifica documenti
- PDF (pdf): Genera documenti PDF
Passaggio 1: Elenca gli Skills disponibili
Per prima cosa, verifica quali Skills sono disponibili. Usa la Skills API per elencare tutte le Skills gestite da Anthropic. L’esempio è un estratto di un unico script continuo, con eventuali import e configurazione del client all’inizio:
# Elenca le Skill gestite da Anthropic
skills = client.skills.list(source="anthropic")
for skill in skills.data:
print(f"{skill.id}: {skill.display_name}")Vedrai i seguenti Skills: pptx, xlsx, docx e pdf.
Questa API restituisce i metadati di ciascuno Skill: il suo nome e la sua descrizione. Claude carica questi metadati all’avvio per determinare quali Skills sono disponibili. Questo è il primo livello della “progressive disclosure” (divulgazione progressiva), in cui Claude scopre gli Skills senza ancora caricarne le istruzioni complete.
Passaggio 2: Crea una presentazione
Usa lo Skill PowerPoint per creare una presentazione sulle energie rinnovabili. Specifica gli Skills usando il parametro container nella Messages API:
# Crea un messaggio con la Skill PowerPoint
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Create a presentation about renewable energy with 5 slides",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)
print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")La richiesta include le seguenti parti:
model: Un modello che supporta lo strumento di esecuzione del codicecontainer.skills: Specifica quali Skills Claude può usaretype: "anthropic": Indica che si tratta di uno Skill gestito da Anthropicskill_id: "pptx": L’identificatore dello Skill PowerPointversion: "latest": La versione dello Skill impostata sulla più recente pubblicatatools: Abilita l’esecuzione del codice (richiesta per gli Skills)
Quando effettui questa richiesta, Claude abbina automaticamente la tua attività allo Skill pertinente. Poiché hai chiesto una presentazione, Claude determina che lo Skill PowerPoint è pertinente e ne carica le istruzioni complete: il secondo livello della divulgazione progressiva. Quindi Claude esegue il codice dello Skill per creare la tua presentazione.
Passaggio 3: Scarica il file creato
La presentazione è stata creata nel container di esecuzione del codice e salvata come file. La response del Passaggio 2 include un riferimento al file con un ID file. Estrai l’ID file e scarica il file con la Files API. L’esempio lo salva nella directory temporanea del tuo sistema:
# Estrai l'ID del file. Lo strumento di esecuzione del codice esegue il codice della Skill tramite
# il suo sotto-strumento Bash, e i file generati appaiono come elementi bash_code_execution_output
# all'interno del blocco bash_code_execution_tool_result.
file_id = None
for block in response.content:
if block.type == "bash_code_execution_tool_result":
if block.content.type == "bash_code_execution_result":
for output in block.content.content:
file_id = output.file_id
if file_id:
# Scarica il file e salvalo
output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
file_content = client.files.download(file_id=file_id)
file_content.write_to_file(output_path)
print(f"Presentation saved to {output_path}")Prova altri esempi
Prova queste varianti:
Crea un foglio di calcolo
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Create a quarterly sales tracking spreadsheet with sample data",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)Crea un documento Word
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "docx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Write a 2-page report on the benefits of renewable energy",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)Genera un PDF
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "pdf", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Generate a PDF invoice template",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)Prossimi passi
Scopri come scrivere Skills efficaci che Claude possa individuare e usare con successo.
Scopri come usare gli Agent Skills per estendere le capacità di Claude tramite l’API.
Carica i tuoi Skills per attività specializzate.
Scopri gli Skills in Claude Code.
Esplora Skills di esempio e pattern di implementazione.
Questa pagina ti è stata utile?