handoff

Distills a conversation into a self-contained work-item for downstream agents.

5|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/ai-hero/hero-skills --skill handoff-ai-hero
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/ai-hero/hero-skills/tree/main/skills/handoff
Command: npx skills add https://github.com/ai-hero/hero-skills --skill handoff-ai-hero

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you stop mid-task or hand work to another agent or teammate, all the context, decisions, and reasoning from the current session are lost. This Skill packages everything a fresh session needs into one self-contained work-item so no one has to re-ask questions the conversation already answered. ## Core Features & Use Cases - Conversation distillation: Extracts the goal, decisions with their reasoning, completed work, remaining steps, gotchas, and acceptance criteria into a structured .plans/ work-item. - Tracker integration: Optionally files the item to GitHub Issues via gh or to Linear via MCP tools, with cross-linking between the tracker and the local store. - Cross-repo handoff: Files work to a different repository's tracker with repo-local references rewritten for the receiving team, plus a local stub tracking the dependency. - Use Case: You spent a session designing a payment-retry migration but ran out of time. Run the handoff command to capture every decision and open question, then let a fresh agent execute it ticket-to-merge later. ## Quick Start Ask the assistant to hand off the current work by running the handoff skill with an optional title, for example to package the migration follow-ups into a work-item.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I hand off unfinished work to another AI agent session?▼

Run the handoff skill to distill the current conversation into a self-contained work-item in the .plans/ store. The item captures goals, decisions with reasoning, remaining work, and acceptance criteria so a fresh session can execute it without prior context.

How do I file a work-item to GitHub Issues from a conversation?▼

Pass the --issue flag to the handoff skill. It reads the project management setting from HERO.md and runs gh issue create with the work-item as the body, then cross-links the issue URL back into the local item.

Can I hand off work to a different GitHub repository?▼

Yes, use the --repo OWNER/NAME flag. The skill verifies the target repo, rewrites repo-local references like paths and PR numbers for the receiving team, files an issue there, and keeps a cross-linked stub in your local .plans/ store.

Does the handoff skill work with Linear instead of GitHub Issues?▼

Yes, when HERO.md configures Linear as the tracker, the skill creates issues through the Linear MCP tools instead of the gh CLI. For cross-repo handoffs to Linear teams, you confirm the target team since a repo name alone does not identify it.

Why is the .plans directory git-ignored and not committed?▼

The .plans/ store is private and repo-local by design, so it is never committed or pushed. Sharing work happens deliberately through the --issue or --repo flags, which file items to a tracker that teammates can see.