Haz que tu IA sepa explicarse sin rollos

Le pides a tu agente que arregle un fallo de autenticación y te devuelve doce líneas de contexto, tres posibles causas, una reflexión sobre tus dependencias y un “¡Espero que te sirva!” final.

Lo lees entero.

Y cuando terminas de leer, sigues sin saber qué tecla tocar primero.

Ese es el problema que ataca i-have-adhd, una skill open source de ayghri que reordena la salida de tu agente de IA para que la primera línea sea algo que puedas hacer. No un resumen. No un plan. Un comando, una ruta de archivo o un fragmento de código.

Su lema lo deja claro: “ADHD-friendly outputs. No ADHD diagnosis needed!”. No hace falta tener un diagnóstico para que te venga bien. Hace falta haber perdido el hilo alguna vez leyendo una respuesta de IA a las siete de la tarde.

Señales de que tu agente te está haciendo perder el hilo:

• Terminas de leer la respuesta y vuelves arriba a buscar el comando
• La respuesta empieza por “Great question!” o “Let me take a look at…”
• Hay tres problemas mezclados y ninguno resuelto del todo
• El agente dice “esto llevará un poco de trabajo” y no sabes si son diez minutos o dos tardes
• Al cuarto mensaje ya no recuerdas en qué paso del plan estabais

El problema no es la longitud, es dónde queda enterrada la acción ¶

Son dos problemas distintos y se mezclan todo el rato.

Una es la verbosidad: el agente gasta tokens de más, tu ventana de contexto se llena antes y pagas por palabras que no necesitas. Ese frente ya lo hemos cubierto en Web Reactiva con Caveman, la skill que recorta hasta un 75% los tokens de salida y con el análisis del tokenmaxxing.

La otra es la forma: da igual que la respuesta tenga 80 palabras o 400 si la acción está en el párrafo cuarto, entre paréntesis y precedida de tres condicionales.

i-have-adhd va a por la segunda. No te promete ahorro de tokens ni compresión. Te promete que lo primero que leas sea lo primero que tienes que hacer.

El coste real no está en la factura de la API. Está en la fricción entre entender la solución y ejecutarla. La propia skill lo formula así: “Knowing the answer is not doing the answer”. Saber la respuesta no es haberla aplicado.

Los datos del sector apuntan al mismo sitio. La Stack Overflow Developer Survey 2025 recoge que el 84% de los programadores usa o planea usar herramientas de IA, pero la frustración número uno (66% de los encuestados) son las “soluciones de IA que casi están bien, pero no del todo”. Un 45% añade que depurar código generado por IA les lleva más tiempo del que esperaban.

Una respuesta que no puedes ejecutar sin releerla dos veces entra de lleno en esa categoría de “casi bien”.

Guía interactiva gratis

Antes de afinar cómo te habla el agente, elige bien cuál usas

El curso-juego de 17 paradas tiene una parada para elegir agente y presupuesto y otra dedicada a las skills, el prompt supervitaminado. Sales con una checklist a tu medida.

Entra en el curso gratis →

Cinco hechos sobre la lectura con TDAH que explican las diez reglas ¶

La skill no se inventa su criterio. Está basada, según sus propios créditos, en The Adult ADHD Tool Kit de J. Russell Ramsay y Anthony L. Rostain, adaptado a cómo debería responder un modelo de lenguaje en lugar de a cómo debería organizarse una persona.

De ahí salen cinco premisas que el fichero SKILL.md deja escritas antes de cualquier regla:

1. La memoria de trabajo es pequeña. Lo que no está en pantalla se olvida. Nada de “ten en cuenta X” mientras haces otra cosa.
2. Saber no es hacer. La fricción entre “lo he entendido” y “lo he hecho” es donde muere el trabajo.
3. Empezar es el paso más difícil. La primera acción tiene que ser obvia, pequeña y posible ahora mismo.
4. Las estimaciones de tiempo se perciben todas iguales. “Un poco de trabajo” y “unas horas” registran lo mismo. Lo vago no sirve.
5. La dopamina escasea. El progreso visible cuenta. Los logros enterrados en un párrafo no cuentan.

Lee esa lista otra vez pensando en ti un viernes a las seis de la tarde, con el contexto al 70% y tres pestañas abiertas. No hace falta ningún diagnóstico para reconocerse.

