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.