Supported AI Coding Agents for the i-have-adhd Skill

The i-have-adhd skill supports Claude Code, Codex, Zed, Hermes, Pi, Gemini CLI, GitHub Copilot, Antigravity (agy), Cursor, OpenCode, Amp, and any agent implementing the Agent Skills specification.

The i-have-adhd skill is an open-source Agent Skill that helps AI coding assistants provide ADHD-friendly code explanations. Because it follows the standardized Agent Skills format, any platform that understands this specification can consume it without conversion. The repository ships dedicated installation paths for popular agents, with all integrations ultimately reading the same canonical rule set.

Claude Code Integration

Claude Code installs the skill through its plugin marketplace.

Install and enable:

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

# Optional: always-on mode

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

Invoke with:

/i-have-adhd

The integration uses .claude-plugin/plugin.json to register the skill, and hooks/hooks.json to load rules automatically at session start when the flag file exists.

Codex Integration

Codex enables implicit invocation after marketplace installation:

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

Invoke with:

$i-have-adhd

The plugin metadata lives in .codex-plugin/plugin.json.

Zed Integration

Zed reads Agent Skills directly through its Skills manager:

agent: create skill from url

# Enter: https://github.com/ayghri/i-have-adhd

See INSTALL.md for the complete Zed-specific workflow.

Hermes Integration

Hermes treats the skill as a slash command:

hermes skills install ayghri/i-have-adhd

# Restart session

The skill appears as /i-have-adhd after restart.

Pi Integration

Pi discovers skills in ~/.pi/agent/skills/ or project directories:

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

Enable slash-command support in ~/.pi/settings.json if needed, then invoke:

/skill:i-have-adhd

Gemini CLI Integration

Gemini CLI offers two routes:

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

Invoke with:

/i-have-adhd

GitHub Copilot Integration

GitHub Copilot (VS Code and CLI) scans multiple skill directories:

• .github/skills/ (project)
• .claude/skills/ (project)
• .agents/skills/ (project)
• ~/.copilot/skills/ (global)

Install via:

npx skills add ayghri/i-have-adhd

Antigravity (agy) Integration

Antigravity installs as a plugin:

agy plugin install ayghri/i-have-adhd

Restart to activate the /i-have-adhd slash command.

Cursor, OpenCode, Amp, and Generic Agents

Any runtime reading Agent Skills can load i-have-adhd by copying the skill folder to the appropriate directory:

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

Generic install command:

npx skills add ayghri/i-have-adhd

Then invoke with /i-have-adhd or your agent's skill syntax.

Core Skill File

Every supported AI coding agent for the i-have-adhd skill converges on one source of truth:

• skills/i-have-adhd/SKILL.md — the canonical rule set defining ADHD-friendly output formatting

No conversion or per-agent customization is required.

Summary

• Claude Code and Codex use marketplace plugins with dedicated JSON manifests
• Zed, Hermes, and Pi integrate via native Agent Skills readers or CLI installers
• Gemini CLI supports both custom commands and extensions
• GitHub Copilot auto-discovers from standard skill directories
• Antigravity, Cursor, OpenCode, and Amp follow the generic npx skills add pattern
• All agents consume skills/i-have-adhd/SKILL.md directly
• Future agents supporting the Agent Skills spec will work without modification

Frequently Asked Questions

Does the i-have-adhd skill work with my custom AI coding assistant?

Yes, if your assistant implements the Agent Skills specification and can read a SKILL.md file. Copy the skills/i-have-adhd/ directory to your agent's skill folder, or use npx skills add ayghri/i-have-adhd if your platform supports it.

Why do installation commands vary across agents?

Each AI coding agent exposes skills through different mechanisms—marketplace plugins, native skill managers, slash commands, or directory scanning. The i-have-adhd repository adapts to each pattern while keeping the core skill definition identical in SKILL.md.

Can I use the same skill installation across multiple agents simultaneously?

Yes. Install the skill separately for each agent you use. All installations reference the same upstream rules from skills/i-have-adhd/SKILL.md, so updates propagate consistently when you refresh each agent's copy.

Is there an always-on mode so I don't need to invoke the skill manually?

Claude Code supports this via ~/.claude/.i-have-adhd-always, which triggers automatic loading through hooks/hooks.json. Other agents require explicit invocation per their design patterns; check INSTALL.md for agent-specific options.

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