Según los CDC estadounidenses, alrededor del 6% de los adultos en Estados Unidos convive con TDAH, unos 15,5 millones de personas. La skill está pensada para ellos y funciona para el resto por el mismo motivo por el que las rampas de acceso las usa todo el mundo con una maleta.

🔑 El punto clave: esto no es una skill de accesibilidad para una minoría. Es una skill de ergonomía de la respuesta que una minoría necesita y el resto agradece.

Las diez reglas traducidas a lo que verás en tu terminal ¶

El SKILL.md define diez reglas. Estas son, con lo que cambia en la práctica.

La regla 10 es la que más se nota el primer día. La skill lista literalmente las aperturas prohibidas: “Great question”, “Let me…”, “I’ll…”, “Sure!”, “Looking at your…”, “To answer your question…”. Y los cierres prohibidos: “Let me know if you need anything else”, “Hope this helps”, “Feel free to ask”.

La regla 9 lleva un matiz que conviene leer entero. El tope de cinco elementos afecta solo a lo que se muestra, no a lo que el modelo analiza. El texto es explícito en que la regla no debe limitar el análisis, la búsqueda, los resultados de herramientas ni los candidatos generados. Recorta la presentación, no el razonamiento.

La regla 5 es la que más cambia las sesiones largas. Que el agente escriba “paso 3 de 5 hecho” en cada turno suena a ruido hasta que vuelves de comer y no tienes que reconstruir nada.

El antes y el después con un fallo de autenticación ¶

El README enseña el contraste con un caso concreto. Este es el antes, la respuesta típica de un agente sin la skill:

Great question! Let me think about this. Your auth flow has a few moving pieces: the middleware, the token verification, and the cookie handling. Looking at src/auth.ts, the verifyToken function (around lines 42-58) seems to be using an older jsonwebtoken API. One approach would be to update the package and rewrite that function. After making the change, you’d want to run the auth tests to confirm nothing breaks. By the way, you might also want to look at your dependency versions overall. Hope this helps!

Y este es el después:

Run npm install jsonwebtoken@latest, then edit src/auth.ts:42.

1. Open src/auth.ts
2. Replace verifyToken (lines 42–58) with the snippet below
3. Run npm test -- auth.spec.ts

Next: paste the first failing line if any test fails.

Fíjate en lo que ha desaparecido: el saludo, la enumeración de piezas móviles, el “una posible aproximación sería”, el apunte sobre las dependencias (que es la tangente de la regla 4) y la despedida.

Fíjate también en lo que no ha desaparecido: la ruta exacta, el número de línea, el comando de tests y qué hacer si fallan. La información técnica está entera. Lo que se ha ido es el envoltorio.

La última línea tampoco está ahí de adorno. “Next: paste the first failing line if any test fails” no es un cierre de cortesía, es una instrucción para ti. La regla 3 obliga al agente a dejarte siempre con una acción de menos de dos minutos sobre la mesa, aunque sea “abre el archivo”. Es la diferencia entre cerrar la terminal y seguir.

Instalación en Claude Code, Codex, OpenCode y Gemini CLI ¶

El repositorio documenta la instalación en más de una docena de entornos: Claude Code, Codex, Gemini CLI, GitHub Copilot, OpenCode, Cursor, Pi, OMP, Kimi Code, Qwen, Hermes, AstronClaw y Antigravity. La vía más rápida, si te da pereza leer, es pegarle esta frase a tu propio agente y dejar que lo resuelva él:

Install the i-have-adhd skill/plugin from https://github.com/ayghri/i-have-adhd, refer to the repo's AGENTS.md for instructions.

Para Claude Code son dos comandos:

claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

Después escribes /i-have-adhd y las reglas quedan activas para el resto de la sesión.

Para Codex, el marketplace necesita la referencia de rama:

codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

En Codex la invocación es $i-have-adhd y no se activa sola nunca.

Para OpenCode, el camino pasa por clonar y apuntar al plugin desde tu configuración:

git clone https://github.com/ayghri/i-have-adhd ~/.config/opencode/vendor/i-have-adhd

