# Where to Find the Canonical Rules for i-have-ADHD

> Discover the canonical rules for i-have-ADHD within the ayghri/i-have-adhd repository. Find the official SKILL.md file to access all regulations and guidelines.

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

---

**The canonical rules for the i-have-ADHD skill are stored in the [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) file located at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) in the repository root.**

The **i-have-ADHD** repository by `ayghri` implements a specialized coding assistant skill designed to provide ADHD-friendly responses. The definitive behavioral guidelines that power this skill are defined in a single markdown file that serves as the runtime's primary configuration source. Understanding the exact location and structure of this file is essential for contributors who need to modify the 10 ADHD-friendly response rules or for developers integrating the skill into custom agents.

## Locating the Canonical Rule File

The repository maintains two identical copies of the rule set for different consumption contexts, but only one is considered the authoritative source.

### Primary Location: skills/i-have-adhd/SKILL.md

The **canonical rule file** resides at:

```

skills/i-have-adhd/SKILL.md

```

This path represents the single source of truth for the skill definition. When the runtime loads the i-have-ADHD skill, it reads from this specific file to obtain the 10 structured behavioral rules that govern response formatting, tone, and information density.

### Cursor Editor Mirror: .cursor/skills/i-have-adhd/SKILL.md

A **mirrored copy** exists at:

```

.cursor/skills/i-have-adhd/SKILL.md

```

This duplicate serves the Cursor editor environment specifically. Both files contain identical markdown content, but the project workflow mandates that all modifications originate in the canonical `skills/` directory first. According to the repository's **Agent guide** ([`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md)), changes must be synced from the primary location to the Cursor mirror to maintain consistency across execution environments.

## Accessing the Rules Programmatically

Developers can inspect or load the canonical rules at runtime using various methods. The file is standard UTF-8 encoded markdown, making it accessible across Python, shell scripts, and JavaScript environments.

### Python File Reading

Use `pathlib` to resolve the relative path and extract the rules section:

```python
import pathlib

skill_path = pathlib.Path(__file__).parent / "skills" / "i-have-adhd" / "SKILL.md"
with skill_path.open(encoding="utf-8") as f:
    rules = f.read()
print(rules.split("## Rules")[1].strip())   # prints the rule section

```

### Command Line Inspection

From the repository root, use standard Unix utilities to view the content:

```bash
cat $(git rev-parse --show-toplevel)/skills/i-have-adhd/SKILL.md | less

```

### Remote Fetch via Raw URL

For Node.js applications or CI pipelines, fetch directly from GitHub's raw content domain:

```javascript
const https = require('https');
https.get('https://raw.githubusercontent.com/ayghri/i-have-adhd/main/skills/i-have-adhd/SKILL.md', (res) => {
  let data = '';
  res.on('data', chunk => data += chunk);
  res.on('end', () => console.log(data));
});

```

## Key Supporting Files

Several documentation files complement the canonical [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) and define the maintenance workflow:

- **[`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md)** – Describes the synchronization workflow between the canonical skill definition and the Cursor mirror. This file contains the protocol for updating rules and ensuring both [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) locations remain in sync.
- **[`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md)** – Provides high-level repository documentation explaining how the i-have-ADHD skill operates and its intended use cases.
- **[`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)** – Contains platform-specific installation instructions for various runtimes including Pi, OMP, and OpenCode.

## Summary

- The **canonical rules** for i-have-ADHD live exclusively in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md).
- A **functional mirror** exists at [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) for editor-specific consumption.
- The **Agent guide** ([`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md)) mandates updating the canonical file first, then syncing to the mirror.
- The rules are **plain markdown** and can be accessed via filesystem APIs, Git commands, or HTTP requests to the raw GitHub URL.

## Frequently Asked Questions

### Where exactly are the canonical rules for i-have-adhd located?

The canonical rules are located at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) in the repository root. This file is the authoritative source that the runtime loads when initializing the i-have-ADHD skill.

### What is the difference between the canonical file and the Cursor mirror?

The file at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) is the canonical source of truth, while [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) is a mirror specifically for the Cursor editor environment. They contain identical content, but the canonical file must be modified first according to the project's agent workflow.

### How do I update the i-have-adhd rules?

Edit the [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) file in the `skills/i-have-adhd/` directory first. Then follow the synchronization protocol documented in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) to propagate changes to the Cursor mirror at [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md).

### How many rules are defined in the canonical file?

The [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) file defines **10 ADHD-friendly response rules** that control how the assistant formats output, manages cognitive load, and structures information for users with ADHD.