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

> Discover which coding agents support the i-have-adhd skill. Explore our comprehensive guide to agent integration with Claude Code, Codex, Gemini CLI, Copilot, and more.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: getting-started
- Published: 2026-08-02

---

**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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) — declares plugin metadata
- [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) — registers a session-start hook that auto-loads rules when `~/.claude/.i-have-adhd-always` exists

```bash

# 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`](https://github.com/ayghri/i-have-adhd/blob/main/.codex-plugin/plugin.json).

```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

```

### Zed

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

```bash

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

```bash
hermes skills install ayghri/i-have-adhd

```

### Pi

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

```bash
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/`

```bash
npx skills add ayghri/i-have-adhd

```

### Antigravity (`agy`)

**Antigravity** follows the standard plugin pattern.

```bash
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:

```bash
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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) | Canonical rule definitions |
| [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) | Claude Code metadata |
| [`.codex-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.codex-plugin/plugin.json) | Codex metadata |
| [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) | Per-agent installation instructions |
| [`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) files?
2. **Try the generic installer** — `npx skills add ayghri/i-have-adhd`
3. **Consult [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) file. The repository includes thin wrapper configurations (like [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/README.md) Codex section for current invocation behavior.