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

The canonical SKILL.md file for the i-have-adhd project is located at 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
• 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 specifically for Cursor IDE integration. This is an auto-synchronized mirror, not the canonical version. The 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:

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:

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

Reference the file in documentation:

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 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: The canonical skill description containing the authoritative definition
• .cursor/skills/i-have-adhd/SKILL.md: Cursor IDE compatibility layer (auto-synced from canonical)
• AGENTS.md: Documentation of the project layout and synchronization policy
• 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 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 for Cursor IDE integration
• All modifications should target the canonical file; the mirror updates automatically per the policy in 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 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 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 file is an auto-synchronized mirror maintained specifically for IDE integration. The synchronization policy defined in 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 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.

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