handoff-to-agent

Reassign tasks to eligible sub-agents within can_dispatch_to constraints.

6|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Acosmi/CrabClaw --skill handoff-to-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff-to-agent
Source: https://github.com/Acosmi/CrabClaw/tree/main/docs/skills/tools/subagents/handoff-to-agent
Command: npx skills add https://github.com/Acosmi/CrabClaw --skill handoff-to-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables seamless delegation of tasks from one sub-agent to another within a contract, ensuring load balancing and clear ownership.

Core Features & Use Cases

  • Task handoff: Offloads a task from the current agent to a target sub-agent listed in the can_dispatch_to list.
  • Context propagation & audit: Passes necessary context and records the handoff reason for traceability.
  • Policy-safe coordination: Respects safety constraints such as scope, access and approval rules to prevent unsafe actions.

Quick Start

Specify the target_skill_name and task to hand off to the designated sub-agent.

Frequently Asked Questions about handoff-to-agent

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

FAQPage Schema
How do I delegate tasks to another sub-agent within a contract?

To delegate tasks to another sub-agent, you specify the target_skill_name and the task payload. The target sub-agent must be listed in the can_dispatch_to constraints to ensure policy-safe coordination and load balancing.

How does agent orchestration handle context transfer during task reassignment?

Agent orchestration handles context transfer by propagating necessary task data to the target sub-agent. It also records an optional handoff reason and applies an input_filter to maintain an audit trail and ensure workflow security.

What is the best way to offload work from one agent to another for load balancing?

The best way to offload work for load balancing is reassigning the task to an eligible sub-agent. This respects scope constraints, transfers required context, and establishes clear ownership for the offloaded task.

Can I use an input_filter to restrict data during a sub-agent handoff?

Yes, you can use an optional input_filter to restrict data during a sub-agent handoff. This feature supports auditing and safety by preventing unsafe actions and ensuring only necessary context is propagated.

Why does task transfer fail when the target sub-agent is not authorized?

Task transfer fails when the target sub-agent is not authorized because policy-safe coordination requires the target_skill_name to be explicitly listed in the can_dispatch_to list. This constraint prevents unsafe actions and unauthorized scope access.