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

The canonical rules for the i-have-ADHD skill are stored in the SKILL.md file located at 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), 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:

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:

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:

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 and define the maintenance workflow:

• 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 locations remain in sync.
• README.md – Provides high-level repository documentation explaining how the i-have-ADHD skill operates and its intended use cases.
• 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.
• A functional mirror exists at .cursor/skills/i-have-adhd/SKILL.md for editor-specific consumption.
• The Agent guide (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 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 is the canonical source of truth, while .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 file in the skills/i-have-adhd/ directory first. Then follow the synchronization protocol documented in AGENTS.md to propagate changes to the Cursor mirror at .cursor/skills/i-have-adhd/SKILL.md.

How many rules are defined in the canonical file?

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

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