O que é uma skill
Uma skill é uma pasta cujo nome corresponde ao name da skill. A pasta contém um arquivo SKILL.md e, opcionalmente, quaisquer outros arquivos que as instruções citem: documentos de referência, modelos ou scripts.
O SKILL.md tem duas partes. O frontmatter YAML entre linhas --- traz o nome e uma descrição. O corpo em Markdown depois dele traz as instruções.
Como os funcionários usam skills
Um funcionário trabalha com uma skill em três etapas.
- Escolher. A cada turno, o funcionário vê uma lista das skills disponíveis para ele: o nome de cada skill, a descrição e até três dos gatilhos dela. A descrição é o que o funcionário lê para decidir, então escreva-a dizendo o que a skill faz e quando usá-la.
- Carregar. O funcionário chama a ferramenta
use_skillcom o nome da skill. A ferramenta retorna as instruções, o caminho da pasta da skill e os nomes dos arquivos dela. Essa é a única forma de um funcionário ler uma skill. - Trabalhar. O funcionário segue as instruções. Ele lê os arquivos de apoio com
read_skill_filee executa os scripts incluídos comexecute.
Os gatilhos nunca carregam uma skill sozinhos. Quem escolhe é sempre o funcionário. Quando a lista fica longa, o funcionário pode pesquisá-la com find_skills.
Escreva sua primeira skill
Crie uma pasta com o nome da skill, com um arquivo dentro.
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".
Coloque a pasta no diretório de skills do usuário de um bot (veja Onde ficam as skills). O Nebo percebe a nova pasta em cerca de um segundo, e todos os funcionários desse bot podem usar a skill.
Um funcionário também pode escrever uma skill para você. Peça que ele salve uma, e ele chama save_skill, que grava a pasta no mesmo diretório de skills do usuário.
Regras que o carregador aplica
Uma skill que viola uma destas regras não é carregada. O Nebo registra um aviso e a ignora.
| Regra | Detalhe |
|---|---|
O arquivo começa com --- | O frontmatter precisa ser a primeira coisa do arquivo. O arquivo precisa estar em UTF-8. |
name é obrigatório | Apenas letras minúsculas, dígitos e hífens; sem hífen no início ou no fim; sem hífen duplicado; no máximo 64 bytes. |
description é obrigatório | No máximo 1.024 bytes. |
| Os campos têm o tipo certo | Um campo com o tipo YAML errado invalida o arquivo inteiro. Coloque as versões entre aspas, como "1.0.0". |
platform corresponde | Se presente, a skill só é carregada nos sistemas operacionais listados. |
Chaves do frontmatter que o Nebo não reconhece são ignoradas. O corpo não tem limite de tamanho, mas instruções mais curtas deixam mais espaço para o trabalho. Passe o material longo para arquivos que o funcionário lê quando precisar.
Adicionar arquivos
Qualquer arquivo da pasta, exceto o SKILL.md e os arquivos ocultos, fica disponível para o funcionário. Os nomes das pastas você escolhe; o Nebo não dá nenhum significado especial a references/ ou assets/. Os arquivos em scripts/ ou bin/ podem ser executados.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Cite os arquivos pelo caminho dentro da pasta, como references/policy.md. O funcionário os lê com read_skill_file, que rejeita qualquer caminho que saia da pasta. Os scripts rodam com a ferramenta execute em uma sandbox. A referência do SKILL.md explica runtimes, variáveis de ambiente, segredos e acesso à rede.
Onde ficam as skills
Um bot reúne skills de vários lugares. Quando duas fontes oferecem uma skill com o mesmo nome, vale a que aparece por último nesta lista.
| Fonte | Local | Quem pode usar |
|---|---|---|
| Integrada | Compilada no Nebo | Todos os funcionários |
| Loja | <data>/nebo/skills/<slug>/<version>/ | Todos os funcionários |
| Plugin | A pasta skills/ de um plugin instalado | Todos os funcionários |
| Usuário | <data>/user/skills/<name>/ | Todos os funcionários |
| Pacote de funcionário | skills/ dentro de um pacote de funcionário instalado | Só aquele funcionário |
| Aprendida | <data>/learned/skills/<employee>/<name>/ | Só aquele funcionário |
<data> é ~/Library/Application Support/Nebo no macOS, %APPDATA%\Nebo no Windows e ~/.local/share/nebo no Linux. A variável de ambiente NEBO_HOME o substitui. Quando um funcionário tem uma skill própria e uma skill compartilhada com o mesmo nome, vale a própria.
O Nebo observa essas pastas e recarrega uma skill alterada depois de um segundo. Para desativar uma skill sem apagá-la, renomeie o arquivo dela para SKILL.md.disabled.
Skills descrevem trabalho, não ferramentas. Escreva uma skill em torno de uma responsabilidade, como conciliar recibos, e deixe o funcionário usar a conexão que o proprietário tiver fornecido. Quando uma skill realmente precisar de um plugin, declare-o com o campo plugins.
Próximos passos
- Referência do SKILL.md: todos os campos, ferramentas e variáveis.
- Exemplos: skills completas para copiar.
- Publicação: coloque uma skill na loja.