Skills

Uma skill, que o app chama de habilidade, é um conjunto de instruções reutilizáveis: um SKILL.md com nome, descrição e o passo a passo, e arquivos de apoio opcionais, como modelos e scripts. Um agente com a skill a consulta quando o trabalho pede, por exemplo para revisar código ou escrever um relatório num formato fixo.

Tipos de skillCopiar link da seção

Na aba Habilidades do agente, cada skill tem uma chave para desativá-la sem removê-la, inclusive as herdadas.

Criar uma skillCopiar link da seção

Abra Habilidades na barra lateral e use Nova habilidade. Os caminhos são:

• Criar manualmente: informe nome, descrição e o conteúdo do SKILL.md, e adicione arquivos se precisar.
• Importar de URL: cole o endereço de uma skill publicada no GitHub, no skills.sh ou no ClawHub.
• Importar localmente: escolha uma pasta com SKILL.md ou um arquivo .skill ou .zip.
• Copiar de ambiente: traga para o workspace uma skill instalada no seu runtime. O runtime precisa estar conectado. Skills do runtime ficam privadas até você copiá-las.

Pela CLI:

$jiraya skill create --name "revisao-de-codigo" --description "Checklist de revisão" --content-file ./SKILL.md

$jiraya skill import --url https://github.com/acme/skills/tree/main/revisao-de-codigo

Com --agent <agente>, create e import criam uma skill exclusiva daquele agente. Em import, --on-conflict define o que fazer se o nome já existir: fail (padrão), overwrite, rename ou skip.

Uma skill importada de URL pode ser baixada de novo com Atualizar a partir da origem ou jiraya skill refresh <id>. As edições locais são substituídas; as atribuições aos agentes, as etiquetas e o criador são mantidos.

Anexar a um agenteCopiar link da seção

Ao criar o agente, escolha as skills em Habilidades. Depois, use a aba Habilidades do agente ou a CLI:

$jiraya agent skills add <agent-id> --skill-ids <skill-id>,<skill-id>

jiraya agent skills set substitui a lista inteira, e jiraya agent skills list mostra o que está anexado.

Exportar e importar em loteCopiar link da seção

Para levar skills de um workspace para outro, selecione-as no catálogo Habilidades e use Exportar. O Jiraya gera um .zip com as skills, os arquivos de apoio e um manifesto (jiraya-export.yaml).

Para importar, use Importar no catálogo e escolha o .zip. A importação tem três passos:

1. Arquivo: o Jiraya lê o pacote e valida o manifesto.
2. Revisão: cada skill aparece como Pronta, Conflito (já existe uma com o mesmo nome) ou Inválida. Resolva os conflitos renomeando, ou desmarque as skills que não quer trazer.
3. Resultado: o resumo mostra quantas foram criadas e quantas falharam.

Limites de cada pacote: até 100 skills e 32 MB por arquivo. O SKILL.md e cada arquivo de apoio aceitam até 1 MB, com até 256 arquivos e 8 MB de arquivos de apoio por skill.

jiraya skill import --file pacote.zip também aceita um .zip ou .skill com uma única skill.

Quem pode editarCopiar link da seção

Qualquer membro cria e importa skills. Editar, atualizar e excluir uma skill cabe a quem a criou e aos proprietários e administradores do workspace. Uma skill exclusiva também pode ser gerenciada por quem gerencia o agente dela.

Comandos da CLICopiar link da seção