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.