getpaseo avatar

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-code

Installs 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

  1. Agent profile — explicit profile name first; otherwise choose the profile whose notes best match the work. Materialize it into create_agent 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:

## 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

More from getpaseo/paseo

All 8
1browser-use avatarremote-browserbrowser-use/browser-useControls a local browser from a sandboxed remote machine. Use when the agent is running in a sandbox (no GUI) and needs to navigate websites, interact with web 4.9Kskills.sh installs
2affaan-m avatarinherit-legacy-styleaffaan-m/eccLegacy-project style inheritance skill. Use when the user types /inherit-legacy-style, or when onboarding an AI coding agent onto a hand-written legacy project 4.8Kskills.sh installs
3forcedotcom avatarmobile-apps-createforcedotcom/sf-skillsThe entry point for building any Salesforce native mobile app on iOS or Android. TRIGGER when the user says: "build a Salesforce iOS app", "add Salesforce login4.8Kskills.sh installs
4claude-office-skills avatarlead-routingclaude-office-skills/skillsIntelligent lead assignment and routing - AI-powered scoring, territory mapping, round-robin distribution, and workload balancing4.7Kskills.sh installs
5thedotmack avatarweekly-digeststhedotmack/claude-memGenerate a serial week-by-week narrative digest of a project's full claude-mem timeline. Splits the timeline into per-ISO-week files, then runs one consecutive 4.3Kskills.sh installs
6bytedance avatarclaude-to-deerflowbytedance/deer-flowInteract with DeerFlow AI agent platform via its HTTP API. Use this skill when the user wants to send messages or questions to DeerFlow for research/analysis, s3.9Kskills.sh installs