
Paseo Handoff
When you need to hand off a task to a fresh agent, this packages up everything the next agent needs to know: what you tried, what failed, why decisions were made, and what constraints matter. It parses whether you want a worktree, which provider to use, then builds a self-contained briefing prompt covering task, context, current state, and acceptance criteria. The receiving agent starts cold, so the handoff is thorough by design. Useful when you're stuck, want a second opinion with full context, or need to parallelize work without explaining everything twice. Launches via Paseo and doesn't block by default.
- skills.sh installs
- 5.3K
- GitHub stars
- 23.7K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add getpaseo/paseo --skill paseo-handoff --agent claude-codeInstalls into .claude/skills of the current project.
Files
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.
Use the user's request and current conversation as input, including any arguments supplied with the skill invocation.
Prerequisites
Read the paseo skill. Call list_profiles before choosing the receiving agent. Do not create it until you have read the configured profiles and their notes.
Parsing arguments
- Agent profile — explicit profile name first; otherwise choose the profile whose
notesbest match the work. Materialize it intocreate_agentas described by the paseo skill. If no profile fits, use Paseo's provider discovery fallback. - Isolation — "in a worktree" / "worktree" → create a workspace with
isolation: "worktree", using a short branch name derived from the task. - Task description — anything else the user said.
The handoff prompt
The receiving agent has zero context. Include:
## Task
[Imperative description.]
## Context
[Why this task exists, required context.]
Sponsors
Details
- Repository
- github.com/getpaseo/paseo
- Category
- AI & Agent Building
- First seen
- May 16, 2026