ayghri · Trending

ayghri/i-have-adhd

A skill to stop your coding agent from burying the answer. ADHD-friendly output.

57kstars 3.3kforks 49contributors Python

README.md

<img src="./logo.png" alt="i-have-adhd" width="140" />


 ADHD-friendly outputs. No ADHD diagnosis needed!


 <a href="LICENSE"><img src="https://img.shields.io/github/license/ayghri/i-have-adhd?style=flat" alt="License"></a>

🇬🇧 ·
 <a href=".github/readme/README.zh-CN.md" title="简体中文" aria-label="简体中文">🇨🇳</a> ·
 <a href=".github/readme/README.es.md" title="Español" aria-label="Español">🇪🇸</a> ·
 <a href=".github/readme/README.pt-BR.md" title="Português (Brasil)" aria-label="Português (Brasil)">🇧🇷</a> ·
 <a href=".github/readme/README.ja.md" title="日本語" aria-label="日本語">🇯🇵</a> ·
 <a href=".github/readme/README.vi.md" title="Tiếng Việt" aria-label="Tiếng Việt">🇻🇳</a> ·
 <a href=".github/readme/README.ko.md" title="한국어" aria-label="한국어">🇰🇷</a> ·
 <a href=".github/readme/README.fa.md" title="فارسی" aria-label="فارسی">🇮🇷</a> ·
 <a href=".github/readme/README.th.md" title="ภาษาไทย" aria-label="ภาษาไทย">🇹🇭</a> ·
 <a href=".github/readme/README.ar.md" title="العربية" aria-label="العربية">🇸🇦</a> ·
 <a href=".github/readme/README.fr.md" title="Français" aria-label="Français">🇫🇷</a>

## Install

Copy/paste into your CLI prompt:

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

Or 🔗 [check the installation instructions](INSTALL.md).

## What it does

A skill for your coding assistant that stops it from burying the answer. Action first. Steps numbered. No "Hope this helps!"

[Kacper Rutkiewicz | AI Made Simple](https://youtu.be/NEl8kPWZP_Y) has made a good breakdown of an earlier version of the skill.
## What changes

## Before

> 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! Let me know if you want to dig deeper.

</td>

## After

> Edit `src/auth.ts:42` to update the token validation.
>
> 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.

</td>
</tr>
</table>

## The rules

10 rules. Full text in [SKILL.md](./skills/i-have-adhd/SKILL.md).

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 to 5 items.
10. No preamble. No recap. No closers.

## Tune it

Fork, edit `skills/i-have-adhd/SKILL.md`, then swap your copy in:

```bash
claude plugin uninstall i-have-adhd # drop the upstream copy first:
claude plugin marketplace remove i-have-adhd # fork and upstream share both names
claude plugin marketplace add <your-username>/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd
```

Restart your coding assistant, then re-invoke `/i-have-adhd`.

## Credits

Loosely based on *The Adult ADHD Tool Kit* by J. Russell Ramsay and Anthony L. Rostain. Adapted for how an LLM should respond, not how a human should organize their day.

## License

[MIT](LICENSE).

Star ⭐ if it saved you one scroll past one "Great question!"

Repository info

Default branch: main
Latest version: —
Created: 2026-05-14
Last activity: 2026-10-11
License: MIT
Open issues: 66
Watchers: 167

Topics

adhd claude- claude-code-plugin claude-skills developer-tools productivity

Contributors

ayghri

144 contributions

thejesh23

15 contributions

SillyDark

8 contributions

commie70

6 contributions

Benziza

5 contributions