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

> Easily register Agent Reach as an agent skill for Claude Code using the CLI. Run agent-reach skill --install to automatically copy skill manifests and references, streamlining your workflow.

- Repository: [Pnant/Agent-Reach](https://github.com/Panniantong/Agent-Reach)
- Tags: how-to-guide
- Published: 2026-06-06

---

**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`](https://github.com/Panniantong/Agent-Reach/blob/main/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:

```bash
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)](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:

```bash
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`](https://github.com/Panniantong/Agent-Reach/blob/main/SKILL_en.md) for English environments; otherwise falls back to [`SKILL.md`](https://github.com/Panniantong/Agent-Reach/blob/main/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:

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

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

```bash
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`](https://github.com/Panniantong/Agent-Reach/blob/main/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`](https://github.com/Panniantong/Agent-Reach/blob/main/SKILL.md) (or [`SKILL_en.md`](https://github.com/Panniantong/Agent-Reach/blob/main/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)](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`](https://github.com/Panniantong/Agent-Reach/blob/main/SKILL.md) or [`SKILL_en.md`](https://github.com/Panniantong/Agent-Reach/blob/main/SKILL_en.md)) plus the `references/` subdirectory containing category-specific Markdown documentation.