# Where Is the Canonical SKILL.md File for the i-have-adhd Project Located?

> Find the canonical SKILL.md file for the i-have-adhd project. Learn its exact location in the repository to access all skill definitions efficiently.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: how-to-guide
- Published: 2026-08-21

---

**The canonical SKILL.md file for the i-have-adhd project is 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, serving as the single source of truth for all skill definitions.**

The `ayghri/i-have-adhd` repository maintains a structured approach to skill documentation that separates authoritative definitions from IDE-specific mirrors. Understanding the precise location of the canonical SKILL.md file ensures developers contribute changes to the correct source and maintain synchronization across tooling environments.

## Exact Location of the Canonical SKILL.md File

According to the source code structure, the definitive skill definition resides at a specific path within the project hierarchy:

- **Canonical Path:** [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)
- **Repository:** `ayghri/i-have-adhd`
- **GitHub URL:** `https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md`

This file represents the **authoritative source** for the project's skill specifications. All edits, updates, and version control operations must target this specific file path to ensure the integrity of the skill definition across the codebase.

### The Cursor-Compatible Mirror

The repository maintains a secondary copy at [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) specifically for Cursor IDE integration. This is an **auto-synchronized mirror**, not the canonical version. The [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) file at the repository root documents the formal synchronization policy that maintains this mirror, ensuring it remains consistent with the primary source.

## How to Access the Canonical Skill File Programmatically

Developers can reference the canonical SKILL.md file using several practical approaches within the repository context.

Load the skill content using Python:

```python
from pathlib import Path

skill_path = Path(__file__).parent.parent / "skills" / "i-have-adhd" / "SKILL.md"
skill_content = skill_path.read_text(encoding="utf-8")
print(skill_content[:200])  # Display first 200 characters

```

Verify the file location using Bash:

```bash
git ls-files | grep '^skills/i-have-adhd/SKILL.md'

```

Reference the file in documentation:

```markdown
For the official skill definition, see the **[SKILL.md](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)** file.

```

## Project Structure and Synchronization Policy

The repository layout follows a clear separation between canonical resources and tooling-specific implementations. The [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) file defines the synchronization workflow that keeps the `.cursor` mirror updated automatically when changes occur in the canonical file.

Key files in this architecture include:

- **[`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)**: The canonical skill description containing the authoritative definition
- **[`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md)**: Cursor IDE compatibility layer (auto-synced from canonical)
- **[`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md)**: Documentation of the project layout and synchronization policy
- **[`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md)**: User-facing overview that points to the canonical skill file

## Summary

- The canonical SKILL.md file for the i-have-adhd project is located at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) relative to the repository root
- This path serves as the single source of truth for skill definitions within the `ayghri/i-have-adhd` repository
- A synchronized 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 Cursor IDE integration
- All modifications should target the canonical file; the mirror updates automatically per the policy in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md)
- Developers can verify the file location using `git ls-files` or construct paths programmatically using `pathlib`

## Frequently Asked Questions

### What is the exact file path for the canonical SKILL.md in the i-have-adhd repository?

The canonical SKILL.md file is located at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) relative to the repository root. This specific path is designated as the authoritative source, while the copy located at [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) functions as a synchronized mirror for Cursor IDE compatibility only.

### Should I edit the SKILL.md file in the .cursor folder or the skills folder?

Always edit the file in the `skills/i-have-adhd/` directory. The [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) file is an auto-synchronized mirror maintained specifically for IDE integration. The synchronization policy defined in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) automatically propagates changes from the canonical file to the mirror, making direct edits to the mirror unnecessary and potentially overwriteable.

### Where is the synchronization policy for the SKILL.md files documented?

The synchronization policy governing the relationship between the canonical skill file and its Cursor IDE mirror is documented in the [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) file at the repository root. This file outlines the project layout, specifies which files serve as sources of truth, and details the automatic sync procedures that maintain consistency across the canonical and mirrored versions.

### How can I programmatically verify the location of the canonical SKILL.md file?

Use the command `git ls-files | grep '^skills/i-have-adhd/SKILL.md'` to confirm the file is tracked at the canonical path within version control. Alternatively, use Python's `pathlib` module to construct the relative path from any script location within the repository, navigating up to the parent directories and into the `skills/i-have-adhd/` folder.