How to Integrate i-have-adhd with Agent Skills Compatible Harnesses

i-have-adhd is packaged as a skill that any agent harness supporting the Instagit Skill format can load, with integration centered on the SKILL.md metadata file and plugin.json registration.

The ayghri/i-have-adhd repository delivers an ADHD-friendly interaction pattern for AI agents through a standardized skill definition. It implements the Instagit Skill specification, enabling seamless integration across Claude Code, Codex, Gemini CLI, and other compatible harnesses via YAML/Markdown descriptors and harness-specific wrappers.

Understanding the Skill Architecture

Integration relies on two core components: the skill definition and the harness-specific registration mechanism.

The SKILL.md Definition

The file skills/i-have-adhd/SKILL.md contains the complete skill metadata—including name, description, and the critical disable-model-invocation: true flag—and the full rule set that shapes agent responses. When loaded, the harness injects these rules into the system prompt for the duration of the session.

The plugin.json Registration

The plugin.json file declares the plugin name and entry point, enabling harnesses to discover and register the skill. For Codex-specific installations, a .codex-plugin/plugin.json variant handles the marketplace registration.

Integration Methods by Harness

Each compatible harness discovers the skill differently, but all ultimately load the same SKILL.md ruleset.

Claude Code

Claude Code discovers the skill via the plugin marketplace. The harness checks for the i-have-adhd plugin and registers the slash command /i-have-adhd upon installation.

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

Type /i-have-adhd in the chat to activate.

Codex

Codex loads the skill as a plugin from .codex-plugin/plugin.json, supporting both explicit and auto-invocation modes.

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

Invoke with $i-have-adhd explicitly, or allow Codex to auto-invoke when task context matches the skill profile.

Gemini CLI

Gemini CLI uses a TOML command definition located at agents/gemini.toml. The harness registers this as a custom command available in new sessions.

curl -fsSL https://raw.githubusercontent.com/ayghri/i-have-adhd/main/skills/i-have-adhd/agents/gemini.toml \
  -o ~/.gemini/commands/i-have-adhd.toml

Start a new session and type /i-have-adhd to enable.

Hermes

Hermes discovers skills copied into ~/.hermes/skills/, displaying them in the Skills manager.

hermes skills install ayghri/i-have-adhd

Use the slash command /i-have-adhd in the Agent Panel.

AGY

AGY installs the repository as a plugin and registers the standard slash command.

agy plugin install https://github.com/ayghri/i-have-adhd

Invoke using /i-have-adhd in the chat interface.

Cursor

Cursor loads skills from the .cursor/skills/ directory, managed via the npx skills utility.

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

Open a new session and type /i-have-adhd to activate.

Zed

Zed requires manual copying to the skills directory.

cp -R i-have-adhd/skills/i-have-adhd ~/.config/zed/skills/

Type / and select the i-have-adhd skill from the picker.

GitHub Copilot

GitHub Copilot discovers skills placed under ~/.copilot/skills/.

npx skills add ayghri/i-have-adhd -a github-copilot

Use the slash command /i-have-adhd in the Copilot chat panel.

Enabling Persistent Activation

By default, skills only activate when explicitly invoked. To enable automatic loading for every session, create a flag file in your harness's configuration directory.

The hooks/always-on.sh script monitors for the existence of ~/.claude/.i-have-adhd-always (or equivalent paths for other harnesses). When present, the SessionStart hook automatically injects the full ruleset from SKILL.md without requiring manual invocation.

# For Claude Code

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

This persistent mode respects the disable-model-invocation: true setting, ensuring the skill shapes responses immediately upon session initialization.

Summary

• i-have-adhd implements the Instagit Skill format via skills/i-have-adhd/SKILL.md and plugin.json.
• Claude Code, Codex, Gemini CLI, Hermes, AGY, Cursor, Zed, and GitHub Copilot all support the skill through harness-specific discovery mechanisms.
• Invoke the skill using /i-have-adhd (or $i-have-adhd for Codex) after installation.
• Persistent activation requires creating a flag file (e.g., ~/.claude/.i-have-adhd-always) to trigger the hooks/always-on.sh SessionStart hook.

Frequently Asked Questions

What is the Instagit Skill format?

The Instagit Skill format is a YAML/Markdown specification for packaging agent behaviors. It defines metadata, invocation rules, and system prompt modifications in a standardized structure that any compatible harness can parse and execute.

How do I make i-have-adhd activate automatically for every session?

Create an empty flag file at ~/.claude/.i-have-adhd-always (adjust the path for your specific harness configuration directory). The hooks/always-on.sh script detects this file during SessionStart and automatically loads the skill rules without manual invocation.

Which harness uses the $i-have-adhd syntax instead of slash commands?

Codex uses the $i-have-adhd syntax for explicit invocation, whereas Claude Code, Gemini CLI, Hermes, AGY, Cursor, and GitHub Copilot use /i-have-adhd. Zed uses a picker interface accessed via the / menu.

Can I integrate this with custom agent implementations not listed here?

Yes. Any harness that parses Instagit-style plugins can load the skill by referencing skills/i-have-adhd/SKILL.md and the corresponding wrapper file (such as agents/openai.yaml or agents/gemini.toml) to define the command registration and system prompt injection logic.

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