Skills
Le skill sono moduli di prompt riutilizzabili. Puoi caricare SKILL.md per aggiungere alla sessione istruzioni orientate a un dominio specifico.
Panoramica
- Riutilizzabilità del sapere di dominio come skill
- Condivisione dello stesso comportamento tra progetti
- Attivazione/disattivazione a livello di singola sessione
Nella versione Laravel si configurano tramite skillDirectories e disabledSkills di SessionConfig.
Uso di base
skillDirectories sono radici esplicite per il rilevamento delle skill.
Sono utilizzabili indipendentemente dall’impostazione enableConfigDiscovery.
Se specifichi una directory padre, vengono rilevati i SKILL.md presenti in ciascuna sottodirectory.
Serve solo per il rilevamento e non concede all’agente permessi generali di accesso ai file.
Puoi specificarlo anche come array.
Disabilitare skill
Con disabledSkills puoi disabilitare solo alcune delle skill caricate.
Struttura della directory
In skillDirectories specifica una directory padre come skills/.
I percorsi relativi vengono risolti una sola volta rispetto alla workingDirectory effettiva al momento della specifica.
- Omesso o
null: non modifica le altre fonti di rilevamento
[]: cancella solo le radici SDK specificate esplicitamente
disabledSkills, la disabilitazione per fonte e le Managed Settings si applicano anche alle skill rilevate dalle radici esplicite.
SKILL.md è Markdown, con YAML frontmatter opzionale.
Voci principali del frontmatter:
name: identificatore della skill (nome da usare in disabledSkills)
description: breve descrizione della skill
Se ometti name, viene usato il nome della directory.
Combinazione con Custom Agent
Se specifichi un nome di skill in customAgents[].skills, il contenuto della skill viene caricato in anticipo all’avvio dell’agente corrispondente.
Se ometti skills, il contenuto delle skill non viene iniettato nell’agente.
Verifica e operazioni via RPC
Puoi rilevare le skill e abilitarle/disabilitarle anche tramite RPC.
Best practice
- Suddividi le skill per dominio (
skills/security, skills/testing, ecc.)
- Includi
name e description nel frontmatter
- Se ci sono istruzioni in conflitto, escludile esplicitamente con
disabledSkills
- Testa prima ciascuna skill singolarmente, poi combinane più insieme
Riferimenti
Ultima modifica il 19 ottobre 2026