How to Create a Custom Fork of the i-have-adhd Skill: Complete Step-by-Step Guide

Fork the i-have-adhd repository, edit skills/i-have-adhd/SKILL.md with your custom rules, then point your AI agent to your forked copy to override the default behavior.

The i-have-adhd skill by ayghri/i-have-adhd is a lightweight, file-based AI skill system where all behavior is controlled by a single markdown rule file. Unlike complex plugin architectures, this skill requires no compilation or build steps—making custom forks trivial to create and deploy across Claude Code, Codex, OpenCode, and other supported runtimes.

What Controls the i-have-adhd Skill Behavior

The skill follows a manifest-driven architecture with minimal moving parts. According to the source code, only one file determines how the skill behaves:

File	Purpose	Location
skills/i-have-adhd/SKILL.md	Core rule set, metadata, and behavioral directives	skills/i-have-adhd/SKILL.md
AGENTS.md	Runtime entry point mappings	Repository root
INSTALL.md	Platform-specific installation commands	Repository root

Because the skill's logic lives entirely in SKILL.md, any modification—adding rules, changing response patterns, or toggling flags like disable-model-invocation—takes effect immediately upon reinstall.

Fork and Customize: Step-by-Step

Step 1: Fork the Repository on GitHub

Navigate to github.com/ayghri/i-have-adhd and click Fork, or use the CLI:

# Alternative: clone and push to a new repository

git clone https://github.com/ayghri/i-have-adhd.git
cd i-have-adhd
git remote set-url origin https://github.com/<your-username>/i-have-adhd.git
git push -u origin main

Step 2: Edit the Rule File

Open skills/i-have-adhd/SKILL.md in your editor. This file contains the complete rule set that your AI agent will follow:

code skills/i-have-adhd/SKILL.md

Modify any section: add custom rules, adjust phrasing, or change configuration flags. The file uses standard markdown with structured rule blocks that agents parse directly.

Step 3: Commit and Push Changes

git add skills/i-have-adhd/SKILL.md
git commit -m "Customize ADHD rules for personal workflow"
git push origin main

Your fork now contains the customized skill code.

Install Your Custom Fork in AI Agents

Claude Code Installation

Replace the official skill with your fork using the plugin marketplace commands:

# Remove the upstream version

claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd

# Register your fork as a marketplace source

claude plugin marketplace add <your-username>/i-have-adhd

# Install from your fork

claude plugin install i-have-adhd@i-have-adhd

OpenCode Installation

OpenCode uses a vendor folder for plugin resolution:

# Clone your fork into the vendor directory

git clone https://github.com/<your-username>/i-have-adhd \
  ~/.config/opencode/vendor/i-have-adhd

Restart OpenCode. The opencode.json configuration already references this path, so no additional registration is needed.

Other Runtimes

Consult INSTALL.md in the repository root for runtime-specific commands. The file contains verified installation paths for Codex and additional Claude-based environments.

Verify Your Custom Fork Works

Start a new session and invoke the skill:

/i-have-adhd

The agent's responses will now follow your customized rules from SKILL.md. If behavior hasn't changed, confirm:

• The fork URL is correct in your marketplace configuration
• You committed changes to the default branch (main)
• The agent session was restarted after installation

Key Customization Points in SKILL.md

When editing your fork, focus on these high-impact sections:

• Rule blocks — Define when and how the skill activates
• Response templates — Control output formatting and tone
• disable-model-invocation — Toggle whether the skill can trigger LLM calls
• Metadata headers — Version, author, and compatibility declarations

Since there's no compilation step, iterate rapidly: edit, commit, push, and reinstall to test changes.

Summary

• Fork the ayghri/i-have-adhd repository to your GitHub account
• Edit skills/i-have-adhd/SKILL.md — the single source of truth for skill behavior
• Push changes and point your agent to the fork using runtime-specific marketplace or vendor folder commands
• Verify by invoking /i-have-adhd in a fresh session

The skill's architecture eliminates build complexity, making custom i-have-adhd forks deployable in under five minutes.

Frequently Asked Questions

Can I modify the skill without forking?

No. The i-have-adhd skill loads rules exclusively from the SKILL.md file in its repository. To change behavior, you must maintain a modified copy of this file, which GitHub forks handle cleanly with upstream sync capabilities.

What happens if the original skill updates?

Your fork remains independent. To incorporate upstream changes, add the original repository as a remote and merge updates: git remote add upstream https://github.com/ayghri/i-have-adhd.git && git fetch upstream && git merge upstream/main.

Do I need to restart my AI agent after editing the skill?

Yes. Most runtimes parse SKILL.md at installation time, not runtime. After pushing changes to your fork, reinstall the skill and start a new agent session to load the updated rules.

Can I distribute my custom fork to teammates?

Absolutely. Once pushed to a public or private GitHub repository, others can install your fork using the same marketplace commands, substituting your username for <your-username>.

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