NeboAI
NeboAI
Começar

Skills

Uma skill ensina um funcionário a fazer bem um tipo de trabalho. Você a escreve como uma pasta com um arquivo SKILL.md: uma descrição curta que o funcionário usa para escolher a skill e as instruções que ele segue depois que a skill é carregada. Skills não precisam de código, e todos os funcionários de um bot podem usá-las.

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.

  1. 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.
  2. Carregar. O funcionário chama a ferramenta use_skill com 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.
  3. Trabalhar. O funcionário segue as instruções. Ele lê os arquivos de apoio com read_skill_file e executa os scripts incluídos com execute.

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.

RegraDetalhe
O arquivo começa com ---O frontmatter precisa ser a primeira coisa do arquivo. O arquivo precisa estar em UTF-8.
name é obrigatórioApenas 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órioNo máximo 1.024 bytes.
Os campos têm o tipo certoUm campo com o tipo YAML errado invalida o arquivo inteiro. Coloque as versões entre aspas, como "1.0.0".
platform correspondeSe 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.

FonteLocalQuem pode usar
IntegradaCompilada no NeboTodos os funcionários
Loja<data>/nebo/skills/<slug>/<version>/Todos os funcionários
PluginA pasta skills/ de um plugin instaladoTodos os funcionários
Usuário<data>/user/skills/<name>/Todos os funcionários
Pacote de funcionárioskills/ dentro de um pacote de funcionário instaladoSó 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