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