# How to Integrate i-have-adhd with Agent Skills Compatible Harnesses > Learn to integrate i-have-adhd with Agent Skills compatible harnesses. Discover how to use SKILL.md and plugin.json for seamless integration with the ayghri/i-have-adhd repository. - Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd) - Tags: how-to-guide - Published: 2026-07-31 --- **i-have-adhd is packaged as a skill that any agent harness supporting the Instagit Skill format can load, with integration centered on the [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) metadata file and [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json) registration.** The `ayghri/i-have-adhd` repository delivers an ADHD-friendly interaction pattern for AI agents through a standardized skill definition. It implements the Instagit Skill specification, enabling seamless integration across Claude Code, Codex, Gemini CLI, and other compatible harnesses via YAML/Markdown descriptors and harness-specific wrappers. ## Understanding the Skill Architecture Integration relies on two core components: the skill definition and the harness-specific registration mechanism. ### The SKILL.md Definition The file [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) contains the complete skill metadata—including `name`, `description`, and the critical `disable-model-invocation: true` flag—and the full rule set that shapes agent responses. When loaded, the harness injects these rules into the system prompt for the duration of the session. ### The plugin.json Registration The [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json) file declares the plugin name and entry point, enabling harnesses to discover and register the skill. For Codex-specific installations, a [`.codex-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.codex-plugin/plugin.json) variant handles the marketplace registration. ## Integration Methods by Harness Each compatible harness discovers the skill differently, but all ultimately load the same [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) ruleset. ### Claude Code Claude Code discovers the skill via the plugin marketplace. The harness checks for the **i-have-adhd** plugin and registers the slash command `/i-have-adhd` upon installation. ```bash claude plugin marketplace add ayghri/i-have-adhd claude plugin install i-have-adhd@i-have-adhd ``` Type `/i-have-adhd` in the chat to activate. ### Codex Codex loads the skill as a plugin from [`.codex-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.codex-plugin/plugin.json), supporting both explicit and auto-invocation modes. ```bash codex plugin marketplace add ayghri/i-have-adhd --ref main codex plugin add i-have-adhd@i-have-adhd ``` Invoke with `$i-have-adhd` explicitly, or allow Codex to auto-invoke when task context matches the skill profile. ### Gemini CLI Gemini CLI uses a TOML command definition located at [`agents/gemini.toml`](https://github.com/ayghri/i-have-adhd/blob/main/agents/gemini.toml). The harness registers this as a custom command available in new sessions. ```bash 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 and type `/i-have-adhd` to enable. ### Hermes Hermes discovers skills copied into `~/.hermes/skills/`, displaying them in the Skills manager. ```bash hermes skills install ayghri/i-have-adhd ``` Use the slash command `/i-have-adhd` in the Agent Panel. ### AGY AGY installs the repository as a plugin and registers the standard slash command. ```bash agy plugin install https://github.com/ayghri/i-have-adhd ``` Invoke using `/i-have-adhd` in the chat interface. ### Cursor Cursor loads skills from the `.cursor/skills/` directory, managed via the `npx skills` utility. ```bash npx skills add ayghri/i-have-adhd -a cursor -y ``` Open a new session and type `/i-have-adhd` to activate. ### Zed Zed requires manual copying to the skills directory. ```bash cp -R i-have-adhd/skills/i-have-adhd ~/.config/zed/skills/ ``` Type `/` and select the **i-have-adhd** skill from the picker. ### GitHub Copilot GitHub Copilot discovers skills placed under `~/.copilot/skills/`. ```bash npx skills add ayghri/i-have-adhd -a github-copilot ``` Use the slash command `/i-have-adhd` in the Copilot chat panel. ## Enabling Persistent Activation By default, skills only activate when explicitly invoked. To enable automatic loading for every session, create a flag file in your harness's configuration directory. The [`hooks/always-on.sh`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/always-on.sh) script monitors for the existence of `~/.claude/.i-have-adhd-always` (or equivalent paths for other harnesses). When present, the SessionStart hook automatically injects the full ruleset from [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) without requiring manual invocation. ```bash # For Claude Code touch ~/.claude/.i-have-adhd-always ``` This persistent mode respects the `disable-model-invocation: true` setting, ensuring the skill shapes responses immediately upon session initialization. ## Summary - **i-have-adhd** implements the Instagit Skill format via [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) and [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json). - **Claude Code, Codex, Gemini CLI, Hermes, AGY, Cursor, Zed, and GitHub Copilot** all support the skill through harness-specific discovery mechanisms. - **Invoke** the skill using `/i-have-adhd` (or `$i-have-adhd` for Codex) after installation. - **Persistent activation** requires creating a flag file (e.g., `~/.claude/.i-have-adhd-always`) to trigger the [`hooks/always-on.sh`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/always-on.sh) SessionStart hook. ## Frequently Asked Questions ### What is the Instagit Skill format? The Instagit Skill format is a YAML/Markdown specification for packaging agent behaviors. It defines metadata, invocation rules, and system prompt modifications in a standardized structure that any compatible harness can parse and execute. ### How do I make i-have-adhd activate automatically for every session? Create an empty flag file at `~/.claude/.i-have-adhd-always` (adjust the path for your specific harness configuration directory). The [`hooks/always-on.sh`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/always-on.sh) script detects this file during SessionStart and automatically loads the skill rules without manual invocation. ### Which harness uses the $i-have-adhd syntax instead of slash commands? Codex uses the `$i-have-adhd` syntax for explicit invocation, whereas Claude Code, Gemini CLI, Hermes, AGY, Cursor, and GitHub Copilot use `/i-have-adhd`. Zed uses a picker interface accessed via the `/` menu. ### Can I integrate this with custom agent implementations not listed here? Yes. Any harness that parses Instagit-style plugins can load the skill by referencing [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) and the corresponding wrapper file (such as [`agents/openai.yaml`](https://github.com/ayghri/i-have-adhd/blob/main/agents/openai.yaml) or [`agents/gemini.toml`](https://github.com/ayghri/i-have-adhd/blob/main/agents/gemini.toml)) to define the command registration and system prompt injection logic.