Construye una skill con un trabajo claro
Organice archivos, escriba metadatos y pruebe cuándo la skill debe entrar en acción.
Qué es
Una función como marketing se divide en procesos, y cada proceso en entregas menores. Producir un artículo a partir de un video es una entrega; administrar todo el marketing no lo es. Use el árbol del video como herramienta para encontrar las hojas que tienen un comienzo y un final.
Por qué aprender
Cuando una skill hace investigación, creación, publicación y análisis financiero, una falla se vuelve difícil de localizar. Separar responsabilidades permite probar cada parte y encadenarlas después, con entradas y salidas explícitas.
Conceptos clave
- Función: responsabilidad amplia.
- Proceso: secuencia de trabajo.
- Tarea: entrega delimitada.
- Composición: una salida alimenta otra tarea.
Qué es
El nombre correcto es SKILL.md, respetando la capitalización. Empieza con metadatos YAML entre líneas de tres guiones y continúa con instrucciones Markdown. Los campos name y description identifican la skill y su situación de uso.
Por qué aprender
Un error en el encabezado puede impedir el descubrimiento o perjudicar la selección. Mantenga el primer ejemplo mínimo y legible. Los campos extra vistos en otras herramientas no deben tratarse como obligatorios en Codex.
Conceptos clave
- name: identificador de la skill.
- description: cuándo usar y fronteras.
- Markdown: instrucciones ejecutables en lenguaje natural.
- Recursos opcionales: solo cuando hacen falta.
Qué es
Para este laboratorio, coloque la carpeta de la skill en .agents/skills dentro del proyecto. Las skills de usuario pueden quedar en ~/.agents/skills. El alcance del proyecto acompaña ese trabajo; el alcance de usuario pone el procedimiento a disposición en otros proyectos.
Por qué aprender
Una skill específica de un cliente puede causar confusión si se instala globalmente con un gatillo genérico. Evite copias independientes con el mismo nombre: con el tiempo, deja de saber qué versión se está ejecutando.
Conceptos clave
- Proyecto: procedimiento compartido con el repositorio.
- Usuario: reutilización personal.
- Ruta: ubicación concreta para inspeccionar.
- Duplicación: riesgo de versiones divergentes.
Qué es
La descripción debe responder cuándo usar la skill. Un gatillo explícito es pedirle a la skill por su nombre; uno implícito es describir una tarea compatible. En Codex CLI o extensión, la documentación presenta /skills y la mención con $ para selección explícita.
Por qué aprender
Frases amplias como “siempre que hable de un informe” capturan tareas de más. Pruebe pedidos que deberían activar y pedidos cercanos que no deberían. La ausencia de una prueba negativa oculta colisiones con otras skills.
Conceptos clave
- Positivo: caso que pertenece al alcance.
- Negativo: tarea parecida, pero distinta.
- Ambiguo: falta información para decidir.
- Explícito: ayuda a diagnosticar el descubrimiento.
Qué es
Deje en SKILL.md el camino principal y las condiciones para consultar material adicional. Una referencia puede guardar la rúbrica editorial; un script puede calcular valores. El agente no necesita cargar todos los ejemplos largos para descubrir el propósito de la skill.
Por qué aprender
Esta organización reduce la repetición y hace el mantenimiento más preciso. La descripción no debe convertirse en un manual entero. Al mismo tiempo, ocultar una regla esencial en un archivo que nunca se menciona impide que se aplique.
Conceptos clave
- SKILL.md: procedimiento y ruteo.
- references/: detalles consultados bajo condición.
- scripts/: operaciones verificables.
- assets/: modelos y archivos usados en la salida.
Qué es
Abra el proyecto en Codex, pida la tarea con el archivo de ejemplo y verifique qué procedimiento se usó. Si la skill no aparece, revise ruta, nombre, encabezado y descripción. La documentación recomienda reiniciar si una actualización no se detecta.
Por qué aprender
Hay diferencia entre no descubrir la skill y ejecutarla mal. Diagnosticar la fase evita reescribir todo el contenido por un archivo en el lugar incorrecto. Registre pedido, skill seleccionada y artefactos producidos.
Conceptos clave
- Descubrimiento: ¿aparece la skill?
- Ruteo: ¿se elige?
- Ejecución: ¿se siguen los pasos?
- Aceptación: ¿la salida cumple el contrato?