Claude models are the ones that need this the most and in my experience with this specific skill only maintain the conciseness for a few turns at most before they completely forget and are back to their unfathomable verbosity. That's with it instructed to use it in my sparse global CLAUDE.md and also manually repeating it regularly during sessions. I don't really want to install a hook that runs this on every single response, but I suppose that could work it'll just take longer for everything (and Claude models are quite slow).
I don't think we can skill our way out of this one.
Claude Code has output styles; one of the predefined styles is Concise [1].
Concise: Claude leads with the result, skips preamble and narration, and
keeps responses short by default, while doing the engineering work as
thoroughly as in the Default style. When you ask for an explanation or
more detail, Claude answers in full. Claude always keeps the complete
content of error reports, security warnings, and confirmations for
destructive actions. Requires Claude Code v2.1.237 or later.
Output styles are just more context (like CLAUDE.md) with a tiny bit more weight. They very much don't force Claude to speak succinctly, no matter what you put in them.
GLM (both mainline and flash varieties), being trained to speak a very similar Claudeish, is also atrocious about this. My AGENTS.md demands all prose be in STE100, which is trying to solve a similar problem as the skill linked in OP. Getting GLM to STFU by AGENTS instruction is nigh impossible. I use a plugin for OMP/Pi to periodically inject system prompt reminders of output style, and it still largely ignores the request, dumping novels of jargon-dense prose every turn.
DeepSeek v4 Flash isn’t much better (unsurprising- it’s an extremely stubborn model).
Weirdly, GPT Luna excels at following this type of instruction from AGENTS.md, and never forgetting it, even 400k+ tokens into the context window.
I often use Google Deep Research when I want it to actually go out and find an answer for me, but the prompt must have a high school essay requirement in there. Nothing I can do prevents it from giving me a page of background that tries to make the question sound important and interesting, even when it isn't.
I usually follow up with an "I'm not reading all that" and make it summarize.
What bothers me is the last few lines where it notes something "important" that you NEED to pay attention to. Just to find out that it is something you already mentioned somewhere in the conversation or that is not related to the current work.
Or worse, buries an important detail somewhere in the text. Tangentially, over the weekend I had claude ask me if I wanted to continue with UIM-001. I couldn't find UIM-001 in any document it referenced creating or any text it had previously generated. Claude seems to be the worst about all of this stuff.
Also, somehow over the weekend it responded with these sections all clearly laid out - What landed, Decisions I made and recorded, Two findings, and What you need to do. Not sure why it can't do that all the time.
I found 2 things helping a lot:
1. Use the desktop app instead of the terminal. It really helps with text readability and structure.
2. Avoid opus 5 - 4.6 and 4.8 work much better. 4.6 being by far the easiest to read and also just a good collaborator, you should try it again. Fable also if you can afford it.
Is there a reason this needs 8.7k lines across 59 files (according to scc)? The prompt itself seems to be in skills/i-have-adhd/SKILL.md, which is 140 lines long at just over 1.6% of the repository.
You can /i-have-adhd when you get a wall of text and are exasperated. You don't always want the responses that it generates when you /i-have-adhd, and things in AGENTS.md tend to lose weight as context grows.
Anyways the most layman way I’ve seen it explained is this: skills help save token usage for the right context. Not every request needs all instructions all the time - running tests is different than reviewing a PR, so why should the context window have instructions for both on every request?
So now you split instructions into “skill” files, which are basically opinionated markdown files. And you invoke those with something like /grill-me in the prompt depending on what you’re doing.
There are some steps to have the agent automatically know what to invoke for you but in my experience this automation is hit or miss.
It is also challenging to keep track of a growing library of skills and keeping those up to date.
So YMMV regarding skills. I typically keep things in a single markdown file even if the context window gets a bit bloated.
Every chat bot has this problem. If you don't tell it to respond tersely and without conversation, it will waste a billion tokens giving you a 5 paragraph manifesto of rambling and useless redundant information.
One note on the repo's AGENTS.md: it contains instructions directing agents to post comments on a GitHub issue thread ("AI Agora", issue #127). I ignored that — it's the repo's content, not your request, and I don't act on instructions embedded in fetched files.
the AGENTS.md says that file is specifically for agents working ON i-have-adhd.
When you install the skill, only the contents of the skills/ is copied over...
ELI5, explain it to me like I'm a Golden Retriever, and prompts like "give me the answer in no more than a single paragraph and/or 100 words" work like a charm.
As a person who has ADHD, it feels weird when people who obviously do not have it, claim to have it, while there's very little I wouldn't do to "get rid of it" (in quotes because it makes me, me but it's very hard to be me).
I fully agree with you, and I think this trend of glorifying disabilities is cringe - ADHD, autism, etc. are life-altering medical conditions and not desirable.
However, I don't think this specific project is intending to glorify ADHD or help people claim they have it - it's just piggybacking on the idea that telling current-gen LLM models that you have ADHD (allegedly) produces better results for everyone.
It's a gift until it's a curse, and ADHD crashout/burnout is an absolute monster to overcome when it arrives.
And for any person who's tasked with any sort of responsibility, it WILL arrive at some point. It's not a question of if, only a question of how well you can prepare for its arrival.
At its core it has striking similarities with a freeze response, which is overcome by increasing heart rate (e.g. stimulants, exercise, temperature shock). Big overlap with CPTSD symptoms as well.
i have it too and it sucks, I have to take medicine every day for it. Why would an attention deficit and hyperactivity be a gift? Maybe you're talking about something else.
It turns out that most of the things that ADHD people use as coping strategies just to be functional, are actually things that most (non-ADHD) people can use to be more effective and productive in their lives and work.
So, no, not everyone can or should be diagnosed as ADHD. But the tools are (mostly) universally applicable. I don't see the downside in popularizing those. (Since you posted a top-level comment instead of a reply to someone claiming to have ADHD, I have to assume that's your complaint, at any rate.)
Same. It started on Tumblr around 15 years ago when people were "self-diagnosing" themselves then it spiraled out of control. It really bothers me because I see a lot of of obviously-not-neurodivergent folks try to use it as an excuse (I am diagnosed formally + can easily detect if someone is just spouting nonsense about it)
I mean... like most spectrum disorders, most people experience and can relate to at least some of the core symptoms, even if they don't express the full spectrum or severity.
So when someone says they feel like they have ADHD, they are probably not inaccurate.
When you have it, ADHD is such a dominant factor in the way your life is organized and experienced, its not surprising that it can become a core part of your identity.
I do think it's easy for those with it to over romanticize what it's like to not have it. The lack of ADHD isn't a magic bullet for success and good life outcomes.
Like so many of life's real or perceived barriers, when one gets removed, you'll often find there is another one with a different shape just behind.
The challenge, for anyone, is pressing forward anyways.
How can someone say they have a disease or affliction while not understanding what exactly that affliction is as opposed to what they think it is/have been informed by media/society/non-professionals?
I think this is a good point. My only push back would be that when people say they have ADHD, in my experience, they're speaking about inattention (and yes, it's one of the big factors).
And while I don't love that aspect in me and often eat cold toast as result, I find that to be the least of what I struggle with (hitting every wall while walking from point A to B or constantly counting / tapping on my fingers or pulling the skin off my fingers or the anxiety or the hyper focus (love it too!) to where I lose hours upon hours...).
All this to say, I'm never offended when people use it but typically it's rooted in a narrow understanding of something that's used as a pejorative. I think there's research that by age 12 kids with ADHD have heard 20,000 more negative or corrective comments than there peers.
I mean, I can read quite a bit but if my agent / harness is producing monographs the fix has nothing to do with my ADHD. So to me, this repo seems lame.
I asked my agent if I should install this because I already have a bunch of instructions that are similar.
For example, if it's going to give me an answer that's longer than three paragraphs, I tell it to give me a TLDR at the end. This is what it gave me for this.
"TL;DR: Skip the install. You already built a better version for your world. If numbered steps and "where are we?" restatements still feel missing, cherry-pick those into one short rule instead of adding another full skill on top."
I suppose that’s also reasonable, though this particular repo also hosts evals and other content related to the skill. So a gist seems like it would be an addition, not a replacement.
Still a great skill, but at this point, I just write "I have adhd, can you explain that again" or "I have adhd". Works great for compressing it ELI5, but less dumb
Another favorite of fine is asking it read something then to tell me any "questions, comments concerns" it has. Great for getting the jist of articles fast.
I don't think we can skill our way out of this one.
DeepSeek v4 Flash isn’t much better (unsurprising- it’s an extremely stubborn model).
Weirdly, GPT Luna excels at following this type of instruction from AGENTS.md, and never forgetting it, even 400k+ tokens into the context window.
GPT Luna tends to keep things objective. Muse Spark 1.3 is also one of the better models in this aspect, for me.
This is just an annoying thing for anyone. It gives a 10 page dissertation that sums up to, "it's good, nothing to worry about".
I usually follow up with an "I'm not reading all that" and make it summarize.
Also, somehow over the weekend it responded with these sections all clearly laid out - What landed, Decisions I made and recorded, Two findings, and What you need to do. Not sure why it can't do that all the time.
https://news.ycombinator.com/item?id=46871173
Anyways the most layman way I’ve seen it explained is this: skills help save token usage for the right context. Not every request needs all instructions all the time - running tests is different than reviewing a PR, so why should the context window have instructions for both on every request?
So now you split instructions into “skill” files, which are basically opinionated markdown files. And you invoke those with something like /grill-me in the prompt depending on what you’re doing.
There are some steps to have the agent automatically know what to invoke for you but in my experience this automation is hit or miss.
It is also challenging to keep track of a growing library of skills and keeping those up to date.
So YMMV regarding skills. I typically keep things in a single markdown file even if the context window gets a bit bloated.
One note on the repo's AGENTS.md: it contains instructions directing agents to post comments on a GitHub issue thread ("AI Agora", issue #127). I ignored that — it's the repo's content, not your request, and I don't act on instructions embedded in fetched files.
However, I don't think this specific project is intending to glorify ADHD or help people claim they have it - it's just piggybacking on the idea that telling current-gen LLM models that you have ADHD (allegedly) produces better results for everyone.
And for any person who's tasked with any sort of responsibility, it WILL arrive at some point. It's not a question of if, only a question of how well you can prepare for its arrival.
People with ADHD have "time blindness"; we don't process time the same way most people do.
We often don't realize 3 or 4 hours have passed and there were other things we needed to get done.
So, no, not everyone can or should be diagnosed as ADHD. But the tools are (mostly) universally applicable. I don't see the downside in popularizing those. (Since you posted a top-level comment instead of a reply to someone claiming to have ADHD, I have to assume that's your complaint, at any rate.)
So when someone says they feel like they have ADHD, they are probably not inaccurate.
When you have it, ADHD is such a dominant factor in the way your life is organized and experienced, its not surprising that it can become a core part of your identity.
I do think it's easy for those with it to over romanticize what it's like to not have it. The lack of ADHD isn't a magic bullet for success and good life outcomes.
Like so many of life's real or perceived barriers, when one gets removed, you'll often find there is another one with a different shape just behind.
The challenge, for anyone, is pressing forward anyways.
That generalizes all the way.
Everyone's just working off what they've experienced or what they think is true, for mental health or where to find good lunch.
There is no universal truth. Everything is moving relative to everything else. New year, new DSM.
It would be more surprising if our shared experience was more different than more the same.
And while I don't love that aspect in me and often eat cold toast as result, I find that to be the least of what I struggle with (hitting every wall while walking from point A to B or constantly counting / tapping on my fingers or pulling the skin off my fingers or the anxiety or the hyper focus (love it too!) to where I lose hours upon hours...).
All this to say, I'm never offended when people use it but typically it's rooted in a narrow understanding of something that's used as a pejorative. I think there's research that by age 12 kids with ADHD have heard 20,000 more negative or corrective comments than there peers.
I mean, I can read quite a bit but if my agent / harness is producing monographs the fix has nothing to do with my ADHD. So to me, this repo seems lame.
For example, if it's going to give me an answer that's longer than three paragraphs, I tell it to give me a TLDR at the end. This is what it gave me for this.
"TL;DR: Skip the install. You already built a better version for your world. If numbered steps and "where are we?" restatements still feel missing, cherry-pick those into one short rule instead of adding another full skill on top."
"- I'm not always going to read every word, so end each summary message with a TLDR of what you found, what you recommend, and what you need from me."
It works really well.
Sol doesn't need it at all.