# How to Fork or Tune the i‑have‑adhd Flow for Claude Code

> Learn how to fork or tune the i-have-adhd flow for Claude Code by cloning the repository, modifying rules, registering your fork, and installing it.

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

---

**To fork the i‑have‑adhd flow for Claude Code, clone the `ayghri/i‑have‑adhd` repository, modify the behavioral rules in `skills/i‑have‑adhd/SKILL.md`, register your fork in the Claude Code marketplace, and install it to replace the upstream plugin.**

The `ayghri/i‑have‑adhd` repository provides an ADHD‑friendly response plugin that reshapes Claude Code’s output through a declarative rule set. Forking this open‑source project lets you personalize the guidelines or add new constraints without rebuilding the integration from scratch. The entire plugin consists of two JSON manifests and a single Markdown skill file that Claude Code interprets at runtime.

## Understanding the Plugin Architecture

Before modifying the behavior, you need to know which files control what. The plugin relies on three specific paths inside the repository root:

### SKILL.md – The Rule Engine

The file [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) contains the 10 ADHD‑friendly response rules that Claude Code follows when the skill is active. This is the only file you need to edit to change how Claude formats lists, structures explanations, or paces information delivery.

### plugin.json – The Manifest

Located at [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json), this file declares the plugin name, version, and description that Claude Code displays in its plugin manager. You should update the version string here when you publish changes to track your custom iteration.

### marketplace.json – The Registry Entry

The file [`.claude-plugin/marketplace.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/marketplace.json) provides the metadata Claude Code uses when displaying the plugin in its marketplace. When you fork the repo, you will point Claude Code at your version of this file to make the fork discoverable.

## Forking and Installing Your Custom Version

Follow these exact steps to replace the upstream plugin with your tuned version:

1. **Fork the repository** on GitHub to create `<your-username>/i-have-adhd`.

2. **Uninstall the upstream plugin** to avoid rule collisions:

   ```bash
   claude plugin uninstall i-have-adhd
   ```

3. **Remove the upstream marketplace entry**:

   ```bash
   claude plugin marketplace remove i-have-adhd
   ```

4. **Register your fork** in the Claude Code marketplace (replace `<your-username>` with your GitHub handle):

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

5. **Install the forked plugin**:

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

6. **Restart Claude Code** and invoke the skill by typing `/i-have-adhd` in the chat.

## Customizing the ADHD‑Friendly Rules

Once the repository is forked, tuning the flow happens entirely inside [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). This file uses natural language instructions to constrain Claude Code’s output style—such as enforcing bullet points over dense paragraphs or requiring step numbering.

After editing [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md), validate your changes locally before packaging:

```bash
python3 -m unittest discover -s tests -v

```

This command runs the plugin’s test suite against your modified rules, catching syntax errors or constraint violations without requiring a full reinstall cycle.

## Summary

- The `ayghri/i‑have‑adhd` plugin architecture is minimal: rules live in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md), while [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) and [`.claude-plugin/marketplace.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/marketplace.json) handle metadata.
- To fork the i‑have‑adhd flow for Claude Code, uninstall the upstream version, add your fork to the marketplace, and reinstall from your repository.
- Always run `python3 -m unittest discover -s tests -v` after editing [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) to verify rule syntax.
- Invoke the tuned skill with `/i-have-adhd` after restarting Claude Code.

## Frequently Asked Questions

### Where are the behavioral rules defined in the i‑have‑adhd repository?

The rules are defined in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). This Markdown file contains the 10 specific constraints that tell Claude Code how to structure ADHD‑friendly responses, such as using short paragraphs and clear headers.

### How do I prevent conflicts between the original plugin and my fork?

You must uninstall the upstream plugin using `claude plugin uninstall i-have-adhd` and remove its marketplace entry with `claude plugin marketplace remove i-have-adhd` before registering your fork. Claude Code cannot load two plugins with the same identifier simultaneously.

### Can I test changes to SKILL.md before installing the plugin in Claude Code?

Yes. Run `python3 -m unittest discover -s tests -v` from the repository root to execute the local test suite. This validates your rule syntax and catches formatting errors before you install the forked plugin.

### What is the minimum file structure required for Claude Code to recognize my fork?

Claude Code requires three files: [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) (for plugin identity), [`.claude-plugin/marketplace.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/marketplace.json) (for registry metadata), and at least one skill file such as [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). The repository `ayghri/i-have-adhd` provides this exact structure, so keeping these paths intact ensures compatibility.