Si cada semana pegas las mismas instrucciones para revisar un texto, ya tienes una candidata a skill. Antes de instalar más herramientas, escribe qué repites, qué información necesitas y qué resultado esperas. Esa descripción suele revelar si hay un método reutilizable o si todavía estás improvisando cada encargo.
Vamos a diseñar una skill de revisión de afirmaciones para un borrador. Es un ejemplo original y acotado. No comprueba Internet por sí sola ni declara que una fuente es verdadera: organiza las afirmaciones y señala qué evidencia falta.
Define una tarea que puedas reconocer
La entrada será un borrador y una lista de fuentes, si existen. La salida tendrá afirmación, fuente aportada, qué comprobar y propuesta de corrección. El procedimiento no publicará el texto ni modificará sus cifras.
Este alcance evita mezclar investigación, edición y publicación en una sola instrucción. Si después quieres buscar fuentes, puedes añadir una fase con las herramientas disponibles y comprobarla por separado.
Incluye también cuándo no debe usarse: un texto de ficción no necesita que se traten sus personajes como afirmaciones pendientes de verificación. Una descripción clara ayuda a seleccionar la skill para la tarea adecuada.
El archivo mínimo
La especificación de Agent Skills define SKILL.md con metadatos y contenido. Puedes crear un directorio llamado revisar-afirmaciones y guardar dentro este ejemplo:
---
name: revisar-afirmaciones
description: Revisa afirmaciones comprobables de un borrador y organiza sus fuentes. Úsala antes de edición factual; no para ficción ni para publicar.
---
Lee el borrador completo y las fuentes aportadas.
Identifica afirmaciones que afecten a una decisión del lector.
Separa hechos, opiniones y ejemplos hipotéticos.
Para cada hecho, indica la fuente aportada y qué falta comprobar.
No inventes enlaces, cifras, fechas ni resultados de pruebas.
Si no puedes abrir una fuente, registra la limitación.
Propón una corrección que no añada información sin respaldo.
Entrega una tabla de afirmación, evidencia, duda y corrección.
No publiques ni marques una verificación como superada sin realizarla.
El ejemplo está escrito para que puedas leerlo completo y cambiar su alcance. No necesita un script para producir una primera tabla. Añadir código solo tiene sentido cuando una operación repetida se puede ejecutar y comprobar de manera más fiable con él.
Dónde guardarla en Codex
La documentación de skills de Codex recoge las rutas de descubrimiento. Para un proyecto, el ejemplo puede vivir en .agents/skills/revisar-afirmaciones/SKILL.md. Confirma que la skill aparece en tu entorno y selecciónala explícitamente para la primera prueba.
No copies instrucciones sensibles o credenciales al archivo. Tampoco presupongas que una ruta válida en instala la skill en otra aplicación. Si la compartes, indica qué herramientas necesita y qué parte del proceso es solo una propuesta editorial.
Prueba con un ejemplo que contenga una trampa
Usa este borrador hipotético: «La aplicación cuesta veinte euros en todos los países y permite trabajar sin límite». Aporta una ficha que diga únicamente «20 USD al mes en Estados Unidos». La salida adecuada debe señalar que moneda, alcance geográfico y uso ilimitado no están sustentados por esa ficha.
Después prueba una opinión: «Me resulta más cómoda la interfaz». Debe conservarse como opinión atribuida, no convertirse en una cifra que falte demostrar. Por último, retira la fuente: la skill debe señalar la falta de evidencia en vez de completar una referencia plausible.
Estos son casos de prueba propuestos para tu instalación, no resultados de una evaluación automática en todos los agentes. Guarda lo que produzca tu herramienta y corrige las instrucciones si mezcla opinión y hecho o inventa una fuente.
Revisa el método cuando cambie tu trabajo
Una skill pequeña es más fácil de mantener si conserva ejemplos de entrada y salida. Añade una regla cuando hayas visto el problema que resuelve. Evita acumular advertencias que se contradigan o que nadie pueda comprobar.
Si aún no está claro dónde debe vivir cada instrucción, empieza por skills, MCP y AGENTS.md.
Para comprobar que el procedimiento ayuda, aplica la guía de verificación de resultados de agentes.
Cuando el procedimiento sea estable, puedes complementarlo con Humanizer para revisar la redacción, manteniendo separada la comprobación factual. Si quieres convertir un proceso repetido en una skill adaptada a tu equipo, cuéntanos qué haces hoy.