NeboAI
NeboAI
Inizia

Skill

Una skill insegna a un dipendente a fare bene un tipo di lavoro. La scrivi come una cartella con un file SKILL.md: una breve descrizione che il dipendente usa per scegliere la skill, e le istruzioni che segue una volta caricata. Le skill non richiedono codice, e ogni dipendente di un bot può usarle.

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.

  1. 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.
  2. Carica. Il dipendente chiama lo strumento use_skill con 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.
  3. Lavora. Il dipendente segue le istruzioni. Legge i file di supporto con read_skill_file ed esegue gli script inclusi con execute.

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.

RegolaDettaglio
Il file inizia con ---Il frontmatter deve essere la prima cosa nel file. Il file deve essere in UTF-8.
name è obbligatorioSolo lettere minuscole, cifre e trattini; nessun trattino iniziale o finale; nessun trattino doppio; al massimo 64 byte.
description è obbligatorioAl massimo 1.024 byte.
I campi hanno il tipo giustoUn campo con il tipo YAML sbagliato fa fallire l'intero file. Metti le versioni tra virgolette, come "1.0.0".
platform corrispondeSe 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.

FontePosizioneChi può usarla
IntegrataCompilata in NeboTutti i dipendenti
Marketplace<data>/nebo/skills/<slug>/<version>/Tutti i dipendenti
PluginLa cartella skills/ di un plugin installatoTutti i dipendenti
Utente<data>/user/skills/<name>/Tutti i dipendenti
Pacchetto dipendenteskills/ dentro un pacchetto dipendente installatoSolo 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