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

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

   claude plugin uninstall i-have-adhd

3. Remove the upstream marketplace entry:

   claude plugin marketplace remove i-have-adhd

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

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

5. Install the forked plugin:

   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. 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, validate your changes locally before packaging:

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, while .claude-plugin/plugin.json and .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 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. 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 (for plugin identity), .claude-plugin/marketplace.json (for registry metadata), and at least one skill file such as skills/i-have-adhd/SKILL.md. The repository ayghri/i-have-adhd provides this exact structure, so keeping these paths intact ensures compatibility.

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