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

> Learn to create a custom fork of the i-have-adhd skill. Follow our step-by-step guide to edit rules and personalize your AI agent's behavior with your unique fork.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: how-to-guide
- Published: 2026-08-20

---

**Fork the i-have-adhd repository, edit [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) | Core rule set, metadata, and behavioral directives | [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) |
| [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) | Runtime entry point mappings | Repository root |
| [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) | Platform-specific installation commands | Repository root |

Because the skill's logic lives entirely in [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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](https://github.com/ayghri/i-have-adhd) and click **Fork**, or use the CLI:

```bash

# 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`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) in your editor. This file contains the complete rule set that your AI agent will follow:

```bash
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

```bash
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:

```bash

# 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:

```bash

# 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`](https://github.com/ayghri/i-have-adhd/blob/main/opencode.json) configuration already references this path, so no additional registration is needed.

### Other Runtimes

Consult [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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>`.