StackMap
Subscribe
Explore / i-have-adhd
ayghri

i-have-adhd

48k-star skill that stops coding agents burying the answer: lead with the next action, number steps, cap lists at 5, no preamble/recap/closers. ADHD-friendly, but it's for everyone.

48,008 2,797 Python MITupdated 3 days ago
skills
View on GitHubDispute this mapping →
Curator's take

Ten rules in one SKILL.md that make an agent answer like a good senior engineer over chat: action first, state restated each turn, one concrete next step at the end. Install it in every harness you use; the token savings are a side effect, the readability is the point. Not a coding-style skill (ponytail handles YAGNI code) and not a prose de-AI-ifier (humanizer) - it only shapes the agent's *reply structure*. If you rely on the agent's long explanations for learning, this will feel curt: fork and loosen rule 4/10. Trivially forkable; the whole thing is one markdown file.

Mapped by ShipWithAI editors · links verified

Continue your stack

What teams reach for next — and why each earns a place beside i-have-adhd. Ranked by curator confidence.

pairs wellpairs wellpairs wellpairs wellponytailhumanizern-skillscc-thinking-skillsi-have-adhd
pairs wellalternativebuilt withpick a node for the why · open it from the panel
Weekly digest
README.md2 min read

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!"

Kacper Rutkiewicz | AI Made Simple 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.

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. 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:

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.

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