Tareas y skills
Una skill es un archivo SKILL.md: instrucciones en lenguaje natural que
sigue el agente, con un encabezado (frontmatter) en YAML. Las skills de una
organización viven en su Kadu Playbook, y corren también en la
terminal de quien las escribe (Desarrollo local).
Una skill se convierte en tarea cuando declara el bloque task: en el
frontmatter. Sin el bloque, es auxiliar: otras skills la llaman, pero no
aparece en la consola.
| Skill auxiliar | Tarea | |
|---|---|---|
| Frontmatter | name, description, user-invocable | los mismos, más el bloque task: |
| Quién la llama | otra skill, o una persona en Claude Code | la consola, una programación, la API o el endpoint de lanzamiento |
| Hay una persona respondiendo durante la ejecución | sí | no |
| Aparece en la consola | no | sí |
Identificador de la tarea
Toda tarea tiene un skill_slug con el formato <plugin>:<skill>: el nombre
del plugin (el workspace) y el nombre de la carpeta de la skill. Por ejemplo,
la skill finance/skills/task-baixar-pagamentos-via-boleto-pix/SKILL.md se
convierte en la tarea finance:task-baixar-pagamentos-via-boleto-pix.
El slug es la identidad de la tarea. Renombrar la carpeta de la skill crea
otra tarea, sin el historial de la anterior. Para cambiar el nombre
mostrado, cambia task.label.
Qué declara la tarea
El bloque task: define lo que muestra la consola y cómo corre la ejecución:
| Campo | Efecto |
|---|---|
label, description | Nombre de la tarea y texto de presentación en la consola. |
activity | La actividad en la que aparece la tarea. |
model | El nivel (tier) de la tarea: define el precio, el ejecutor y el modelo de IA. |
parameters_schema | Los parámetros aceptados en el lanzamiento, como JSON Schema. La consola arma el formulario a partir de él, y un parámetro inválido se rechaza antes de que empiece la ejecución. |
accepts_input_files, generates_output_files | Si la tarea recibe archivos en el lanzamiento y si publica archivos al final. |
required_secrets | Los secrets que recibe la ejecución. Solo los listados llegan a la ejecución. |
systems, features | Los sistemas que usa la tarea y lo que entrega, mostrados en la consola. |
schedules, endpoint, executor, metadata | Programaciones, lanzamiento por HTTP, override de modelo y metadatos libres. |
El formato completo, campo por campo, está en
El bloque task:.
Sin una persona al otro lado
Una ejecución de tarea es automática: nadie responde a una pregunta del agente. Cuando la skill encuentra una ambigüedad o una falla, registra un pendiente y sigue con el siguiente elemento. Los pendientes quedan en la consola para que una persona los resuelva después.