Le competenze sono disponibili per gli utenti dei piani Free, Pro, Max, Team ed Enterprise. Questa funzione richiede che l'esecuzione del codice sia abilitata. Le competenze sono disponibili anche in versione beta per gli utenti di Claude Code e per tutti gli utenti API che utilizzano lo strumento di esecuzione del codice.
Le competenze personalizzate ti permettono di migliorare Claude con conoscenze specializzate e flussi di lavoro specifici per la tua organizzazione o il tuo stile di lavoro personale. Questo articolo spiega come creare, strutturare e testare le tue competenze.
Le competenze possono essere semplici come poche righe di istruzioni o complesse come pacchetti multi-file con codice eseguibile. Le migliori competenze:
Risolvono un compito specifico e ripetibile
Hanno istruzioni chiare che Claude può seguire
Includono esempi quando utili
Definiscono quando devono essere utilizzate
Si concentrano su un flusso di lavoro piuttosto che cercare di fare tutto
Registrare una competenza
La registrazione di una competenza è disponibile nei piani Pro, Max e Team, in Cowork in Claude per Mac. Non è disponibile in chat, su Windows o nei piani Free ed Enterprise.
Invece di scrivere una competenza manualmente, puoi registrare te stesso mentre esegui un'attività e lasciare che Claude costruisca la competenza da ciò che osserva. Invii a Claude un video del tuo schermo, dei clic, della digitazione e della voce, e Claude propone una competenza che puoi rivedere prima di salvarla.
Prima di registrare
Aggiorna alla versione più recente di Claude per Mac.
Concedi i permessi macOS che Claude richiede la prima volta che registri: Accessibilità per il tracciamento del mouse e della tastiera, e Registrazione dello schermo per la visibilità dello schermo. macOS potrebbe chiederti di riavviare Claude.
Chiudi i file, le app o le conversazioni che non desideri acquisire.
Avvertenza: Non digitare password o segreti, né visualizzare informazioni sensibili o conversazioni private durante la registrazione. Tutto ciò che è sullo schermo viene acquisito per la durata della sessione, insieme a tutto ciò che dici.
Registra il tuo flusso di lavoro
Apri Cowork in Claude per Mac.
Avvia una registrazione in uno di due modi:
Fai clic sul pulsante "+" nel compositore, quindi seleziona "Registra una competenza".
Vai a Personalizza > Competenze, fai clic su "Aggiungi", quindi seleziona "Registra il tuo schermo".
Fai clic su "Avvia registrazione". Per narrare mentre lavori, lascia il microfono acceso. Usa il controllo del microfono per disattivarlo o scegliere un input diverso.
Esegui l'attività come faresti normalmente. La barra di acquisizione mostra che la registrazione è in corso e conta i passaggi acquisiti.
Fai clic su "Fine" al termine, oppure "Scarta" per eliminare la registrazione senza creare nulla.
Una registrazione può durare circa 10 minuti. Un conto alla rovescia appare nella barra di acquisizione quando rimane circa un minuto. Quando raggiunge zero, la registrazione si interrompe e tutto ciò che hai acquisito fino a quel momento viene inviato a Claude, come se avessi fatto clic su "Fine".
Suggerimento: Parla di ciò che stai facendo mentre registri. La narrazione fornisce a Claude il contesto che non può ottenere dal solo schermo, come il motivo per cui salti un passaggio o come scegli tra due opzioni.
Cosa succede dopo aver fatto clic su Fine
Claude avvia un'attività Cowork e esamina la registrazione, quindi propone una competenza. A seconda di ciò che trova, vedrai una di due cose:
Una nuova competenza, contrassegnata come NUOVA sulla scheda della proposta. Fai clic su "Salva" per mantenerla, oppure "Scarta" per eliminare la proposta.
Un aggiornamento a una competenza esistente. Se la registrazione si sovrappone a una competenza che hai già, Claude propone modifiche a quella competenza. La scheda mostra su quale competenza si basa la proposta. Fai clic su "Aggiorna" per applicare le modifiche, oppure "Scarta" per eliminarle.
Espandi Contenuto sulla scheda della proposta per leggere la competenza prima di decidere.
Le competenze che salvi da una registrazione vengono visualizzate in Personalizza > Competenze e funzionano come qualsiasi altra competenza. Puoi modificarle, condividerle ed eliminarle alle stesse condizioni.
Cosa viene conservato da una registrazione
Il video e l'audio della tua registrazione non vengono conservati. Dopo aver inviato la tua registrazione a Claude, Claude esamina la registrazione per costruire la competenza. Ciò che viene salvato successivamente è un set di screenshot della sessione, che puoi visualizzare espandendo il passaggio Dimostrazione registrata nell'attività.
Poiché questi screenshot si trovano nell'attività Cowork, l'eliminazione dell'attività li rimuove. Consulta Inizia con Claude Cowork per informazioni su come funzionano l'eliminazione e la conservazione delle attività.
Crea un file skill.md
Ogni competenza consiste in una directory contenente almeno un file skill.md, che è il nucleo della competenza. Questo file deve iniziare con un frontmatter YAML per contenere i campi nome e descrizione, che sono metadati obbligatori. Può anche contenere metadati aggiuntivi, istruzioni per Claude o file di riferimento, script eseguibili o strumenti.
Campi di metadati obbligatori
name: Un nome descrittivo per la tua competenza (massimo 64 caratteri)
Esempio: Linee guida del marchio
description: Una chiara descrizione di cosa fa la competenza e quando usarla.
Questo è critico—Claude usa questo per determinare quando invocare la tua competenza (massimo 200 caratteri).
Esempio: Applica le linee guida del marchio Acme Corp a presentazioni e documenti, inclusi colori ufficiali, caratteri e utilizzo del logo.
Campi di metadati facoltativi
dependencies: Pacchetti software richiesti dalla tua competenza.
Esempio: python>=3.8, pandas>=1.5.0
I metadati nel file skill.md servono come primo livello di un sistema di divulgazione progressiva, fornendo solo le informazioni sufficienti affinché Claude sappia quando la competenza deve essere utilizzata senza dover caricare tutto il contenuto.
Corpo Markdown
Il corpo markdown è il secondo livello di dettaglio dopo i metadati, quindi Claude accederà a questo se necessario dopo aver letto i metadati. A seconda dell'attività, Claude può accedere al file skill.md e utilizzare la skill.
Esempio skill.md
Linee guida del brand skill
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
Aggiungi risorse
Se hai troppi contenuti da aggiungere a un singolo file skill.md (ad esempio, sezioni che si applicano solo a scenari specifici), puoi aggiungere più contenuti aggiungendo file nella tua directory skill. Ad esempio, aggiungi un file REFERENCE.md contenente informazioni supplementari e di riferimento alla tua directory skill. Farvi riferimento in skill.md aiuterà Claude a decidere se ha bisogno di accedere a quella risorsa durante l'esecuzione della skill.
Aggiungi script
Per skill più avanzate, allega file di codice eseguibile a skill.md, permettendo a Claude di eseguire il codice. Ad esempio, le nostre skill di documento utilizzano i seguenti linguaggi di programmazione e pacchetti:
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Pacchetti per aiutare con la modifica dei file
Strumenti di visualizzazione
Nota: Claude e Claude Code possono installare pacchetti da repository standard (Python PyPI, JavaScript npm) durante il caricamento delle skill. Non è possibile installare pacchetti aggiuntivi in fase di esecuzione con API Skills—tutte le dipendenze devono essere pre-installate nel container.
Pacchetto della tua skill
Una volta completata la cartella della skill:
Assicurati che il nome della cartella corrisponda al nome della tua skill.
Crea un file ZIP della cartella.
Lo ZIP deve contenere la cartella skill come radice (non come sottocartella).
Struttura corretta:
my-skill.zip
└── my-skill/
├── skill.md
└── resources/
Struttura non corretta:
my-skill.zip
└── (file direttamente nella radice dello ZIP)
Testa la tua skill
Prima del caricamento
1. Rivedi il tuo skill.md per chiarezza.
2. Verifica che la descrizione rifletta accuratamente quando Claude dovrebbe utilizzare la skill.
3. Verifica che tutti i file referenziati esistano nelle posizioni corrette.
4. Testa con prompt di esempio per assicurarti che Claude la invochi appropriatamente.
Dopo il caricamento su Claude
1. Abilita la skill in Personalizza > Skill.
2. Prova diversi prompt che dovrebbero attivarla.
3. Rivedi il ragionamento di Claude per confermare che sta caricando la skill.
4. Itera sulla descrizione se Claude non la utilizza quando previsto.
Quando stai iterando su una skill con Claude in chat, puoi modificare i file della skill direttamente dove si aprono accanto alla conversazione. Evidenzia il testo che desideri modificare, fai clic su "Modifica con Claude" e digita la tua richiesta. Per skill con più file, lascia richieste di modifica tra i file e inviale insieme, e Claude le applica in un unico passaggio. Scopri di più su modifica degli artefatti.
Nota per i piani Team ed Enterprise: Per rendere una skill disponibile a tutti gli utenti della tua organizzazione, consulta Provisioning e gestione delle skill per la tua organizzazione.
Migliori pratiche
Mantienila focalizzata: Crea skill separate per diversi flussi di lavoro. Più skill focalizzate si compongono meglio di una skill grande.
Scrivi descrizioni chiare: Claude utilizza le descrizioni per decidere quando invocare la tua skill. Sii specifico su quando si applica.
Inizia in modo semplice: Inizia con istruzioni di base in Markdown prima di aggiungere script complessi. Puoi sempre espandere la skill in seguito.
Usa esempi: Includi input e output di esempio nel tuo file skill.md per aiutare Claude a capire come dovrebbe apparire il successo.
Testa in modo incrementale: Testa dopo ogni cambiamento significativo piuttosto che costruire una skill complessa tutto in una volta.
Le skill possono costruirsi l'una sull'altra: Sebbene le skill non possono fare riferimento esplicito ad altre skill, Claude può utilizzare più skill insieme automaticamente. Questa componibilità è una delle parti più potenti della funzione skill.
Rivedi la specifica open Agent Skills: Segui le linee guida su agentskills.io, in modo che le skill che crei possano funzionare su piattaforme che adottano lo standard.
Per una guida più approfondita alla creazione di skill, consulta Migliori pratiche di authoring delle skill nella nostra Claude Docs.
Considerazioni sulla sicurezza
Esercita cautela quando aggiungi script al tuo file skill.md.
Non codificare informazioni sensibili (chiavi API, password).
Esamina le competenze scaricate prima di abilitarle.
Utilizza connessioni MCP appropriate per l'accesso ai servizi esterni.
Competenze di esempio da consultare
Visita il nostro repository su GitHub per competenze di esempio che puoi utilizzare come modelli: https://github.com/anthropics/skills/tree/main/skills.