Tarefas e skills
Uma skill é um arquivo SKILL.md: instruções em linguagem natural que o
agente segue, com um cabeçalho (frontmatter) em YAML. As skills de uma
organização moram no Kadu Playbook dela, e rodam também no
terminal de quem as escreve (Desenvolvimento local).
Uma skill vira tarefa quando declara o bloco task: no frontmatter. Sem o
bloco, ela é auxiliar: outras skills a chamam, mas ela não aparece no
console.
| Skill auxiliar | Tarefa | |
|---|---|---|
| Frontmatter | name, description, user-invocable | os mesmos, mais o bloco task: |
| Quem chama | outra skill, ou uma pessoa no Claude Code | o console, um agendamento, a API ou o endpoint de disparo |
| Tem uma pessoa respondendo durante a execução | sim | não |
| Aparece no console | não | sim |
Identificador da tarefa
Toda tarefa tem um skill_slug no formato <plugin>:<skill>: o nome do plugin
(o workspace) e o nome da pasta da skill. Por exemplo, a skill
finance/skills/task-baixar-pagamentos-via-boleto-pix/SKILL.md vira a tarefa
finance:task-baixar-pagamentos-via-boleto-pix.
O slug é a identidade da tarefa. Renomear a pasta da skill cria outra
tarefa, sem o histórico da anterior. Para mudar o nome exibido, mude
task.label.
O que a tarefa declara
O bloco task: define o que o console mostra e como a execução roda:
| Campo | Efeito |
|---|---|
label, description | Nome da tarefa e texto de apresentação no console. |
activity | A atividade em que a tarefa aparece. |
model | O nível (tier) da tarefa: define o preço, o executor e o modelo de IA. |
parameters_schema | Os parâmetros aceitos no disparo, como JSON Schema. O console monta o formulário a partir dele, e parâmetro inválido é recusado antes de a execução começar. |
accepts_input_files, generates_output_files | Se a tarefa recebe arquivos no disparo e se publica arquivos no fim. |
required_secrets | Os secrets que a execução recebe. Só os listados chegam à execução. |
systems, features | Os sistemas que a tarefa usa e o que ela entrega, exibidos no console. |
schedules, endpoint, executor, metadata | Agendamentos, disparo por HTTP, override de modelo e metadados livres. |
O formato completo, campo a campo, está em
O bloco task:.
Sem pessoa do outro lado
Uma execução de tarefa é automática: ninguém responde a uma pergunta do agente. Quando a skill encontra uma ambiguidade ou uma falha, ela registra uma pendência e segue para o próximo item. As pendências ficam no console para uma pessoa resolver depois.