I Have ADHD Tutorial 2026: Build ADHD-Friendly AI Coding Agents with Claude
Learn how I Have ADHD structures Claude agent outputs for clarity and accessibility. A Python skill that prevents information overload in AI-driven development
What is I Have ADHD?
I Have ADHD is an open-source Python skill designed to improve how Claude-powered coding agents present information. Instead of burying critical answers deep in verbose responses, it restructures output to prioritize clarity, scanability, and actionable insights—making it far more useful for developers with ADHD, neurodivergent users, or anyone overwhelmed by wall-of-text AI responses.
What is I Have ADHD?
The project addresses a real friction point: AI agents can produce technically correct but practically unusable outputs. Long explanations, tangential details, and buried answers force developers to re-read and extract information manually. I Have ADHD applies a structured output framework that separates concerns and highlights what matters most.
Built for the Claude ecosystem (particularly useful with Claude's code plugin and agent features), this skill integrates directly into your AI development pipeline as a reusable prompt component or system instruction layer.
Key Features
- Structured output formatting: Organizes responses into clear sections (summary, details, code, action items) instead of narrative dumps
- Progressive disclosure: Shows critical information first; details and explanations follow only if needed
- Scannable format: Uses bullet points, headers, and whitespace to reduce cognitive load
- Python-native: Integrates seamlessly into Python-based AI agent stacks
- Claude-optimized: Designed specifically for Claude's capabilities and instruction-following strengths
- Open-source and lightweight: No heavy dependencies; easy to fork and customize
Getting Started
Installation
Clone the repository and explore its contents:
git clone https://github.com/ayghri/i-have-adhd.git
cd i-have-adhd
pip install -r requirements.txt
The project is minimal by design. Most of the value comes from the prompt templates and structural patterns rather than a heavy package installation.
Basic Setup
The core approach is to inject the ADHD-friendly formatting skill into your Claude API calls. Here's a practical starting point:
import anthropic
client = anthropic.Anthropic()
adhd_skill_prompt = """
You are an assistant that values clarity and accessibility.
Structure all responses as follows:
1. **TL;DR** - One sentence answer
2. **Key Points** - 3-5 bullet points
3. **Details** - Explanation (if needed)
4. **Code/Example** - If applicable
5. **Next Steps** - Actionable items
Use whitespace liberally. Prioritize scanability over prose.
"""
response = client.messages.create(
model="claude-3-5-sonnet-20241022",
max_tokens=1024,
system=adhd_skill_prompt,
messages=[
{"role": "user", "content": "How do I debug a Python async function?"}
]
)
print(response.content[0].text)
This simple pattern injects the skill as a system instruction. Claude's instruction-following ensures outputs respect the structure.
Integration with Claude Code Plugin
If you're using Claude with code-execution capabilities, the ADHD skill becomes even more powerful. It ensures generated code is accompanied by clear explanations and usage examples—not buried assumptions.
For agent-based workflows, add the skill to your base system prompt or create a reusable function wrapper that applies it to all agent responses.
When to Use It
Use Case 1: Rapid Code Generation and Debugging
You're using Claude as a pair programmer and need quick, actionable code suggestions. Instead of reading paragraphs about context and edge cases, you get the answer immediately, followed by optional explanation. Perfect for developers with ADHD who lose focus in dense text.
Use Case 2: AI-Powered Documentation Generation
Building a tool that auto-generates docs from code using Claude? The ADHD skill ensures generated documentation is organized, scannable, and user-friendly rather than an overwhelming wall of generated prose.
Use Case 3: Team Collaboration with Diverse Neurology
Working in a team where accessibility and clarity matter? The structured format benefits everyone: neurodivergent developers get reduced cognitive load, neurotypical developers get faster information processing, and all developers waste less time parsing AI output.
Who it's best for: AI developers integrating Claude into production systems, neurodivergent builders, teams prioritizing accessibility, anyone frustrated by verbose AI outputs.
Takeaway
I Have ADHD is a small but thoughtful project that solves a real problem: AI agents can be intelligent but unhelpful if their output format doesn't respect human cognitive limits. By treating clarity as a first-class feature rather than an afterthought, it makes Claude-powered agents more practical for real work. If your AI workflow generates frustration because answers are buried or details are overwhelming, this skill is worth integrating today.
Tags
Most Popular
- 1
- 2
- 3
- 4
- 5