Skip to main content

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.

Formato di SKILL.md

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