adhd

Your AI writes five paragraphs. You read zero. 🧠

This skill makes every Claude Code answer read like a tweet on X: action first, every character counts.

English · Español

---

English

I retained nothing

I stopped reading my own agents. Every answer opened with "You're right!" and five generic paragraphs. I read zero of it. Retained less.

The fleet made it worse: Claude Code and Codex daily at max on an M5 Mac, a Windows box, and a Linux server, all self-hosted. 10+ Hermes agents, remote sessions on top, multiple projects, my own apps. All of it talking. None of it landing.

So I wrote one skill and shared it across every workflow I run. Now every answer, everywhere, fits in my head and stays there.

Before / after

Two examples, directly on this page. Same task, skill off vs on.

Coding — missing API_KEY

Prompt: "My Node app crashes on startup with 'Error: Missing API_KEY'. What's going on?"

Before — 1,379 chars, ~60s read That error means your code reads process.env.API_KEY (or similar) at startup and throws when it's undefined — the environment variable isn't set wherever you're running the app. Common causes and fixes: No .env file / not loaded — if you're using a package like dotenv, make sure a .env file exists in your project root… …and three more numbered causes.

After — action first, ~12s read API_KEY env var isn't set. Fix: Find where it's read: grep -rn API_KEY --include=*.js . Add it to .env (or your shell env): API_KEY=your_key_here If using .env, confirm dotenv (or similar) is loaded before that check runs 1/1 done: startup has the key it needs. Next: restart the app.

Research / report — decide what to do next

Prompt: "10 customer interviews: SSO came up in 3/10, all enterprise. Onboarding and reporting came up in 7/10. Should we build SSO now?"

Before — the report dump The interviews reveal a number of themes around security, onboarding, procurement, pricing, integrations, and reporting. SSO came up repeatedly, although its importance varied by customer segment. A more comprehensive analysis follows…

After — evidence → decision → action Decision: do not build SSO this sprint. Evidence: 3/10 asked for it; all three are enterprise prospects. Onboarding and reporting appeared in 7/10. Keep SSO as an enterprise requirement, not the next build. Ship onboarding friction fixes first. Recheck after five more enterprise interviews. State: decision made; next research checkpoint: 5 interviews.

Install — 30 seconds

Any agent (Claude Code, Cursor, Codex, Cline, Windsurf, ~50 more):

npx skills add jjdmev2/adhd

Or as a Claude Code plugin — its forced output style applies this format to every main response while enabled. You can also invoke the skill manually with /adhd:adhd:

git clone https://github.com/jjdmev2/adhd ./adhd
claude plugin marketplace add ./adhd
claude plugin install adhd@adhd

Pick one path, not both. Claude.ai web: Settings → Capabilities → Skills → upload skills/adhd/SKILL.md.

For Codex, install with npx skills add above, then add this to your global ~/.codex/AGENTS.md so it is the default for every task:

Always invoke and apply $adhd to every user-facing response unless the prompt starts with "ADHD off for this answer:". Preserve correctness, safety, and requested depth over brevity.

Wary of prompt plugins? The core skill and Claude Code output style are plain Markdown. No code, no dependencies.

The rules

1. Tweet first — whole answer in ~280 chars when it fits.
2. Action before context — line one is something you can run.
3. Steps get numbers.
4. One topic per answer — extras go to the thread 🧵.
5. State every turn — "3/5 done, next: backfill."

Five more (drama-free errors, real time estimates, no "Hope this helps!") in SKILL.md.

Why not just tell it "be brief"?

"Be brief" in a prompt	Decays — three turns later the paragraphs are back.
A concise output mode	Shortens the same structure.
adhd	Restructures: action first, numbered steps, state every turn.

Concise mode shortens the answer. adhd rebuilds it for a brain that reads timelines, not documents.

Off / update / tune

• One answer only: ADHD off for this answer: explain the full trade-offs
• Persistent Claude Code off: claude plugin disable adhd
• Update: cd ./adhd && git pull
• Tune: edit SKILL.md, then invoke /adhd:adhd

Turn it off for: deep-dive learning, postmortems, anything where you want every caveat. Test: if you'd read the five paragraphs, disable it. If you'd skim them, keep it on.

Got a real before/after? Post it — best pairs get quoted above, credited.

---

Español

Tu IA escribe cinco párrafos. Tú lees cero. Este skill hace que cada respuesta se lea como un tweet en X: acción primero, cada carácter cuenta.

No retenía nada

