add-agent

Append a new agent entry to the agent_roster TOML configuration.

32|6|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/FISHers6/clawBro --skill add-agent-fishers6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-agent
Source: https://github.com/FISHers6/clawBro/tree/main/.claude/skills/add-agent
Command: npx skills add https://github.com/FISHers6/clawBro --skill add-agent-fishers6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines adding a new CLI coding agent to clawBro by guiding the user through naming, mention triggers, backend selection, optional workspace and persona configuration, and safely appending the correct TOML to the agent_roster in the user's config.

Core Features & Use Cases

  • Guided configuration: Collects agent name, mention aliases, backend_id, optional workspace_dir and persona_dir, and optional default channel binding.
  • Safe write operations: Backs up the existing ~/.clawbro/config.toml, appends the generated [[agent_roster]] and [[binding]] TOML blocks, and validates the change by starting the gateway and checking its health endpoint.
  • Real-world use: Quickly register a project-scoped code assistant or a persona-driven research assistant for group chats and channel defaults.

Quick Start

Add a new agent named rex with mentions @rex and @Rex using backend native-main and workspace /Users/you/projects.

Frequently Asked Questions about add-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new coding agent to my clawBro configuration file?

Adding a new agent involves appending a [[agent_roster]] TOML block to your ~/.clawbro/config.toml file. The setup process requires specifying the agent name, mention aliases, backend_id, and optional workspace and persona directories to register the CLI coding agent.

Can I configure channel bindings and persona directories when registering an agent?

Yes, you can configure channel bindings and persona directories when registering an agent. The agent setup process supports creating persona directories if requested and appending [[binding]] TOML blocks to set default channel bindings for chat and gateway integrations.

Does clawBro support both native and ACP backends for onboarding coding agents?

clawBro supports both native and ACP backends for onboarding coding agents. The configuration process validates the existence of the specified backend_id before safely appending the agent entry to the roster and applying the changes to the config.toml file.

What is the safest way to modify the agent_roster TOML configuration?

The safest way to modify the agent_roster TOML configuration is by backing up the existing ~/.clawbro/config.toml file before appending new agent blocks. After writing the changes, a gateway health check is performed to validate the configuration update.

Why does my gateway health check fail after updating the config.toml file?

A gateway health check can fail after updating config.toml if the specified backend_id does not exist or if the TOML syntax in the appended [[agent_roster]] block is invalid. The agent registration process validates backend existence and checks the health endpoint to prevent configuration errors.