Le Custom Skills ti permettono di migliorare Claude con conoscenze specializzate e flussi di lavoro specifici della tua organizzazione o del tuo stile di lavoro personale. Questo articolo spiega come creare, strutturare e testare le tue Skills.
Le Skills possono essere semplici come poche righe di istruzioni o complesse come pacchetti multi-file con codice eseguibile. Le migliori Skills:
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
Creazione di un file Skill.md
Ogni Skill consiste in una directory contenente almeno un file Skill.md, che è il nucleo della Skill. Questo file deve iniziare con un frontmatter YAML per contenere i campi name e description, 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 Skill (massimo 64 caratteri)
Esempio: Brand Guidelines
description: Una descrizione chiara di cosa fa la Skill e quando utilizzarla.
Questo è critico—Claude utilizza questo per determinare quando invocare la tua Skill (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 opzionali
dependencies: Pacchetti software richiesti dalla tua Skill.
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 necessarie affinché Claude sappia quando la Skill dovrebbe 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 del tuo compito, Claude può accedere al file Skill.md e utilizzare la Skill.
Esempio Skill.md
Skill Brand Guidelines
## 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.
Aggiunta di 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.
Aggiunta di script
Per Skills più avanzate, allega file di codice eseguibile a Skill.md, permettendo a Claude di eseguire codice. Ad esempio, le nostre document skills 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 Skills. Non è possibile installare pacchetti aggiuntivi in fase di esecuzione con API Skills—tutte le dipendenze devono essere pre-installate nel container.
Pacchettizzazione della tua Skill
Una volta completata la cartella Skill:
Assicurati che il nome della cartella corrisponda al nome della tua Skill
Crea un file ZIP della cartella
Lo ZIP dovrebbe 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)
Test della 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 Impostazioni > Capacità