Dejé de leer a mis propios agentes. Cada respuesta abría con "¡Tienes razón!" y cinco párrafos genéricos. Leía cero. Retenía menos.

La flota lo empeoró: Claude Code y Codex al máximo, todos los días, en una Mac M5, una PC con Windows y un servidor Linux, todo self-hosted. Más de 10 agentes Hermes, sesiones remotas encima, varios proyectos, mis propias apps. Todo hablaba. Nada me quedaba.

Así que escribí un solo skill y lo compartí en todos mis workflows. Ahora cada respuesta, en todas partes, me cabe en la cabeza y se queda ahí.

Antes / después

Dos ejemplos, visibles aquí mismo. Misma tarea, skill apagado vs. encendido.

Código — falta API_KEY

Pregunta: "Mi app de Node falla al iniciar con 'Error: Missing API_KEY'. ¿Qué pasa?"

Sin el skill	Con el skill
Antes — 1.379 caracteres, ~60 s Explica que la variable no está definida, enumera causas posibles y sigue con varios párrafos.	Después — acción primero, ~12 s API_KEY no está definida. 1. Encuentra dónde se lee. 2. Agrégala a .env. 3. Carga dotenv antes de validarla. Estado: 1/1 listo; reinicia la app.

Investigación / reporte — decidir qué sigue

Pregunta: "10 entrevistas: SSO apareció en 3/10, todos enterprise. Onboarding y reportes aparecieron en 7/10. ¿Construimos SSO ahora?"

Sin el skill	Con el skill
Antes — el reporte largo Resume seguridad, onboarding, compras, precios, integraciones y reportes. SSO aparece varias veces, con importancia distinta según el segmento.	Después — evidencia → decisión → acción Decisión: no construir SSO este sprint. Evidencia: 3/10 lo pidieron; los tres son prospectos enterprise. Onboarding y reportes aparecieron en 7/10. 1. Dejar SSO como requisito enterprise. 2. Arreglar onboarding primero. 3. Revisar tras cinco entrevistas enterprise más. Estado: decisión tomada; próximo corte: 5 entrevistas.

Instalar — 30 segundos

Cualquier agente (Claude Code, Cursor, Codex, Cline, Windsurf, ~50 más):

npx skills add jjdmev2/adhd

O como plugin de Claude Code — su estilo de salida forzado aplica este formato a cada respuesta principal mientras esté activo. También puedes invocarlo a mano con /adhd:adhd:

git clone https://github.com/jjdmev2/adhd ./adhd
claude plugin marketplace add ./adhd
claude plugin install adhd@adhd

Elige un camino, no ambos. Claude.ai web: Settings → Capabilities → Skills → sube skills/adhd/SKILL.md.

Para Codex, instala con npx skills add arriba y agrega esto a tu ~/.codex/AGENTS.md global para que sea el formato por defecto en cada tarea:

Always invoke and apply $adhd to every user-facing response unless the prompt starts with "ADHD off for this answer:". Preserve correctness, safety, and requested depth over brevity.

¿Desconfías de los plugins de prompts? El skill principal y el estilo de salida de Claude Code son Markdown plano. Sin código, sin dependencias.

Las reglas

1. Tweet primero — la respuesta completa en ~280 caracteres cuando cabe.
2. Acción antes que contexto — la primera línea es algo que puedes ejecutar.
3. Los pasos van numerados.
4. Un tema por respuesta — lo demás va al hilo 🧵.
5. Estado en cada turno — "3/5 listo, sigue: backfill."

Cinco más en SKILL.md (en inglés — el skill le habla al modelo).

¿Por qué no basta con "sé breve"?

"Sé breve" en un prompt decae: tres turnos después vuelven los párrafos. Un modo conciso acorta la misma estructura. adhd la reconstruye: acción primero, pasos numerados, estado en cada turno.

Apagar / actualizar / ajustar

• Solo una respuesta: ADHD off for this answer: explica todos los trade-offs
• Apagar Claude Code de forma persistente: claude plugin disable adhd
• Actualizar: cd ./adhd && git pull
• Ajustar: edita SKILL.md, vuelve a correr /adhd:adhd

Apágalo para: aprendizaje a fondo, postmortems, cualquier cosa donde quieras cada detalle. Prueba: si leerías los cinco párrafos, apágalo. Si los saltearías, déjalo encendido.

¿Tienes un antes/después real? Publícalo — los mejores se citan arriba, con crédito.

---

A dME Inc. · MIT