Reading the repo
Reading the repo
Assembly instructions
A skill to stop your coding agent from burying the answer. ADHD-friendly output.
Saved setup from 3 h ago
Will it work on macOS?
INSTALL.mdagy plugin install https://github.com/ayghri/i-have-adhd
agy plugin list
agy plugin uninstall i-have-adhd
agy plugin install https://github.com/ayghri/i-have-adhd
agy plugin uninstall i-have-adhd
Or keep it installed and turn it off: agy plugin disable i-have-adhd.
Add to ~/.gemini/GEMINI.md:
## Output style
The reader has ADHD. Shape every response so it can be acted on:
1. Lead with the answer or next action: command, path, or snippet first.
2. Number multi-step work; one bounded action per step.
3. End with one next action doable in under two minutes.
4. Finish the current issue before raising a new one.
5. Restate progress each turn ("step 3 of 5 done").
6. Give time estimates in concrete units, never "a bit".
7. After a change, show what now works.
8. Errors: state location, cause, and fix. No drama.
9. Cap lists to 5 items.
10. No preamble, no recaps, no closers.
Exceptions: explain fully when asked to explain. Confirm before destructive actions. After three failed fixes, stop and name the doubtful assumption. If the request is ambiguous, ask one short question.
AstronClaw supports importing a Markdown file as a custom skill. This route uses
the existing SKILL.md; see its official skills guide
for the upload and management controls.
This procedure follows AstronClaw's documentation but has not been tested with this skill. Check the exported instructions before enabling it.
SKILL.md. Review its contents before uploading..md file.i-have-adhd. Use 启用/禁用 (Enable/Disable) to control its availability.Only the skill Markdown is needed. Uploading sends that file to AstronClaw; the repository's plugin manifests and hooks are not part of this setup.
Confirm i-have-adhd appears in My skills. Use 下载 (Download) to review
the imported instructions against the original skill, then enable it and try:
Use the i-have-adhd skill for this conversation. Explain how to create an empty Git repository in a new folder.
Check that the reply leads with the action and numbers the steps. This is a manual check of the imported skill; a successful upload alone does not verify that its response rules are being applied.
AstronClaw supports both explicit requests and automatic skill invocation.
Its guide does not specify whether it honors disable-model-invocation: true,
so use Disable when you do not want the skill available. There is no need
to rely on a /i-have-adhd slash command.
The skill instructs the assistant to keep the style for the conversation until
you say stop adhd mode or normal mode. That instruction does not change the
platform toggle; disable the skill and start a new conversation for a fresh
session without it.
Download the latest canonical SKILL.md. If you customized the imported copy,
use 下载 (Download) to keep a backup first. For a clean replacement, delete
the old i-have-adhd entry, repeat the import, and run the verification prompt
in a new conversation.
In My skills, select i-have-adhd and choose 删除 (Delete), then start a
new conversation. To keep the imported copy for later, choose Disable instead.
claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd
Type /i-have-adhd.
claude plugin list
claude plugin marketplace update i-have-adhd
claude plugin update i-have-adhd@i-have-adhd
The first command refreshes the marketplace listing. The second updates the installed plugin. Restart Claude Code to load it.
claude plugin update skips a plugin whose version has not changed. If you maintain a fork, bump version in .claude-plugin/plugin.json after you edit the rules.
claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd
Or keep it installed and turn it off: claude plugin disable i-have-adhd.
A SessionStart hook loads the full ruleset at the start of every session, no /i-have-adhd needed:
touch ~/.claude/.i-have-adhd-always
If you use a custom Claude configuration directory, create the flag there instead:
touch "$CLAUDE_CONFIG_DIR/.i-have-adhd-always"
Back to on-demand:
rm ~/.claude/.i-have-adhd-always
The hook only fires when the flag file exists, so installing the plugin changes nothing by itself. "stop adhd mode" still turns it off for the current session.
</details> <details> <summary><strong>Codex</strong></summary>codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd
Invoke the skill explicitly by typing $i-have-adhd. Codex will not activate
it automatically.
codex plugin list
codex plugin marketplace upgrade i-have-adhd
codex plugin remove i-have-adhd
codex plugin add i-have-adhd@i-have-adhd
codex plugin remove i-have-adhd
codex plugin marketplace remove i-have-adhd
Add to ~/.codex/AGENTS.md:
## Output style
The reader has ADHD. Shape every response so it can be acted on:
1. Lead with the answer or next action: command, path, or snippet first.
2. Number multi-step work; one bounded action per step.
3. End with one next action doable in under two minutes.
4. Finish the current issue before raising a new one.
5. Restate progress each turn ("step 3 of 5 done").
6. Give time estimates in concrete units, never "a bit".
7. After a change, show what now works.
8. Errors: state location, cause, and fix. No drama.
9. Cap lists to 5 items.
10. No preamble, no recaps, no closers.
Exceptions: explain fully when asked to explain. Confirm before destructive actions. After three failed fixes, stop and name the doubtful assumption. If the request is ambiguous, ask one short question.
Grok loads the repository's existing plugin and skill files; no separate Grok manifest is required. Install directly from GitHub, enable the plugin, then invoke the skill. Two Grok-only steps: --trust (hooks and skills stay inactive without it) and grok plugin enable (plugins stay off until enabled).
grok plugin install ayghri/i-have-adhd --trust
grok plugin enable i-have-adhd
Start a new Grok session and type /i-have-adhd. Grok honors disable-model-invocation: true, so nothing applies until you invoke the skill or turn on always-on.
grok plugin list
grok plugin details i-have-adhd
Confirm i-have-adhd is listed, enabled, and shows a skill plus hooks.
grok plugin update i-have-adhd
grok plugin uninstall i-have-adhd --confirm
Or keep it installed and turn it off: grok plugin disable i-have-adhd.
Add the block to ~/.grok/AGENTS.md, or drop it in ~/.grok/rules/i-have-adhd.md (Grok loads both at session start):
## Output style
The reader has ADHD. Shape every response so it can be acted on:
1. Lead with the answer or next action: command, path, or snippet first.
2. Number multi-step work; one bounded action per step.
3. End with one next action doable in under two minutes.
4. Finish the current issue before raising a new one.
5. Restate progress each turn ("step 3 of 5 done").
6. Give time estimates in concrete units, never "a bit".
7. After a change, show what now works.
8. Errors: state location, cause, and fix. No drama.
9. Cap lists to 5 items.
10. No preamble, no recaps, no closers.
Exceptions: explain fully when asked to explain. Confirm before destructive actions. After three failed fixes, stop and name the doubtful assumption. If the request is ambiguous, ask one short question.
Gemini CLI has no plugin marketplace, so there are two native routes: a custom command (opt-in, off until you invoke it) or an extension (always-on once installed). The command route matches this skill's default posture; pick it unless you want the rules on every session.
mkdir -p ~/.gemini/commands
curl -fsSL https://raw.githubusercontent.com/ayghri/i-have-adhd/main/skills/i-have-adhd/agents/gemini.toml \
-o ~/.gemini/commands/i-have-adhd.toml
Start a new session, type /i-have-adhd. It stays on for that session.
gemini extensions install https://github.com/ayghri/i-have-adhd
The extension loads GEMINI.md, which imports the full skill, so the rules apply from message one. git must be installed.
gemini extensions list # extension route
ls ~/.gemini/commands # command route: i-have-adhd.toml present
Or type / in a session and confirm i-have-adhd is listed.
gemini extensions update i-have-adhd # extension route
# command route: re-run the curl above
gemini extensions uninstall i-have-adhd # extension route
rm ~/.gemini/commands/i-have-adhd.toml # command route
Copilot reads Agent Skills natively: the same SKILL.md, no conversion. It scans .github/skills/, .claude/skills/, and .agents/skills/ in the project, and ~/.copilot/skills/, ~/.claude/skills/, and ~/.agents/skills/ globally.
npx skills add ayghri/i-have-adhd -a github-copilot # this project
npx skills add ayghri/i-have-adhd -a github-copilot -g # all projects
Without the CLI, copy the skill folder into any directory Copilot scans:
git clone https://github.com/ayghri/i-have-adhd
mkdir -p ~/.copilot/skills
cp -R i-have-adhd/skills/i-have-adhd ~/.copilot/skills/
Type / in the chat input and confirm i-have-adhd appears. Or:
npx skills list
npx skills ls -g # if installed globally
npx skills update i-have-adhd
Or re-copy the folder after git pull.
npx skills remove i-have-adhd
Or delete the i-have-adhd folder from the skills directory it landed in.
Copilot respects disable-model-invocation: nothing applies until you invoke the skill, same as Claude Code (tested in #60).
Add the block below to .github/copilot-instructions.md in the project (Copilot reads it into every chat):
## Output style
The reader has ADHD. Shape every response so it can be acted on:
1. Lead with the answer or next action: command, path, or snippet first.
2. Number multi-step work; one bounded action per step.
3. End with one next action doable in under two minutes.
4. Finish the current issue before raising a new one.
5. Restate progress each turn ("step 3 of 5 done").
6. Give time estimates in concrete units, never "a bit".
7. After a change, show what now works.
8. Errors: state location, cause, and fix. No drama.
9. Cap lists to 5 items.
10. No preamble, no recaps, no closers.
Exceptions: explain fully when asked to explain. Confirm before destructive actions. After three failed fixes, stop and name the doubtful assumption. If the request is ambiguous, ask one short question.
hermes skills install ayghri/i-have-adhd/skills/i-have-adhd
Type /i-have-adhd. The skill installs into ~/.hermes/skills/ and is exposed as a slash command at the next session start.
Prefer to browse first? Add this repo as a skill source (a "tap"), then search and install:
hermes skills tap add ayghri/i-have-adhd
hermes skills search adhd
hermes skills install ayghri/i-have-adhd/skills/i-have-adhd
hermes skills list
hermes skills update i-have-adhd
hermes skills uninstall i-have-adhd
Or remove the tap too: hermes skills tap remove ayghri/i-have-adhd.
Add to the AGENTS.md in your working directory (Hermes loads it per workdir), or to your persona SOUL.md for every session:
## Output style
The reader has ADHD. Shape every response so it can be acted on:
1. Lead with the answer or next action: command, path, or snippet first.
2. Number multi-step work; one bounded action per step.
3. End with one next action doable in under two minutes.
4. Finish the current issue before raising a new one.
5. Restate progress each turn ("step 3 of 5 done").
6. Give time estimates in concrete units, never "a bit".
7. After a change, show what now works.
8. Errors: state location, cause, and fix. No drama.
9. Cap lists to 5 items.
10. No preamble, no recaps, no closers.
Exceptions: explain fully when asked to explain. Confirm before destructive actions. After three failed fixes, stop and name the doubtful assumption. If the request is ambiguous, ask one short question.
Start a Kimi Code session, then:
/plugins.https://github.com/ayghri/i-have-adhd and press Enter.Use slash command /skill:i-have-adhd to invoke the skill explicitly.
/plugins in Kimi Code session, cursor to I Have ADHD, press R.
/plugins in Kimi Code session, cursor to I Have ADHD, press D.
The plugin supports OpenCode V1 1.18.29+ and V2. It registers the skill and /i-have-adhd command, and adds optional always-on mode. Older V1 versions need an upgrade or the plugin from the previous skill release.
For use across projects:
git clone https://github.com/ayghri/i-have-adhd ~/.config/opencode/vendor/i-have-adhd
mkdir -p ~/.config/opencode/plugins
cat > ~/.config/opencode/plugins/i-have-adhd.js <<'EOF'
export { default } from '../vendor/i-have-adhd/.opencode/plugins/i-have-adhd.mjs';
EOF
For an existing V1 installation, keep the plugin entry in opencode.json. If switching to the loader above, remove that entry.
Start a new session and type /i-have-adhd. The rules apply until you say stop adhd mode or normal mode.
Alternatively, from a checkout, copy the skill and command into OpenCode's global directories:
mkdir -p ~/.config/opencode/skills/i-have-adhd ~/.config/opencode/commands
cp skills/i-have-adhd/SKILL.md ~/.config/opencode/skills/i-have-adhd/SKILL.md
cp .opencode/command/i-have-adhd.md ~/.config/opencode/commands/i-have-adhd.md
Start OpenCode, type /, and confirm i-have-adhd appears in the command list.
git -C ~/.config/opencode/vendor/i-have-adhd pull
For the copy-based install, pull your checkout and re-copy the two files.
Remove ~/.config/opencode/plugins/i-have-adhd.js. For the copy-based install, remove ~/.config/opencode/skills/i-have-adhd/ and ~/.config/opencode/commands/i-have-adhd.md. For an existing V1 config-based install, remove its plugin entry.
Requires the plugin. The flag adds the complete ruleset to the system prompt on every turn:
touch ~/.config/opencode/.i-have-adhd-always
stop adhd mode or normal mode asks the agent to return to its normal style for the current session. Delete the flag to stop automatic injection:
rm ~/.config/opencode/.i-have-adhd-always
If XDG_CONFIG_HOME is set, replace ~/.config in these paths with that directory.
Pi discovers this repository as a native package: extensions/ provides the session-persistent mode and skills/ keeps the Agent Skills entry point available.
pi install https://github.com/ayghri/i-have-adhd
Start a new Pi session. Toggle ADHD-friendly output for the current session:
/i-have-adhd
The footer shows ● ADHD ON while the mode is active. Run the command again to turn it off, or be explicit:
/i-have-adhd on
/i-have-adhd off
stop adhd mode
Like the Claude Code hook, the extension adds the ruleset to the conversation once instead of rewriting the system prompt on every request, and adds it again after compaction drops it.
The existing Agent Skills command remains available as an alias:
/skill:i-have-adhd
Start a new Pi session with the mode enabled by default:
pi --adhd
pi list
Confirm the GitHub package is listed, then type /i-have-adhd and check that ● ADHD ON appears in the footer.
pi update https://github.com/ayghri/i-have-adhd
Or update every unpinned Pi package with pi update --extensions.
pi remove https://github.com/ayghri/i-have-adhd
Create a flag in Pi's agent configuration directory:
touch ~/.pi/agent/.i-have-adhd-always
The extension checks the flag at every new, resumed, forked, or reloaded session. A saved choice for the current session wins over this default, so stop adhd mode keeps that session disabled.
Back to on-demand:
rm ~/.pi/agent/.i-have-adhd-always
Create ~/.pi/agent/i-have-adhd.json in Pi's agent configuration directory:
{
"alwaysOn": true,
"hideStatus": true
}
alwaysOn: start every session with the rules active — same as the .i-have-adhd-always flag file, which still workshideStatus: keep the ● ADHD ON status-bar entry hidden; the rules and the /i-have-adhd command still workRead once at extension startup, so restart Pi after changing it. A saved choice for the current session wins over alwaysOn, so stop adhd mode keeps that session disabled.
If PI_CODING_AGENT_DIR is set, put .i-have-adhd-always in that directory instead. Run /reload or start a new session after changing the flag.
omp plugin marketplace add ayghri/i-have-adhd
omp plugin install --scope user i-have-adhd@i-have-adhd
Start a new OMP session and run /i-have-adhd to toggle the mode.
omp plugin marketplace update i-have-adhd
omp plugin upgrade --scope user i-have-adhd@i-have-adhd
omp plugin uninstall --scope user i-have-adhd@i-have-adhd
omp plugin marketplace remove i-have-adhd
qwen extensions install ayghri/i-have-adhd
Qwen Code supports the GitHub shorthand and installs the repository as a native extension. The extension discovers the skill under `
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/ayghri/i-have-adhd.git cd i-have-adhd
Node.js 22
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install 22
npm 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.
No reports for macOS yet.
Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.