skills.rest
leandro-br-dev
leandro-br-devCOMMUNITY
Explore all skills by this author →
GitHub

switch-agent

Load selected CLAUDE.md and skills into .claude/ to switch agent profiles.

Updated Aug 27, 2026
Search Tags:#automation#workflow#claude#agent#sub-agents#profile#switch
One-click install
npx skills add https://github.com/leandro-br-dev/charhub --skill switch-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: switch-agent
Source: https://github.com/leandro-br-dev/charhub/tree/main/docs/agents/skills/agent-switching
Command: npx skills add https://github.com/leandro-br-dev/charhub --skill switch-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Switch between agent profiles by loading the selected CLAUDE.md and the corresponding skills and sub-agents into the .claude/ directory, enabling a quick context switch between roles.

Core Features & Use Cases

  • Loads the agent profile into CLAUDE.md and sets up the correct skill set.
  • Restores agent-specific sub-agents and global skills to provide the full context for the chosen role.
  • Supports switching between coder, reviewer, and planner efficiently for collaborative workflows.

Quick Start

From the project root, switch to the desired agent profile using the agent-switching workflow to apply the new profile immediately.

Frequently Asked Questions about switch-agent

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

FAQPage Schema
How do I switch between agent profiles like coder, reviewer, or planner in Claude?▼

To switch agent profiles, load the selected CLAUDE.md and corresponding skills into the .claude/ directory. This enables quick context switching between roles like coder, reviewer, and planner for collaborative workflows.

Can I reconfigure Claude sub-agents and skills without losing my current project state?▼

Yes, you can reconfigure sub-agents and global skills while preserving your current state. The profile switch executes via the project root script scripts/agents/setup-agent.sh to apply the new agent context safely.

What is the best way to manage multiple agent roles within a single Claude project?▼

The best way to manage multiple agent roles is switching profiles on demand. Loading a specific profile restores agent-specific sub-agents and global skills to provide the full context needed for the chosen role.

Do I need a specific directory structure to switch agent contexts dynamically?▼

Yes, dynamic agent switching requires a valid agent request and a project root containing the scripts/agents/setup-agent.sh script. It loads the profile configurations directly into the .claude/ directory.

Why does my Claude agent profile lack the correct skills after switching roles?▼

If the correct skills are missing after switching roles, the profile switch failed to load the corresponding skills and sub-agents into the .claude/ directory. Ensure you execute the setup-agent.sh script from the project root.

Related Skills

Explore More Software Engineering Skills→
blueif16blueif16

create-command

Create slash command files and initialize plugin structure in Claude plugins.

Community
Basic
dotBeepsdotBeeps

quest

Coordinate subagent work across ally roles with dispatch modes.

Community
Advanced
evanfang0054evanfang0054

deepagents-subagents

Create and manage sub-agents with deepagents and LangGraph for task delegation.

Community
Advanced
ShmurdocShmurdoc

setup-deploy

Detect deploy platforms and write deployment settings to CLAUDE.md.

Community
Intermediate