# Source of Truth for Editing SKILL.md in the i-have-adhd Repository > Discover the definitive source for editing SKILL.md in the i-have-adhd repository. Learn how to synchronize changes between the main and mirror copies for accurate updates. - Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd) - Tags: how-to-guide - Published: 2026-09-09 --- **The canonical source of truth for editing SKILL.md is the file [`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, which must be manually synchronized with the mirror 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) after every modification.** The `ayghri/i-have-adhd` project maintains ADHD-friendly response guidelines through a structured skill system documented in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md). When updating these guidelines, contributors must edit the canonical skill file to ensure the 10 ADHD-friendly response rules remain consistent across both the repository documentation and the Cursor IDE runtime. ## Canonical Skill File Location The definitive source of truth for the ADHD skill rules is **[`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 authoritative implementation of the guidelines that govern how responses should be structured for ADHD accessibility. ### AGENTS.md Documentation Reference According to the source code in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) at line 29, the project explicitly designates [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) as the canonical location. The documentation states that this path serves as the master copy, preventing ambiguity about which file to edit when modifying response behavior. ## Mirror File Synchronization Requirements The Cursor runtime environment requires a duplicate of the skill file 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)**. This mirror is not a secondary source of truth but a runtime dependency that must remain byte-for-byte identical to the canonical file. Failure to update both files creates drift between the documented rules and the active runtime behavior. Every change set must include modifications to both paths to maintain repository integrity. ## How to Edit the ADHD Skill Rules When updating the skill rules, adhere to this workflow to maintain synchronization between the source of truth and its runtime mirror. ### Step 1: Branch and Edit the Canonical File Create a feature branch and open the canonical skill file in your preferred editor. ```bash git checkout -b update-adhd-skill code skills/i-have-adhd/SKILL.md ``` Modify the rules as needed within [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). ### Step 2: Synchronize the Mirror Copy the updated canonical file to the Cursor runtime location immediately after saving. ```bash cp skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md ``` ### Step 3: Verify File Integrity Confirm both files are identical using `diff` before staging. ```bash diff -u skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md || echo "Mirror out of sync!" ``` ### Step 4: Commit Both Files Stage and commit both paths to ensure atomic updates. ```bash git add skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md git commit -m "Update ADHD skill rules in canonical and mirror" git push origin update-adhd-skill ``` ## Summary - The **source of truth for editing SKILL.md** is exclusively [`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. - The **mirror file** at [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) must be manually synchronized with every canonical edit. - The **[`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md)** file at line 29 documents this relationship and explicitly designates the canonical path. - Always verify synchronization using `diff` before committing changes to prevent runtime drift between the documented rules and Cursor runtime behavior. ## Frequently Asked Questions ### What is the source of truth for editing SKILL.md in the i-have-adhd repository? The source of truth is the file [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) located in the repository root. This file contains the master copy of the 10 ADHD-friendly response rules, as explicitly designated in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) at line 29. All edits must begin here rather than in the `.cursor/` directory. ### Do I need to manually sync the mirror file after editing SKILL.md? Yes, you must manually copy [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) to [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) after every edit. The repository does not implement automated synchronization hooks, so failing to update both files results in the Cursor runtime using outdated rules while the repository shows newer documentation. ### What happens if I only edit the .cursor/skills/i-have-adhd/SKILL.md file? Editing only the mirror file violates the repository architecture defined in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md). The canonical file at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) would remain unchanged, creating a discrepancy where the documented source of truth contradicts the runtime behavior. Always edit the canonical file first, then sync to the mirror. ### How can I verify that both SKILL.md files are synchronized? Use the `diff` command to compare the canonical and mirror files: `diff -u skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md`. If the files are identical, the command produces no output. Any output indicates the mirror is out of sync and needs updating before you commit your changes.