i-have-adhd: Streamline Your Coding Agent's Output for Clarity

Introduction

The i-have-adhd GitHub repository introduces a unique skill designed to optimize the output of your coding assistant, making it more direct and actionable. This tool aims to combat the common issue of AI agents providing verbose responses that can obscure the core solution or next steps. By implementing a set of specific rules, i-have-adhd ensures that your AI delivers information in a clear, concise, and "ADHD-friendly" manner, prioritizing immediate actions and eliminating unnecessary conversational elements.

Why Use It and Key Benefits

In the fast-paced world of development, clarity and efficiency are paramount. i-have-adhd addresses the frustration of sifting through lengthy AI responses to find the crucial piece of information. Its primary benefit is transforming how your coding assistant communicates, leading to faster comprehension and execution of tasks.

Key benefits include:

• Action-First Responses: The AI leads with the next immediate action required, saving time and mental effort.
• Numbered Multi-Step Tasks: Complex processes are broken down into easy-to-follow, numbered steps.
• Elimination of Fluff: Say goodbye to preambles, recaps, and generic closers like "Hope this helps!".
• Enhanced Productivity: By receiving direct, actionable instructions, developers can maintain focus and accelerate their workflow.

The skill operates based on 10 core rules, which include leading with the next action, numbering multi-step tasks, ending with one concrete next step, suppressing tangents, and making wins visible. These rules collectively ensure that every interaction with your coding assistant is productive and to the point.

Installation

To integrate i-have-adhd into your coding environment, follow these simple steps. This skill is designed to be easily added to compatible AI coding assistants.

Copy and paste the following command 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.

Alternatively, you can refer to the detailed installation instructions available in the repository: Check the installation instructions.

If you wish to tune or customize the skill, you can fork the repository, edit skills/i-have-adhd/SKILL.md, and then swap your copy in using these commands:

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

Remember to restart your coding assistant and re-invoke /i-have-adhd after making changes.

Examples

The difference i-have-adhd makes is best illustrated through a direct comparison of AI responses before and after its application.

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.

As shown, the "After" response is significantly more concise, action-oriented, and provides clear, numbered steps, directly guiding the user to the next task without any extraneous information.

Links

• GitHub Repository: https://github.com/ayghri/i-have-adhd
• License: MIT License