{ "plugin": ["/absolute/path/to/i-have-adhd/.opencode/plugins/i-have-adhd.mjs"] }

OpenCode lee la carpeta skills/ de forma nativa, así que la skill funciona incluso sin el plugin. Lo que añade el plugin es el comando /i-have-adhd y el modo siempre activo. Si trabajas a diario con este agente, en la guía de cómo usar OpenCode tienes el resto del mapa.

Para Gemini CLI hay dos rutas distintas y conviene elegir con criterio. La de comando es opt-in:

mkdir -p ~/.gemini/commands
curl -fsSL https://raw.githubusercontent.com/ayghri/i-have-adhd/main/skills/i-have-adhd/agents/gemini.toml \
  -o ~/.gemini/commands/i-have-adhd.toml

La de extensión (gemini extensions install https://github.com/ayghri/i-have-adhd) carga GEMINI.md y aplica las reglas desde el primer mensaje. Si no estás seguro, empieza por la de comando.

⚠️ En GitHub Copilot no hay conversión de por medio: lee el mismo SKILL.md desde .github/skills/, .claude/skills/ o ~/.copilot/skills/. Se instala con npx skills add ayghri/i-have-adhd -a github-copilot y respeta disable-model-invocation, así que no se activa hasta que la invocas.

El modo siempre activo se enciende creando un fichero vacío ¶

Esta es la parte que más me ha gustado del diseño, por lo poco ceremoniosa que es.

Instalar el plugin no cambia nada. Por defecto la skill lleva disable-model-invocation: true en su frontmatter, lo que significa que el modelo no puede decidir activarla por su cuenta. O la invocas tú, o no existe.

Si quieres que esté puesta desde el primer mensaje de cada sesión, en Claude Code creas un fichero vacío:

touch ~/.claude/.i-have-adhd-always

Un hook de SessionStart comprueba si ese fichero existe y, si está, carga el conjunto completo de reglas. Para volver al modo bajo demanda, lo borras:

rm ~/.claude/.i-have-adhd-always

El mismo patrón se repite en OpenCode (~/.config/opencode/.i-have-adhd-always) y en Pi (~/.pi/agent/.i-have-adhd-always). En Pi, además, la barra de estado muestra ● ADHD ON mientras el modo está activo, que es exactamente la clase de señal visible que pide la regla 7 aplicada a la propia herramienta.

En cualquier momento, escribir “stop adhd mode” o “normal mode” desactiva las reglas en la sesión actual. La skill confirma en una línea y vuelve a su estilo habitual.

Si prefieres no instalar nada, el INSTALL.md incluye un bloque de diez líneas listo para pegar en tu CLAUDE.md, tu AGENTS.md, tu ~/.gemini/GEMINI.md o tu .github/copilot-instructions.md. Es la versión condensada de las reglas y funciona en cualquier agente que lea un fichero de instrucciones. Si estás moviendo tus instrucciones de un formato a otro, el post sobre migrar de GitHub instructions a Agent Skills te ahorra unas cuantas vueltas.

De instalar skills a escribirlas

Diez reglas en un markdown que tu agente carga cuando hacen falta

Vas a ver cómo se escribe un SKILL.md que funciona en Claude Code, Copilot, OpenCode o Gemini CLI, con progressive disclosure para que no se coma tu contexto.

Abrir la guía →

Plantillas SKILL.md descargables incluidas

Las seis excepciones que impiden que la skill te deje sin respuesta ¶

El apartado When to break the rules define seis situaciones en las que el estilo cede:

1. Cuando pides una explicación. Si dices “explícame” o “guíame paso a paso”, el cuerpo se extiende lo que haga falta. Sigue sin haber preámbulo ni despedida, pero se añaden cabeceras para que puedas volver atrás y buscar.
2. Cuando viene una acción destructiva. Un rm -rf, un force push, una migración de esquema o borrar una tabla exigen confirmación previa. La seguridad gana a la brevedad.
3. Cuando llevas tres turnos con “sigue roto”. La skill obliga a parar de iterar sobre el código, nombrar la suposición que puede estar mal y hacer una pregunta de diagnóstico.
4. Cuando la petición es ambigua de verdad. Una pregunta corta antes que adivinar y reescribir.
5. Cuando la regla se come la respuesta. Si preguntas “qué opciones tengo”, la respuesta son de dos a cuatro opciones ordenadas con su contrapartida en una línea y la recomendación primero. Las opciones son la respuesta; no se pueden recortar a una.
6. Cuando la regla choca con el harness. Dentro de un agente, el prompt de sistema manda: si el entorno exige anunciar una llamada a herramienta, se anuncia. La forma se mantiene, la restricción gana.

Añade además una verificación previa al envío: borra la primera frase si anuncia lo que va a hacer, borra la última si pregunta “¿algo más?”, elimina los apartes tipo “por cierto” y quita los adverbios de cobertura que no aportan información. Con un matiz que no me esperaba. La duda se conserva cuando es real, porque borrarla fabrica una confianza que no existe.

Esa lista de excepciones es la diferencia entre una skill que puedes dejar puesta y una que tienes que apagar cada vez que necesitas pensar en voz alta con el agente.

Caveman comprime, i-have-adhd ordena ¶

Las dos skills atacan la salida del agente y se parecen lo justo para que merezca la pena separarlas.

Se pueden combinar, pero no lo recomiendo de entrada. Si aplicas las dos a la vez y algo te molesta en la salida, no vas a saber cuál de las dos ha sido. Prueba una semana con una, luego la otra.

Y si lo que buscas es criterio general para escribir tus propias reglas en lugar de instalar las de otro, tienes el catálogo de buenas prácticas para crear skills de agentes de IA.

Lo que esta skill no arregla ¶

Cuatro límites que conviene tener claros antes de instalarla.

No mejora el código. Solo toca la salida en lenguaje natural. Si tu agente propone una solución mala, te la va a proponer igual de mala en tres pasos numerados y con la ruta exacta del archivo. La forma no corrige el fondo.

No publica benchmarks. El repositorio incluye una carpeta tests/ y un script de evaluación (python3 scripts/run_evals.py validate), y el AGENTS.md pide indicar runtime, modelo, casos, ensayos y rúbrica en cambios de comportamiento. Pero en la documentación de usuario no hay una tabla de resultados que puedas contrastar. Lo que tienes es un criterio bien argumentado, no una medición.

La persistencia depende del entorno. La skill declara que sus reglas valen para toda la sesión y que, ante la duda de si siguen aplicando, siguen aplicando. En la práctica, una compactación de contexto o un reinicio se las puede llevar por delante. Por eso las integraciones de Pi y OpenCode reinyectan el conjunto de reglas: porque hace falta.

No sustituye a un diagnóstico ni a un tratamiento. El nombre es un gancho y el propio repositorio lo dice en la primera línea. Si el problema no es cómo te habla la IA sino cómo funciona tu atención en general, esto es una tirita bien puesta, no otra cosa.

💡 Si solo te llevas una cosa: prueba la skill una semana en los proyectos donde te bloqueas al empezar, no en los que ya dominas. Es ahí donde la regla 1 se nota.

Cómo adaptarla a tu forma de trabajar sin romperla ¶

Las diez reglas son un fichero Markdown. Puedes cambiarlas.

El camino que documenta el repositorio es hacer un fork, editar skills/i-have-adhd/SKILL.md y sustituir la copia del upstream por la tuya:

claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd
claude plugin marketplace add <tu-usuario>/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

El marketplace remove no es opcional: el fork y el original comparten nombre, así que hay que soltar el de arriba antes de enganchar el tuyo. Reinicia tu agente y vuelve a invocar /i-have-adhd.

Si tocas el fichero canónico, el AGENTS.md deja una regla de mantenimiento: hay un espejo en .cursor/skills/i-have-adhd/SKILL.md que hay que sincronizar. Cambias primero el canónico, sincronizas después.

¿Qué tocaría yo? Dos cosas. La regla 6, para que las estimaciones de tiempo apunten al agente cuando es el agente quien ejecuta (un agente estimando tus minutos es ruido). Y la regla 9, subiendo el tope de cinco elementos si trabajas con listados de rutas o de dependencias donde cinco se queda corto de forma sistemática.

La licencia es MIT, así que el fork no tiene letra pequeña.

TL;DR ¶

• 🎯 i-have-adhd reordena la respuesta de tu agente para que la primera línea sea una acción: comando, ruta o snippet
• 🧩 Son diez reglas en un SKILL.md con seis excepciones que evitan que la brevedad se coma la respuesta
• ⚙️ Instalación documentada en más de una docena de entornos, con disable-model-invocation: true por defecto
• 🔌 El modo siempre activo se enciende creando un fichero vacío (touch ~/.claude/.i-have-adhd-always) y se apaga borrándolo
• ⚖️ No ahorra tokens ni mejora el código: cambia el orden y la forma, no el fondo

Preguntas frecuentes sobre i-have-adhd ¶

¿Hace falta tener TDAH para usar esta skill? ¶

No. El propio repositorio lo dice en su lema: “No ADHD diagnosis needed”. Las reglas atacan un problema que sufre cualquiera que lea respuestas largas de IA al final del día: la acción queda enterrada y cuesta arrancar.

¿Cómo se instala i-have-adhd en Claude Code? ¶

Con dos comandos: claude plugin marketplace add ayghri/i-have-adhd y después claude plugin install i-have-adhd@i-have-adhd. Luego escribes /i-have-adhd en la sesión. Instalar el plugin por sí solo no cambia nada porque la skill no se autoinvoca.

¿En qué se diferencia de Caveman? ¶

Caveman comprime la salida para gastar menos tokens eliminando artículos y relleno. i-have-adhd no comprime: reordena. Pone la acción primero, numera los pasos y repite el estado. Una ataca la factura, la otra la ejecución.

¿Se puede dejar activada en todas las sesiones? ¶

Sí. En Claude Code creas el fichero ~/.claude/.i-have-adhd-always y un hook de SessionStart carga las reglas en cada arranque. OpenCode y Pi usan el mismo patrón con sus rutas. Para desactivarlo, borras el fichero.

¿Cómo se desactiva a mitad de conversación? ¶

Escribiendo “stop adhd mode” o “normal mode”. El agente lo confirma en una línea y vuelve a su estilo por defecto durante el resto de esa sesión.

¿Afecta a la calidad del código que genera el agente? ¶

No. Las reglas solo tocan la salida en lenguaje natural. El código, los comentarios y los detalles técnicos se mantienen. Lo que cambia es el orden en el que te los presenta y lo que se elimina alrededor.

¿Funciona en Cursor, Copilot o Gemini CLI? ¶

Sí. Copilot y Cursor leen el mismo SKILL.md sin conversión (npx skills add ayghri/i-have-adhd -a github-copilot). Gemini CLI tiene dos rutas: un comando personalizado opt-in o una extensión que aplica las reglas desde el primer mensaje.

¿Qué pasa si le pido una explicación larga? ¶

La primera excepción de la skill cubre justo eso: cuando pides “explícame” o “guíame”, el cuerpo se extiende lo que haga falta y se añaden cabeceras para que puedas volver atrás. Sigue sin haber preámbulo ni despedida.

¿Limita la cantidad de información que analiza el agente? ¶

No. La regla de cinco elementos por lista afecta solo a lo que se muestra, no al análisis, la búsqueda, los resultados de herramientas ni los candidatos que el modelo genera. El texto de la skill es explícito en ese punto.

¿Se puede modificar la lista de reglas? ¶

Sí, la licencia es MIT. Haces un fork, editas skills/i-have-adhd/SKILL.md, quitas el marketplace del upstream (comparten nombre) y añades el tuyo. Si tocas el fichero canónico, sincroniza el espejo de .cursor/skills/.

Fuentes ¶

• i-have-adhd en GitHub — repositorio oficial, README y créditos
• SKILL.md canónico — las diez reglas, las cinco premisas y las seis excepciones, en su texto original
• INSTALL.md — instalación por entorno y bloques de siempre activo
• AGENTS.md — mapa del repositorio, puntos de entrada por runtime y comandos de verificación
• Stack Overflow Developer Survey 2025 — adopción de IA y principales frustraciones
• CDC / MMWR, prevalencia de TDAH en adultos — datos de prevalencia en población adulta estadounidense

🧨 Última oprtunidad para recibir la dinamita que mereces sobre programación con IA el próximo domingo: Suscríbete gratis a Web Reactiva en https://webreactiva.com/newsletter