Agent skill · operations · getpaseo
paseo-handoff
Hand off the current task to another agent with full context. Use when the user says "handoff", "hand off", "hand this to", or wants to pass work to another agent.
Why this skill is useful
Adds a structured handoff template that ensures critical context and decisions are communicated effectively to a new agent, which the AI wouldn't generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 12,523 stars on the source repository.
What this skill does
Handoff Skill Transfer the current task — context, decisions, failed attempts, constraints — to a fresh agent. The receiving agent starts with zero context, so the handoff prompt must be a self-contained briefing. User's arguments: $ARGUMENTS Prerequisites Read the paseo skill. Call listprofiles before choosing the receiving agent. Do not create it until you have read the configured profiles and their notes. Parsing arguments 1. Agent profile — explicit profile name first; otherwise choose the profile whose notes best match the work. Materialize it into createagent as described by the paseo skill. If no profile fits, use Paseo's provider discovery fallback. 2. Isolation — "in a worktree" / "worktree" → create a workspace with isolation: "worktree", using a short branch name derived from the task. 3. Task description — anything else the user said. The handoff prompt The receiving agent has zero context. Include: Preserve task semantics. Investigate-only → "DO NOT edit files." Fix → "implement the fix." Refactor → "refactor, not rewrite." Carry the user's exact intent. Launch Prepare the handoff in a dedicated workspace: 1. Select the current workspace or call createworkspace with the requested isolation. 2. Call createagent with a [Handoff] <task> title, the briefing as initial prompt, and the selected workspaceId when explicit placement is needed. 3. Return the agent and workspace to the user, explaining that it remains in your subagent track until they detach it manually. Do not encode independence as a create mode and do not invoke CLI or wire-level detach operations. Detach is a user gesture in the subagents track. Do not wait or poll for the agent to finish.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills getpaseo/paseo-handoff