# i-have-adhd

> A Claude Code skill plugin that reformats AI responses to be ADHD-friendly: action-first, numbered steps, no preamble, no filler phrases.

i-have-adhd is an open-source Claude Code skill created by Ayoub Ghriss that changes how Claude structures its responses — leading with the answer, numbering steps, and cutting filler phrases like "Great question!" and "Hope this helps!" It installs as a plugin into Claude Code and is invoked with the `/i-have-adhd` slash command. The project has accumulated over 2,100 GitHub stars since its May 2026 creation, signaling strong community resonance among developers who find verbose AI output frustrating.

## What It Is

i-have-adhd is a Claude Code plugin (skill) that applies a set of 10 communication rules to Claude's output style. It does not change what Claude knows or can do — it changes how Claude presents information. The core idea is borrowed loosely from cognitive accessibility principles: put the most important thing first, make progress visible, and eliminate noise. No ADHD diagnosis is required to benefit from it.

## The 10 Rules It Enforces

The plugin installs a `SKILL.md` file that Claude Code reads and applies on every response after invocation. The rules are:

1. Lead with the next action
2. Number multi-step tasks
3. End with one concrete next step
4. Suppress tangents
5. Restate state every turn
6. Specific time estimates (minutes, not "a bit")
7. Make wins visible
8. Matter-of-fact errors
9. Cap lists at 5 items
10. No preamble, no recap, no closers

## Before and After

The README illustrates the change with a concrete example. Before the plugin, Claude might respond to a broken auth flow question with a paragraph of context-setting, a vague suggestion to update a package, and a closing "Hope this helps!" After the plugin, the same question gets: a direct `npm install` command, three numbered steps pointing to exact file lines, and a single conditional next step if tests fail. The difference is structural, not factual.

## Setup Path

Installation requires cloning the repository and adding it to Claude Code via the plugin marketplace CLI:

- `git clone https://github.com/ayghri/i-have-adhd ./i-have-adhd`
- `claude plugin marketplace add ./i-have-adhd`
- `claude plugin install i-have-adhd@i-have-adhd`

Once installed, invoke it with `/i-have-adhd` inside Claude Code. It can be disabled at any time with `claude plugin disable i-have-adhd` or the equivalent slash command. The behavior is fully customizable by editing `skills/i-have-adhd/SKILL.md` and re-invoking the command.

## Intellectual Lineage

The project credits *The Adult ADHD Tool Kit* by J. Russell Ramsay and Anthony L. Rostain as a loose inspiration, but explicitly notes it was adapted for how an LLM should respond — not how a human should organize their day. This framing positions it as a prompt-engineering artifact grounded in accessibility research rather than a novelty plugin.

## Features
- Action-first response formatting
- Numbered multi-step task output
- Suppresses tangents and filler phrases
- Concrete next-step endings
- Specific time estimates instead of vague language
- Caps lists at 5 items
- Matter-of-fact error reporting
- Fully customizable via SKILL.md
- Enable/disable via Claude Code slash commands
- MIT licensed and free to use

## Integrations
Claude Code

## Platforms
API, CLI

## Pricing
Open Source

## Links
- Website: https://github.com/ayghri/i-have-adhd
- Repository: https://github.com/ayghri/i-have-adhd
- EveryDev.ai: https://www.everydev.ai/tools/i-have-adhd