Which Coding Agents Support i‑have‑adhd Skill: Complete Agent Integration Guide

The i‑have‑adhd skill works with Claude Code, Codex, Zed, Hermes, Pi, Gemini CLI, GitHub Copilot, Antigravity, Cursor, OpenCode, Amp, and any other agent that implements the Agent Skills specification.

The ayghri/i-have-adhd repository provides an Agent Skill designed to help developers with ADHD by applying consistent, ADHD-friendly patterns across AI-assisted coding sessions. Because it follows the open Agent Skills standard, any coding assistant that understands this specification can consume the skill without conversion—every agent ultimately reads the same skills/i-have-adhd/SKILL.md file.

Officially Supported Coding Agents

The repository ships dedicated installation instructions and configuration files for nine major agents, plus a generic pathway for any compliant harness.

Claude Code

Claude Code loads the skill via its plugin marketplace. The integration uses:

• .claude-plugin/plugin.json — declares plugin metadata
• hooks/hooks.json — registers a session-start hook that auto-loads rules when ~/.claude/.i-have-adhd-always exists

# Install via Claude Code's marketplace

claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

# Optionally enable always-on mode

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

Invoke with:

/i-have-adhd

Codex

Codex enables implicit invocation—the skill runs automatically after installation without explicit triggering.

Configuration lives in .codex-plugin/plugin.json.

codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

Invoke with:

$i-have-adhd

Zed

Zed's Agent reads Agent Skills natively through its Skills manager. No plugin conversion is required.

# In Zed: use the Skills manager

agent: create skill from url https://github.com/ayghri/i-have-adhd

Hermes

Hermes installs the skill as a slash command that appears after session restart.

hermes skills install ayghri/i-have-adhd

Pi

Pi discovers skills in ~/.pi/agent/skills/ (global) or project directories, activating via /skill:<name> syntax.

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

# Enable slash-command support in ~/.pi/settings.json if needed

Invoke with:

/skill:i-have-adhd

Gemini CLI

Gemini CLI offers two integration routes:

1. Custom command: place config in ~/.gemini/commands/i-have-adhd.toml
2. Extension: gemini extensions install ayghri/i-have-adhd

Invoke with:

/i-have-adhd

GitHub Copilot (VS Code & CLI)

GitHub Copilot scans multiple skill directories:

• Project-local: .github/skills/, .claude/skills/, .agents/skills/
• Global: ~/.copilot/skills/

npx skills add ayghri/i-have-adhd

Antigravity (agy)

Antigravity follows the standard plugin pattern.

agy plugin install ayghri/i-have-adhd

The skill becomes available as a slash command after restart.

Generic Agent Support: Cursor, OpenCode, Amp, and Beyond

Any runtime implementing the Agent Skills specification can load the skill. The generic installation command works across compatible harnesses:

npx skills add ayghri/i-have-adhd -a <agent-name> -y

Manual installation is also supported—simply copy the skill folder to the agent's designated directory:

Agent	Typical skill directory
Cursor	~/.cursor/skills/
OpenCode	~/.opencode/skills/
Amp	~/.amp/skills/

Once installed, invoke with:

/i-have-adhd

Core Architecture: One Skill File Powers All Agents

Every supported agent consumes the identical source of truth: skills/i-have-adhd/SKILL.md. This ensures consistent ADHD-friendly behavior across your entire toolchain—no drift between agents, no version conflicts.

The repository structure enforces this uniformity:

File	Purpose
skills/i-have-adhd/SKILL.md	Canonical rule definitions
.claude-plugin/plugin.json	Claude Code metadata
.codex-plugin/plugin.json	Codex metadata
INSTALL.md	Per-agent installation instructions
README.md	Quick-start for Claude Code and Codex

How to Verify Your Agent Supports i‑have‑adhd Skill

1. Check for Agent Skills support — Does your agent look for SKILL.md files?
2. Try the generic installer — npx skills add ayghri/i-have-adhd
3. Consult INSTALL.md in the repository for agent-specific details

Summary

• Claude Code, Codex, Zed, Hermes, Pi, Gemini CLI, GitHub Copilot, and Antigravity ship with first-class integration configurations in the repository.
• Cursor, OpenCode, Amp, and any Agent Skills-compliant harness work via generic installation.
• All agents read skills/i-have-adhd/SKILL.md directly—no conversion layer needed.
• The open Agent Skills specification ensures future compatibility without code changes.

Frequently Asked Questions

Does i‑have‑adhd skill require different files for each agent?

No. Every agent consumes the same skills/i-have-adhd/SKILL.md file. The repository includes thin wrapper configurations (like .claude-plugin/plugin.json) that register the skill with each agent's marketplace or plugin system, but the core rules remain identical.

Can I use i‑have‑adhd skill with agents not listed in the documentation?

Yes. Any coding assistant that implements the Agent Skills specification can load the skill. Copy the skills/i-have-adhd/ folder to your agent's skills directory, or run npx skills add ayghri/i-have-adhd if the agent supports the generic installer.

How do I make Claude Code load i‑have‑adhd automatically on every session?

Create the flag file ~/.claude/.i-have-adhd-always. The hooks/hooks.json configuration detects this file and triggers automatic skill loading at session start. Without this flag, you must invoke /i-have-adhd manually.

Why does Codex use $i-have-adhd instead of /i-have-adhd?

Codex's command syntax prefixes skill invocations with $ rather than /. Additionally, Codex supports implicit invocation—the skill may activate automatically based on context without explicit triggering. Check the repository's README.md Codex section for current invocation behavior.

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