How to Register Agent Reach as an Agent Skill for Claude Code

Run agent-reach skill --install to register Agent Reach as an agent skill for Claude Code; the CLI automatically copies the skill manifest and references into the correct platform directory.

Agent Reach, maintained in the Panniantong/Agent-Reach repository, ships with a ready-to-use skill package designed for agent platforms like Claude Code. Registering Agent Reach as an agent skill for Claude Code requires a single terminal command that handles file placement automatically without modifying any upstream tooling.

Install the Skill via CLI

The registration process is handled entirely by the skill subcommand defined in agent_reach/cli.py. At the dispatcher level, the _cmd_skill function (see lines 546–560) routes the --install flag to the _install_skill() helper.

Run the following command from your terminal:

agent-reach skill --install

This command writes the skill manifest and supporting documentation into the first valid platform directory it discovers on your system. Because the implementation only copies files and never edits external tools, it complies with the repository’s strict "no upstream changes" rule.

Where the Skill Files Are Installed

The _install_skill() function in [agent_reach/cli.py](https://github.com/Panniantong/Agent-Reach/blob/main/agent_reach/cli.py#L323-L405) checks for known installation locations in a specific priority order:

1. ~/.agents/skills — generic fallback directory
2. ~/.openclaw/skills — OpenClaw platform path
3. ~/.claude/skills — Claude Code platform path
4. $OPENCLAW_HOME/.openclaw/skills — custom OpenClaw home directory

The function selects the first directory that already exists. If none are present, it creates the generic path ~/.agents/skills/agent-reach. To force installation into the generic .agents location regardless of other platform directories, pre-create the folder before running the command:

mkdir -p ~/.agents/skills
agent-reach skill --install

What Gets Copied During Registration

During execution, _install_skill() performs four distinct file operations using importlib.resources.files("agent_reach").joinpath("skill") to locate the bundled skill package:

• Locale selection — Chooses SKILL_en.md for English environments; otherwise falls back to SKILL.md.
• Manifest placement — Writes the selected skill manifest into the target agent-reach/ directory.
• Reference documentation — Copies the entire references/ subdirectory containing category-specific Markdown files (search, social, dev, and others).
• Confirmation — Prints the installation path to the terminal.

For example, a successful installation into the Claude Code directory produces output similar to:

Skill installed for Claude Code: /home/username/.claude/skills/agent-reach

Verify and Uninstall

After running the install command, confirm that the skill manifest exists at the expected path:

ls ~/.claude/skills/agent-reach/SKILL.md

If Claude Code is installed and has created ~/.claude/skills, Agent Reach will now appear as an available skill when you ask Claude Code to search, read, or interact with supported platforms.

To remove the skill from all known locations, use the uninstall command:

agent-reach skill --uninstall

Summary

• Use agent-reach skill --install to register Agent Reach as an agent skill for Claude Code in one step.
• The installer in agent_reach/cli.py (lines 323–405) targets ~/.claude/skills, ~/.openclaw/skills, ~/.agents/skills, or $OPENCLAW_HOME/.openclaw/skills in that priority order.
• Installation copies SKILL.md (or SKILL_en.md) and the references/ directory without modifying any external tool configuration.
• Run agent-reach skill --uninstall to clean up all installed skill files.

Frequently Asked Questions

Where is the skill registration logic implemented in the Agent Reach source code?

The core registration logic lives in the _install_skill() function inside [agent_reach/cli.py](https://github.com/Panniantong/Agent-Reach/blob/main/agent_reach/cli.py#L323-L405), while the _cmd_skill dispatcher at lines 546–560 routes the CLI arguments to the install and uninstall helpers.

Can I force Agent Reach to install into a specific skills folder?

The installer chooses the first existing directory from its prioritized list. To force the generic path, create ~/.agents/skills manually before running agent-reach skill --install; otherwise the tool picks the first present location.

Does installing the skill modify Claude Code itself?

No. According to the source code, the installation only writes files to a target directory. It never modifies Claude Code binaries, configuration files, or any upstream tooling, which keeps the process non-intrusive and fully reversible.

Which files are included in the Agent Reach skill package?

The package loads from the skill directory via importlib.resources and includes the main manifest (SKILL.md or SKILL_en.md) plus the references/ subdirectory containing category-specific Markdown documentation.

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