AI Coding Assistants That Support the i-have-adhd Skill: Complete Integration Guide

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 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. 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 declares plugin metadata, while hooks/hooks.json defines session-start hooks for automatic loading
• Codex: .codex-plugin/plugin.json enables marketplace registration
• Generic agents: 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, and optional automatic activation occurs through hooks/hooks.json when the flag file ~/.claude/.i-have-adhd-always exists.

Install the skill using Claude Code's CLI:

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:

touch ~/.claude/.i-have-adhd-always

Invoke the skill manually in any Claude Code chat:

/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 file registers the skill, allowing Codex to automatically apply ADHD-friendly rules without explicit commands when appropriate.

Install via the Codex CLI:

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:

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

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:<name> syntax after installation.

Install for Pi using the generic skills installer:

npx skills add ayghri/i-have-adhd -a pi -y

Then invoke with:

/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:

/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:

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:

npx skills add ayghri/i-have-adhd -a cursor -y

For these platforms, invoke the skill with:

/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 definition file, ensuring consistent ADHD-friendly behavior.
• Claude Code and Codex use marketplace plugins (.claude-plugin/plugin.json and .codex-plugin/plugin.json) with optional automatic loading via 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) 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. 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 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 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}