# AI Coding Assistants That Support the i-have-adhd Skill: Complete Integration Guide > Discover which AI coding assistants support the i-have-adhd skill including Copilot, Cursor, Gemini CLI, and more. Integrate seamlessly with our complete guide. - Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd) - Tags: how-to-guide - Published: 2026-08-07 --- **The i-have-adhd skill works with any AI coding assistant that implements the Agent Skills specification, including Claude Code, Codex, Zed, Hermes, Pi, Gemini CLI, GitHub Copilot, Antigravity, Cursor, OpenCode, and Amp, all consuming the canonical [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) file without requiring conversion.** The `ayghri/i-have-adhd` repository distributes an **Agent Skill** designed to provide ADHD-friendly coding assistance through standardized behavior rules. Because the skill follows the open Agent Skills specification, it integrates seamlessly across diverse AI coding platforms without modification or format conversion. Every supported agent references the same core definition file, ensuring consistent output whether you use Claude Code, GitHub Copilot, or Cursor. ## How the i-have-adhd Skill Loads Across Agents All AI coding assistants that support the i-have-adhd skill ultimately reference the **same source definition**. According to the `ayghri/i-have-adhd` source code, the canonical rule set resides at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). This file contains the complete behavior specification that each agent parses and executes. The repository provides platform-specific metadata files that register the skill with each agent's marketplace or plugin system: - **Claude Code**: [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) declares plugin metadata, while [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) defines session-start hooks for automatic loading - **Codex**: [`.codex-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.codex-plugin/plugin.json) enables marketplace registration - **Generic agents**: [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) documents the universal `npx skills add` command ## Claude Code Support **Claude Code** integrates the i-have-adhd skill through its official plugin marketplace. The installation registers the skill via [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json), and optional automatic activation occurs through [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) when the flag file `~/.claude/.i-have-adhd-always` exists. Install the skill using Claude Code's CLI: ```bash claude plugin marketplace add ayghri/i-have-adhd claude plugin install i-have-adhd@i-have-adhd ``` Enable always-on mode by creating the flag file: ```bash touch ~/.claude/.i-have-adhd-always ``` Invoke the skill manually in any Claude Code chat: ```text /i-have-adhd ``` ## Codex Support **Codex** supports the i-have-adhd skill through its plugin marketplace with **implicit invocation** enabled by default. The [`.codex-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.codex-plugin/plugin.json) file registers the skill, allowing Codex to automatically apply ADHD-friendly rules without explicit commands when appropriate. Install via the Codex CLI: ```bash codex plugin marketplace add ayghri/i-have-adhd --ref main codex plugin add i-have-adhd@i-have-adhd ``` In Codex chat, trigger the skill with: ```text $i-have-adhd ``` ## Zed, Hermes, and Pi Integration ### Zed **Zed** reads Agent Skills directly without conversion. Import the skill through Zed's Skills manager using the command `agent: create skill from url`, or manually copy the skill directory to Zed's skills folder as documented in [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md). ### Hermes **Hermes** installs the skill via `hermes skills install ...`. After installation and a session restart, the skill appears as a slash command in the chat interface. ### Pi **Pi** discovers the i-have-adhd skill in either the project directory or `~/.pi/agent/skills/`. Activate it using the `/skill:` syntax after installation. Install for Pi using the generic skills installer: ```bash npx skills add ayghri/i-have-adhd -a pi -y ``` Then invoke with: ```text /skill:i-have-adhd ``` ## Gemini CLI Support **Gemini CLI** offers two integration routes for the i-have-adhd skill. Users may define a custom command in `~/.gemini/commands/i-have-adhd.toml` or install it as an extension via `gemini extensions install ...`. Once configured, invoke the skill with: ```text /i-have-adhd ``` ## GitHub Copilot Support **GitHub Copilot** (both VS Code and CLI variants) scans multiple skill directories including `.github/skills/`, `.claude/skills/`, `.agents/skills/` (project-specific), and the global `~/.copilot/skills/` directory. Install the i-have-adhd skill using the generic Node.js installer: ```bash npx skills add ayghri/i-have-adhd ``` Copilot automatically discovers and loads the skill from these locations without additional configuration. ## Antigravity (agy) Support **Antigravity** (`agy`) installs the i-have-adhd skill via `agy plugin install ...`. The skill registers as a slash command after restarting the Antigravity session, following the same Agent Skills specification used by other platforms. ## Cursor, OpenCode, Amp, and Generic Harnesses Any AI coding assistant that implements the **Agent Skills harness** can load the i-have-adhd skill by copying the folder into the agent's skill directory (e.g., `~/.cursor/skills/`). The repository provides a generic installation command that works across Cursor, OpenCode, Amp, and future compatible agents: ```bash npx skills add ayghri/i-have-adhd -a cursor -y ``` For these platforms, invoke the skill with: ```text /i-have-adhd ``` ## Summary - The i-have-adhd skill adheres to the open **Agent Skills** specification, enabling cross-platform compatibility without code changes. - All supported agents consume the same [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) definition file, ensuring consistent ADHD-friendly behavior. - **Claude Code** and **Codex** use marketplace plugins ([`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) and [`.codex-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.codex-plugin/plugin.json)) with optional automatic loading via [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json). - **Zed**, **Hermes**, and **Pi** support native Agent Skill imports through their respective skill managers. - **Gemini CLI** accepts the skill as either a custom command or extension. - **GitHub Copilot**, **Antigravity**, **Cursor**, **OpenCode**, and **Amp** support the skill through generic skill directories and the `npx skills add` utility. - Future AI coding assistants that respect the Agent Skills spec (searching for [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md)) will automatically support the i-have-adhd skill without modification. ## Frequently Asked Questions ### Does the i-have-adhd skill require different files for each AI coding assistant? No. According to the `ayghri/i-have-adhd` source code, every supported agent reads the **same canonical file** located at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). Platform-specific directories like `.claude-plugin/` and `.codex-plugin/` contain only registration metadata, not duplicate skill definitions. This ensures identical behavior across Claude Code, Codex, Zed, and other compatible assistants. ### How do I enable automatic activation in Claude Code? Create the flag file `~/.claude/.i-have-adhd-always` after installing the plugin. The [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) file in the repository defines a session-start hook that checks for this file's existence and automatically loads the i-have-adhd rules when present. Without this flag, you must manually invoke the skill using `/i-have-adhd`. ### Can I use the i-have-adhd skill with AI assistants not listed in the documentation? Yes. Any AI coding assistant that implements the **Agent Skills** specification can load the i-have-adhd skill by discovering the [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) file. Copy the `skills/i-have-adhd/` directory into the agent's skill folder (e.g., `~/.cursor/skills/`) or use the generic installer `npx skills add ayghri/i-have-adhd`. As long as the harness respects the standard Agent Skills discovery mechanism, no conversion or modification is necessary. ### What is the difference between `$i-have-adhd` and `/i-have-adhd` invocation syntax? The syntax varies by agent implementation. **Codex** uses the `$` prefix (`$i-have-adhd`) due to its implicit invocation system, while most other agents including **Claude Code**, **Cursor**, and **Pi** use the slash command format (`/i-have-adhd` or `/skill:i-have-adhd`). The underlying skill behavior remains identical regardless of the invocation syntax used by each platform.