# Where Is the Canonical Skill Definition for i-have-adhd? The Complete Developer Guide

> Find the canonical skill definition for i-have-adhd in the ayghri/i-have-adhd repository. Discover ten ADHD-friendly response rules, metadata, and persistence behavior.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: getting-started
- Published: 2026-08-31

---

**The canonical skill definition for i-have-adhd 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, which serves as the single source of truth for all ten ADHD-friendly response rules, skill metadata, and persistence behavior.**

This repository implements an AI-assisted development environment specifically designed for developers with ADHD. Understanding where the canonical skill definition lives is essential for contributors, maintainers, and anyone extending the behavior across different editor runtimes.

## The Canonical Skill Definition Location

The **definitive specification** resides in [`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. This markdown file contains:

- All ten ADHD-friendly response rules that govern how the AI assistant behaves
- Complete skill metadata including version, author, and compatibility information
- Persistence behavior requirements that all runtimes must implement

According to the repository's own [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) guide, this file is explicitly designated as the canonical definition. The guide states that any modifications must originate here first before propagating to derivative copies.

## The Cursor Runtime Copy

A synchronized copy 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 editor compatibility. This file **must remain identical** to the canonical version—the [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) documentation enforces strict synchronization between these two paths.

When contributing changes:

1. Edit [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) first
2. Copy the updated content to [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md)
3. Commit both files together

## Invoking and Controlling the Skill

The skill activates through simple natural language commands recognized by the runtime:

```text
/i-have-adhd

```

Typical response format shows immediate actionable guidance:

```

Run `npm install jsonwebtoken`, then edit `src/auth.ts:42`.

```

Toggle the mode off with:

```

stop adhd mode

```

Reactivate with:

```

i-have-adhd

```

## Key Files Reference

| File | Purpose |
|------|---------|
| [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) | **Canonical skill definition**—source of truth for rules, metadata, and persistence |
| [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) | Cursor-compatible copy requiring synchronization with canonical |
| [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) | Repository navigation guide confirming canonical locations |

## Summary

- The **canonical skill definition for i-have-adhd** is [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)
- Per [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) lines 29-31, this file is the authoritative source all runtimes must follow
- Cursor-specific copies 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 stay synchronized
- Changes flow from canonical → runtime copies, never the reverse

## Frequently Asked Questions

### What makes a skill definition "canonical" in this repository?

A canonical definition is the **authoritative source of truth** that all runtime implementations must follow. For i-have-adhd, this status is explicitly documented in [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md), which mandates that the [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) file be treated as the definitive specification.

### Can I edit the Cursor copy directly?

**No.** The [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) guide prohibits direct edits to [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md). Always modify [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) first, then propagate changes to the Cursor copy to maintain consistency across editor environments.

### What happens if the files become out of sync?

Desynchronization creates **undefined behavior** where Cursor users experience different ADHD assistance rules than users of other runtimes. The repository's contribution workflow prevents this by requiring paired commits touching both files simultaneously.

### Does the canonical file define technical implementation details?

The canonical definition specifies **behavioral rules and response patterns**, not implementation code. Runtimes interpret these markdown specifications to produce the actual assistant behavior, allowing the same skill to work across different AI coding platforms.