ayghri

i-have-adhd: Make Coding Assistant Responses Easier to Scan

i-have-adhd is a skill for coding assistants that makes replies more direct and easier to act on. It suits people who prefer numbered steps, concise answers, and a clear next action without extra preamble or tangents.

Stars
53.2k
Forks
3.1k
Stars, last 10 days
+2,966

Our take

Health score

60/100

How it is scored
Activity
53
Community
63
Issues
73
Pull requests
49

+2,966 stars in the last 10 days

  • Merges more pull requests than 76% of the projects we track

Overview

i-have-adhd is a skill for coding assistants that shapes how they present answers. It addresses replies that bury the useful information in lengthy introductions, tangents, or vague instructions by emphasizing action-first, concise, structured output.

The project is aimed at people who find that style of communication easier to follow, whether or not they have an ADHD diagnosis. It changes response presentation rather than organizing a person's day or providing clinical guidance.

Key Features

  • Leads with the next action instead of a preamble.
  • Numbers steps for multi-step tasks.
  • Ends with one concrete next step.
  • Limits lists to five items and suppresses tangents.
  • Encourages specific time estimates and visible progress.
  • Uses matter-of-fact wording for errors.
  • Can be customized by editing the skill instructions.

Use Cases

  • A developer wants a coding assistant to give implementation steps before background explanation.
  • Someone debugging a failing test needs concise instructions and a specific follow-up action.
  • A user finds long responses hard to scan and wants shorter lists with fewer tangents.
  • A team or individual wants to adapt the response rules to their preferred communication style.

Getting Started

Ask your coding assistant to install the skill from the repository and follow its AGENTS.md instructions:

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

See the README and installation instructions for details.

Considerations

  • The repository describes the project as a skill/plugin for coding assistants, not a standalone application.
  • Installation instructions are directed at an assistant or CLI that supports the skill/plugin workflow; compatibility depends on that environment.
  • The rules affect response style, so they may not suit users who want extensive context or open-ended explanations.
  • The repository is MIT-licensed, and its instructions can be customized in the skill file.

Found this useful?

Share it with someone who would like i-have-adhd.