¿Cómo así?: un skill en español para cuando la IA no se explica bien
Una instrucción breve para pedir contexto, lenguaje claro y una mejor explicación sin reiniciar la conversación.
A veces un agente de inteligencia artificial da una respuesta correcta que no se entiende. Puede usar demasiada jerga, omitir el contexto o saltar al detalle técnico antes de explicar el objetivo. Si la conversación continúa así, cada nuevo mensaje aumenta la confusión.
En Colombia solemos interrumpir ese momento con dos palabras: ¿cómo así?
Esa expresión dio origen a como-asi, un skill en español para pedirle al agente que explique de nuevo su último mensaje. Un skill es un archivo de instrucciones reutilizables que orienta el comportamiento de un agente. En este caso, no añade herramientas ni busca otra solución. Solo mejora la explicación anterior.
Qué problema resuelve
Cuando una respuesta no queda clara, el usuario suele escribir "no entendí" o "explícame mejor". El agente sabe que debe intentarlo de nuevo, pero todavía tiene que adivinar qué debe corregir.
como-asi elimina esa ambigüedad. Le pide al agente:
- recuperar el contexto mínimo que falta;
- explicar de nuevo el mismo mensaje;
- usar lenguaje claro;
- conservar los términos del proyecto.
La instrucción completa es breve:
No entendí en qué punto estamos. Explícalo de nuevo: dame el contexto mínimo que me falta, usa lenguaje claro conforme a la norma ISO 24495-1 y emplea el lenguaje ubicuo del proyecto. Si existe
CONTEXT.md, usa sus términos; si no existe, conserva la terminología de la conversación y no inventes vocabulario del proyecto.
El objetivo no es producir una explicación más larga. Es presentar mejor la información que el usuario necesita para recuperar el hilo.
wait, what?
El skill adapta wait-what, de Matt Pocock. El original permite detener una conversación y pedir que el agente repita su explicación con más contexto, inglés técnico simplificado y el vocabulario compartido del proyecto.1
La traducción literal de wait, what? sería "espera, ¿qué?". Sin embargo, "¿cómo así?" cumple mejor esa función en una conversación. La frase expresa que algo no quedó claro y pide una explicación sin exigir que el usuario formule una pregunta completa.
La adaptación también cambia la referencia técnica. wait-what menciona ASD-STE100, un lenguaje controlado para documentación técnica en inglés. como-asi usa ISO 24495-1, una norma internacional que puede aplicarse al español y a otros idiomas.2
Qué significa usar lenguaje claro
ISO 24495-1 establece cuatro principios. La información debe ser:
- pertinente para el lector;
- fácil de encontrar;
- fácil de comprender;
- fácil de usar.2
Lenguaje claro no significa lenguaje infantil. Tampoco exige eliminar los términos técnicos necesarios. Exige explicar el tema en un orden que permita al lector entenderlo y actuar.
Aplicado a una conversación con un agente, esto implica comenzar por el objetivo, definir los términos necesarios y separar las ideas. También implica omitir los detalles que todavía no ayudan a resolver la duda.
Por qué conserva los términos del proyecto
Una explicación puede ser sencilla y, aun así, causar problemas si cambia los nombres acordados. Si un equipo usa "caso" para un concepto específico, el agente no debería sustituirlo sin motivo por "ticket", "expediente" o "proceso". Cada palabra puede tener un significado distinto.
El "lenguaje ubicuo" es ese vocabulario compartido por las personas, el código y la documentación de un proyecto. como-asi le pide al agente consultar CONTEXT.md cuando exista. Si el archivo no existe, debe conservar los términos de la conversación en lugar de inventar otros.
El usuario conserva el control
El skill está configurado para uso explícito. El agente no debe activarlo por su cuenta, porque no puede saber si el usuario está confundido, en desacuerdo o simplemente quiere cambiar de tema.
El usuario decide cuándo detener la conversación:
/como-asiLos agentes que invocan skills mediante menciones pueden usar:
$como-asiDespués de la invocación, el agente debe volver a explicar su último mensaje. No debe iniciar una tarea diferente ni modificar el plan sin que el usuario lo pida.
Instalación
como-asi es público y se distribuye con licencia MIT. Puede revisarse en GitHub y en skills.sh.
La instalación se hace con este comando:
npx skills add oddradiocircle/como-asi@como-asiLa ficha de skills.sh muestra el contenido antes de instalarlo y registra las auditorías de seguridad disponibles para el skill.3
Una señal breve para reparar la conversación
como-asi no ejecuta programas, no instala dependencias y no modifica archivos. Su única función es mejorar una explicación que no cumplió su propósito.
Esa función parece pequeña, pero resuelve un problema frecuente. El usuario no debería necesitar conocimientos sobre diseño de instrucciones para decir que perdió el hilo. Puede escribir "¿cómo así?" y pedir tres cosas concretas: contexto, claridad y términos consistentes.
Cuando una conversación con una IA deja de tener sentido, eso puede ser suficiente para recuperarla.
Notas
Matt Pocock,
wait-what—SKILL.md.