Separa la receta de quien cocina
Qué es
Una skill es un procedimiento reutilizable que guía a un agente en una tarea. En la analogía del video, el resultado es la panqueca, el agente es el cocinero y la skill es la receta. El archivo registra decisiones que no quieres explicar de nuevo en cada pedido.
Por qué aprender
Sin un procedimiento, el agente necesita completar vacíos: tamaño, formato, fuentes y criterios de calidad. Registrar esas decisiones reduce variaciones evitables. Esto no vuelve a la generación infalible: ingredientes diferentes y herramientas indisponibles todavía cambian el resultado.
Conceptos clave
Pedido suelto: “Haga mi informe.”
Pedido con contrato: “Transforme este CSV en un resumen
semanal, con totales por canal, período y pendientes.”
✓ Haz así
Nombra la entrada y muestra una salida aprobada.
✗ Evita este error
Prometer resultados idénticos solo porque existe un SKILL.md.
Practica antes de revelar
Elige una tarea que hayas repetido tres veces y describe la entrada y la salida en una frase.
Ver respuesta comentada
Ejemplo: “A partir de un CSV de ventas de la semana, producir un informe Markdown con totales por canal y preguntas para revisión.” Una tarea con fronteras permite probar la skill.
Diferencia prompt, skill, regla y herramienta
Qué es
Un prompt pide algo en esta interacción. Una skill guarda un procedimiento especializado. AGENTS.md registra orientaciones duraderas del proyecto. Una herramienta ejecuta una capacidad concreta, como leer un archivo o consultar un servicio. Estas piezas se complementan.
Por qué aprender
Cuando todo pasa a la regla global, los detalles de una tarea empiezan a influir en tareas sin relación. Cuando todo queda en el prompt, repites instrucciones. Separar los roles ayuda a encontrar el lugar correcto para cada corrección.
Conceptos clave
Prompt: “Haga el informe de septiembre.”
AGENTS.md: “La documentación de este proyecto está en portugués.”
Skill: “Valide datos, calcule, redacte y verifique.”
Herramienta: lector de CSV o script de cálculo.
Del concepto a la acción
- Pedido: identificar la condición inicial.
- Orientaciones: aplicar la decisión descrita.
- Procedimiento: comprobar el efecto en el ejemplo.
- Herramientas: registrar la evidencia de salida.
✓ Haz así
Pon la regla de cálculo junto del proceso que la usa.
✗ Evita este error
Trata MCP como sinónimo de skill o como acceso automático.
Practica antes de revelar
¿Dónde debe quedar la regla “no inventar números ausentes en el informe”?
Ver respuesta comentada
En el contrato de la skill de informe, con comportamiento para datos ausentes. Si es un requisito general del proyecto, también puede aparecer en la orientación del proyecto, sin duplicar versiones contradictorias.
Encuentra tareas que merecen una skill
Qué es
El mejor primer candidato es una tarea frecuente con una definición de “bien” que puedas mostrar. No tiene que ser compleja. Una descripción de video, una revisión de texto o un informe corto ya permiten aprender el ciclo completo.
Por qué aprender
Empezar por “gestionar mi negocio” mezcla planeación, escritura, cuentas y publicación. No puedes localizar el error. Una tarea más pequeña produce un artefacto evaluable y da feedback más rápido, antes de conectar sistemas importantes.
Conceptos clave
Candidato A: revisar un párrafo → fácil de comparar.
Candidato B: preparar informe local → números verificables.
Candidato C: operar toda la empresa → alcance demasiado amplio.
✓ Haz así
Empiece con una salida local que pueda revisarse.
✗ Evita este error
Conectar la primera versión directamente con envíos o cambios externos.
Practica antes de revelar
Compare dos de sus tareas usando frecuencia, claridad de salida y costo del error.
Ver respuesta comentada
Prefiera la que combina repetición, salida clara y revisión barata. Una tarea menos frecuente puede ganar si el reproceso es alto; justifique el criterio, en lugar de usar una puntuación sin contexto.
Dibuje el contrato de entrada y salida
Qué es
El contrato describe lo que debe llegar, qué se producirá y qué sucede cuando falta información. En nuestro laboratorio, el CSV contiene fecha, canal y valor. La salida trae período observado, total, totales por canal y pendientes.
Por qué aprender
Los datos faltantes no deben convertirse en suposiciones silenciosas. Si “valor” no existe, la skill no puede calcular el faturamiento. Una respuesta útil identifica el campo faltante, detiene solo la etapa dependiente y preserva el material original.
Conceptos clave
Entrada: UTF-8, columnas fecha,canal,valor.
Valor: decimal con punto; moneda BRL definida por el ejercicio.
Salida: relatorio.md + qa.json.
Sin columna obligatoria: informar el error y no generar informe.
✓ Haz así
Defina el formato de fecha y la unidad monetaria.
✗ Evita este error
Suma valores de monedas diferentes sin una regla explícita.
Practica antes de revelar
Agregue al contrato una condición de parada y una limitación.
Ver respuesta comentada
Deténgase si hay una fecha inválida; limite el análisis a totales descriptivos, sin inferir causas del cambio en las ventas. El contrato debe decir qué hacer, no solo enumerar prohibiciones.
Lea críticamente la promesa del video
Qué es
Los seis pasos son una propuesta práctica del autor: partir del resultado, delimitar tarea, calibrar libertad, verificar, comparar configuraciones e incorporar feedback. La expresión “mejor que 99%” es el título promocional de la referencia, no un resultado medido en este curso.
Por qué aprender
El video muestra salidas diferentes entre modelos en una tarea visual. Esto es un caso de estudio útil, pero no establece un ranking universal. Los tiempos observados en esa ejecución tampoco garantizan duración, precio o calidad en tu cuenta.
Conceptos clave
Hipótesis: “Una configuración más barata basta para resúmenes.”
Prueba: mismos casos, misma rúbrica, más de una ejecución.
Conclusión válida: “En esta muestra, pasó los criterios.”
Del concepto a la acción
- Relato del autor: identificar la condición inicial.
- Hipótesis: aplicar la decisión descrita.
- Prueba local: verificar el efecto en el ejemplo.
- Decisión limitada: registrar la evidencia de salida.
✓ Haz así
Identifique qué conclusiones dependen del contexto.
✗ Evita este error
Repetir porcentajes de calidad sin experimento.
Practica antes de revelar
Transforme “el modelo caro siempre es mejor” en una hipótesis verificable.
Ver respuesta comentada
“En nuestros casos de selección de imágenes, la configuración A tendrá menos imágenes fuera de contexto que B, usando el mismo criterio de evaluación.” Ahora existe una comparación delimitada.
Prepare su laboratorio de aprendizaje
Qué es
Trabajarás con datos sintéticos y archivos locales. Descarga el kit en la página inicial, abre la carpeta en Codex y mantén entrada, salida y evidencias separadas. El ejercicio no exige una API paga ni una cuenta conectada a CRM.
Por qué aprender
Separar carpetas hace posible rehacer una ejecución sin reemplazar el original. Con cada cambio, puedes comparar el informe anterior con el nuevo y verificar si la corrección trajo algún efecto no deseado.
Conceptos clave
laboratorio/
dados/vendas.csv
saidas/
evidencias/
.agents/skills/relatorio-semanal/SKILL.md
✓ Haz así
Guarde una copia de la entrada usada en cada comparación.
✗ Evita este error
Cambiar datos, modelo e instrucción al mismo tiempo.
Practica antes de revelar
Abra el CSV del kit y calcule manualmente el total de las cuatro líneas.
Ver respuesta comentada
Los valores 120,50 + 80,00 + 199,50 + 100,00 totalizan R$ 500,00. Esta cuenta independiente será una referencia para verificar el primer informe.
Verifique su comprensión
Una skill necesita acceder a un CRM. ¿Qué proporciona ese acceso?
¿Qué te llevas de este módulo?
Elija una tarea repetible y explique dónde entra la skill.
- Separe la receta de quien cocina.
- Diferencie prompt, skill, regla y herramienta.
- Encuentre tareas que merecen una skill.
- Dibuje el contrato de entrada y salida.
- Lea críticamente la promesa del video.
- Prepare su laboratorio de aprendizaje.
Próxima acción: guarde el ejercicio en su laboratorio y registre lo que todavía necesita revisión.