Cos'è una skill
Una skill è una cartella il cui nome corrisponde al name della skill. La cartella contiene un file SKILL.md e, se vuoi, qualsiasi altro file a cui le istruzioni fanno riferimento: documenti di riferimento, modelli o script.
SKILL.md ha due parti. Il frontmatter YAML tra le righe --- contiene il nome e una descrizione. Il corpo in Markdown che segue contiene le istruzioni.
Come i dipendenti usano le skill
Un dipendente lavora con una skill in tre passaggi.
- Sceglie. A ogni turno, il dipendente vede un elenco delle skill a sua disposizione: il nome di ogni skill, la sua descrizione e fino a tre dei suoi trigger. La descrizione è ciò che il dipendente legge per decidere, quindi scrivila in modo che dica cosa fa la skill e quando usarla.
- Carica. Il dipendente chiama lo strumento
use_skillcon il nome della skill. Lo strumento restituisce le istruzioni, il percorso della cartella della skill e i nomi dei suoi file. È l'unico modo in cui un dipendente legge una skill. - Lavora. Il dipendente segue le istruzioni. Legge i file di supporto con
read_skill_fileed esegue gli script inclusi conexecute.
I trigger non caricano mai una skill da soli. La scelta spetta sempre al dipendente. Quando l'elenco diventa lungo, il dipendente può cercarvi con find_skills.
Scrivi la tua prima skill
Crea una cartella con il nome della skill, con un file al suo interno.
meeting-notes/ └── SKILL.md
--- name: meeting-notes description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript. --- # Meeting notes 1. List the decisions that were made. 2. List action items as "owner — task — due date". 3. List open questions that need a follow-up. Keep each list short. If the transcript names no owner for an item, write "unassigned".
Metti la cartella nella cartella delle skill utente di un bot (vedi Dove si trovano le skill). Nebo nota la nuova cartella entro circa un secondo, e ogni dipendente di quel bot può usare la skill.
Anche un dipendente può scrivere una skill per te. Chiedigli di salvarne una e chiamerà save_skill, che scrive la cartella nella stessa cartella delle skill utente.
Regole imposte dal caricatore
Una skill che viola una di queste regole non viene caricata. Nebo registra un avviso e la salta.
| Regola | Dettaglio |
|---|---|
Il file inizia con --- | Il frontmatter deve essere la prima cosa nel file. Il file deve essere in UTF-8. |
name è obbligatorio | Solo lettere minuscole, cifre e trattini; nessun trattino iniziale o finale; nessun trattino doppio; al massimo 64 byte. |
description è obbligatorio | Al massimo 1.024 byte. |
| I campi hanno il tipo giusto | Un campo con il tipo YAML sbagliato fa fallire l'intero file. Metti le versioni tra virgolette, come "1.0.0". |
platform corrisponde | Se presente, la skill si carica solo sui sistemi operativi elencati. |
Le chiavi del frontmatter che Nebo non riconosce vengono ignorate. Il corpo non ha limiti di dimensione, ma istruzioni più brevi lasciano più spazio al lavoro. Sposta il materiale lungo in file che il dipendente legge quando gli servono.
Aggiungi file
Qualsiasi file nella cartella diverso da SKILL.md e dai file nascosti è a disposizione del dipendente. I nomi delle cartelle li scegli tu; Nebo non dà alcun significato speciale a references/ o assets/. I file in scripts/ o bin/ si possono eseguire.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Fai riferimento ai file con il loro percorso dentro la cartella, come references/policy.md. Il dipendente li legge con read_skill_file, che rifiuta qualsiasi percorso che esca dalla cartella. Gli script vengono eseguiti con lo strumento execute in una sandbox. Il riferimento di SKILL.md tratta runtime, variabili d'ambiente, segreti e accesso alla rete.
Dove si trovano le skill
Un bot raccoglie le skill da diversi posti. Quando due fonti forniscono una skill con lo stesso nome, prevale la fonte che viene dopo in questo elenco.
| Fonte | Posizione | Chi può usarla |
|---|---|---|
| Integrata | Compilata in Nebo | Tutti i dipendenti |
| Marketplace | <data>/nebo/skills/<slug>/<version>/ | Tutti i dipendenti |
| Plugin | La cartella skills/ di un plugin installato | Tutti i dipendenti |
| Utente | <data>/user/skills/<name>/ | Tutti i dipendenti |
| Pacchetto dipendente | skills/ dentro un pacchetto dipendente installato | Solo quel dipendente |
| Appresa | <data>/learned/skills/<employee>/<name>/ | Solo quel dipendente |
<data> è ~/Library/Application Support/Nebo su macOS, %APPDATA%\Nebo su Windows e ~/.local/share/nebo su Linux. La variabile d'ambiente NEBO_HOME la sostituisce. Quando un dipendente ha una propria skill e una skill condivisa con lo stesso nome, prevale la sua.
Nebo osserva queste cartelle e ricarica una skill modificata dopo un secondo. Per disattivare una skill senza eliminarla, rinomina il suo file in SKILL.md.disabled.
Le skill descrivono il lavoro, non gli strumenti. Scrivi una skill attorno a una responsabilità, come riconciliare le ricevute, e lascia che il dipendente usi qualunque connessione il proprietario abbia fornito. Quando una skill ha davvero bisogno di un plugin, dichiaralo con il campo plugins.
Prossimi passi
- Riferimento di SKILL.md: ogni campo, strumento e variabile.
- Esempi: skill complete da copiare.
- Pubblicazione: metti una skill sul marketplace.