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

The canonical skill definition for i-have-adhd is located at 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 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 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 for Cursor editor compatibility. This file must remain identical to the canonical version—the AGENTS.md documentation enforces strict synchronization between these two paths.

When contributing changes:

1. Edit skills/i-have-adhd/SKILL.md first
2. Copy the updated content to .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:

/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	Canonical skill definition—source of truth for rules, metadata, and persistence
.cursor/skills/i-have-adhd/SKILL.md	Cursor-compatible copy requiring synchronization with canonical
AGENTS.md	Repository navigation guide confirming canonical locations

Summary

• The canonical skill definition for i-have-adhd is skills/i-have-adhd/SKILL.md
• Per 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 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, which mandates that the skills/i-have-adhd/SKILL.md file be treated as the definitive specification.

Can I edit the Cursor copy directly?

No. The AGENTS.md guide prohibits direct edits to .cursor/skills/i-have-adhd/SKILL.md. Always modify 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.

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