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

> Access i-have-adhd documentation directly from the repository. Find setup guides, file references, and the full knowledge base for seamless project integration.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: api-reference
- Published: 2026-08-30

---

**The i-have-adhd repository stores all user-facing documentation directly in the source tree**, with primary entry points at [`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md) for project overview, [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) for runtime-specific setup, and [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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:

```bash

# 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`](https://github.com/ayghri/i-have-adhd/blob/main/README.md), [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md), and [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) at the repository root and skill directory.
- **Runtime configurations** are documented in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md), [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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.