i-have-adhd README

The project's README from github.com/ayghri/i-have-adhd. As one markdown file: README.md.

i-have-adhd

ADHD-friendly outputs. No ADHD diagnosis needed!

License

🇬🇧 · 🇨🇳 · 🇧🇷 · 🇯🇵 · 🇻🇳 · 🇰🇷 · 🇹🇭

Install

Copy/paste into your CLI prompt:

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.

What it does

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

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.

After

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.

The rules

10 rules. Full text in 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. Rank and group long lists; aim for at most five items per group without omitting relevant items.
  10. No preamble. No recap. No closers.

Tune it

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

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 Claude Code, 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.

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

i-have-adhd (ayghri/i-have-adhd)

claude-skills
Searching Database…

What is this?A skill for coding agents (like Claude Code) that stops them from burying the answer in rambling explanations. It forces action-first, numbered, concrete responses instead of hedging filler like 'Hope this helps!'.
Is this a standalone app or something I add to my coding assistant?It is a skill file (SKILL.md) distributed as a Claude Code plugin, not a separate application. You add it to your existing coding agent to change how it responds.
Do I need to be diagnosed with ADHD to use this?No. The skill reformats any coding agent's output to be action-first and concise; no diagnosis or special setup is required.
Can I tweak the rules it enforces?Yes, fork the repo, edit skills/i-have-adhd/SKILL.md with your own rules, swap it in, restart Claude Code, and re-invoke /i-have-adhd.
What are the 10 rules it enforces on the agent?Lead with the next action, number multi-step tasks, end with one concrete next step, suppress tangents, restate state every turn, give specific time estimates, make wins visible, state errors matter-of-factly, rank/group long lists (max ~5 items per group), and skip preamble, recap, and closers.
What inspired this skill?It is loosely based on 'The Adult ADHD Tool Kit' by J. Russell Ramsay and Anthony L. Rostain, adapted for how an LLM should respond rather than how a human should organize their day.
What does a response look like before and after applying this skill?Before, the agent gives a rambling explanation ending in 'Hope this helps!'. After, it gives a direct command, numbered steps, and one concrete next action with no filler.
Creator
ayghri
Size
0.4 MB
Stars
57.6K
Updated
CommitOct 11
Age
5mo
Commits · 90 Days