Skill Installation

The AgenTopology skill runs inside Claude Code as an interactive builder. Install the agentopology package globally, then symlink the skill into your project.

Step 1: Install the package

npm install -g agentopology

Step 2: Symlink the skill into your project

From your project root, create the skills directory and symlink:

mkdir -p .claude/skills && ln -s $(npm root -g)/agentopology/.claude/skills/agentopology .claude/skills/agentopology

This creates a symlink at .claude/skills/agentopology pointing to the globally installed skill files.

Step 3: Invoke the skill

Open Claude Code in your project and use the skill in one of two ways:

By slash command:

/agentopology

By describing what you want:

Tell Claude Code what agent team you need. If the skill is installed, it will recognize the request and activate automatically.

For example:

"I need a code review pipeline with a researcher, writer, and reviewer"

The skill will pick up the request and walk you through building the topology.

Verify the installation

After symlinking, you can verify the skill is accessible:

ls -la .claude/skills/agentopology

You should see a symlink pointing to the global agentopology package.

Troubleshooting

Symlink points to nothing: Make sure agentopology is installed globally. Run npm list -g agentopology to check.

Skill not recognized in Claude Code: Restart Claude Code after creating the symlink. The skill registry is loaded on startup.

Permission errors: If npm root -g points to a system directory, you may need to configure npm to use a user-writable prefix. See the npm docs for details.

What's next

With the skill installed, walk through building your first topology interactively.