How to Access Documentation for i-have-adhd: Complete File Reference and Setup Guide

The i-have-adhd repository stores all user-facing documentation directly in the source tree, with primary entry points at README.md for project overview, INSTALL.md for runtime-specific setup, and skills/i-have-adhd/SKILL.md containing the canonical 10-rule knowledge base.

The i-have-adhd project provides an ADHD-friendly agent skill designed to reduce cognitive load and improve focus in AI-assisted development workflows. To access documentation for i-have-adhd, navigate through the markdown files stored directly in the GitHub repository at ayghri/i-have-adhd, which serves as the single source of truth across all supported platforms including Antigravity, Claude Code, Codex, and Gemini CLI.

Core Documentation Files in the Repository

The repository organizes documentation into distinct files based on purpose and technical depth.

Project Overview and Quick Start (README.md)

The README.md file at the repository root delivers high-level project purpose, core rule summaries, and basic installation snippets. This file targets new users seeking immediate context on the skill's ADHD-friendly output design and essential validation steps.

Complete Installation Guide (INSTALL.md)

The INSTALL.md file provides comprehensive, step-by-step installation instructions for every supported runtime environment. According to the source code, this document covers specific setup requirements for Antigravity, Claude Code, Codex, Gemini CLI, Pi, and OMP, ensuring proper skill integration across diverse agent platforms.

Skill Definition and Rules (SKILL.md)

Located at skills/i-have-adhd/SKILL.md, this file contains the canonical 10-rule knowledge base that drives the ADHD-friendly formatting behavior. Because the skill is deliberately lightweight, every supported agent reads this specific file directly, with runtime-specific wrappers merely pointing to this location to maintain documentation consistency.

Runtime-Specific Configuration and Metadata

Beyond user guides, the repository includes technical documentation for agent integration.

Agent Entry Points and Manifests (AGENTS.md)

The AGENTS.md file maps each runtime to its specific entry points and plugin manifests. This documentation explains how Claude, Codex, OpenCode, and other agents load the skill and optionally enable "always-on" behavior.

Hook Declarations and Plugin Scripts

The hooks/hooks.json file contains hook declarations used by always-on runtimes to inject the skill automatically. For OpenCode users, the .opencode/plugins/i-have-adhd.mjs script registers the /i-have-adhd command and handles skill activation within that specific environment.

Contribution Guidelines (CONTRIBUTING.md)

The CONTRIBUTING.md file provides guidelines for extending the skill or translating documentation, located alongside localization assets in .github/readme/*.

Methods to Access Documentation for i-have-adhd

Users can retrieve documentation through three primary methods depending on their workflow requirements.

Browse Documentation on GitHub

Navigate directly to files in the repository tree using standard GitHub URLs. For example, access the main skill rules at https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md or the installation guide at the corresponding INSTALL.md path.

Fetch Raw Files via Command Line

Use curl or wget commands against raw GitHub URLs to download documentation for local reference or automation scripts. This method works for all markdown files in the repository.

Query Through Installed Agents

Many runtimes expose plugin management commands that reveal documentation locations. Execute claude plugin list or agy plugin list to verify installation paths and access bundled documentation from within your agent environment.

Practical Code Examples

Use these commands to access i-have-adhd documentation directly from your terminal:

# 1️⃣ Open the main README in a browser

open https://github.com/ayghri/i-have-adhd/blob/main/README.md

# 2️⃣ Download the full installation guide locally

curl -L https://raw.githubusercontent.com/ayghri/i-have-adhd/main/INSTALL.md -o INSTALL.md

# 3️⃣ Display skill rules directly from the repository (useful for debugging)

curl -s https://raw.githubusercontent.com/ayghri/i-have-adhd/main/skills/i-have-adhd/SKILL.md | less

# 4️⃣ Verify a plugin is installed (Claude Code example)

claude plugin list | grep i-have-adhd

Summary

• Primary documentation resides in README.md, INSTALL.md, and skills/i-have-adhd/SKILL.md at the repository root and skill directory.
• Runtime configurations are documented in AGENTS.md, hooks/hooks.json, and .opencode/plugins/i-have-adhd.mjs.
• Access methods include GitHub web interface, raw file fetching via curl, and agent-specific plugin commands.
• 10-rule knowledge base in SKILL.md serves as the single source of truth across all supported agents including Antigravity, Claude Code, Codex, and Gemini CLI.

Frequently Asked Questions

Where is the main i-have-adhd skill logic documented?

The canonical skill definition resides in skills/i-have-adhd/SKILL.md. This file contains the 10-rule knowledge base that all supported runtimes reference to generate ADHD-friendly output, ensuring consistent behavior across Antigravity, Claude Code, Codex, and other agents.

Can I access i-have-adhd documentation offline?

Yes. Download any documentation file using curl or wget against the raw GitHub URLs. For example, run curl -L https://raw.githubusercontent.com/ayghri/i-have-adhd/main/INSTALL.md -o INSTALL.md to store the installation guide locally for offline reference.

Which file contains installation instructions for my specific agent runtime?

The INSTALL.md file provides detailed, runtime-specific setup instructions for every supported platform including Antigravity, Claude Code, Codex, Gemini CLI, Pi, and OMP. Consult this file first when configuring new agent environments.

How do I verify that i-have-adhd is properly installed in my agent?

Use your agent's plugin management command. For Claude Code, run claude plugin list | grep i-have-adhd. For Antigravity, use agy plugin list. These commands display installed skills and their documentation paths, confirming proper integration.

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