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.