Install in seconds
Install this skill
Copy the command and run it in your terminal. You can review the source before installing.
terminal
git clone https://github.com/jeremylongshore/claude-code-plugins-plus-skills

Works with Git. The repository opens in your current directory.

🔄
DevOpsPython

Handoff

by jeremylongshore

Manages two-session handoff packages: plan in one session, build in another, and review back in the first. Use for inspecting, picking up, or reviewing committed handoff packages across environments.

2.6K stars367 forksAdded 2026/07/19
View source on GitHubDownload ZIP
agent-skillsaiai-agentsanthropicautomationclaude-codeclaude-code-pluginsdeveloper-toolsdevopsllmmarketplacemcpplugin-marketplaceplugin-systemsaasskills

Documentation

README

Handoff

Operator interface for two-session execution: one session plans (session=two at the Step 0 gate), a second session in another environment builds, and the first session reviews. The lifecycle and package format are defined in ../hyperflow/session-handoff.md; this skill is the thin set of verbs over it (mirrors how /hyperflow:flush fronts the deferred-commit machinery).

Packages live at .hyperflow-handoff/<slug>/ (committed, so they travel via git). STATUS (planned → built → reviewed) is the single source of truth and decides which side of the handoff you are on.

Subcommands

list

Read-only. List every .hyperflow-handoff/*/ (excluding .archive/): slug · STATUS · on_complete · age. Group by status so the user sees what is awaiting build vs awaiting review.

status [<slug>]

Show the HANDOFF.md manifest + STATUS for one package (or all). When STATUS=built, also print the COMPLETION.md diff range and commit count. Read-only.

pickup <slug> — build side

Thin alias for starting the second-session build: invoke Skill with skill: dispatch and args: "<slug>". Dispatch's Step 1.0 rehydrates artefact/ into .hyperflow/, runs /hyperflow:scaffold if the cache is missing, builds the batches, writes COMPLETION.md + STATUS=built, and then deploys or stops per on_complete.

review <slug> — planning side

  1. Require STATUS=built (else: "handoff <slug> is <status> — nothing to review yet").
  2. Read COMPLETION.md → extract Diff range = <base>..<head>.
  3. Invoke Skill with skill: audit and args: "<base>..<head> level=3" (level=5 when the originating triage flow in HANDOFF.md was scientific or security). The audit dispatches the matching domain specialist reviewers over the second session's diff.
  4. On audit clean pass → fire the deploy gate (AskUserQuestion — Run /hyperflow:deploy? Yes / No, binary, no marker). On NEEDS_FIX → the audit fix-gate (Yes → /hyperflow:plan → /hyperflow:dispatch) handles it.
  5. Set STATUS=reviewed once the review is accepted.

complete <slug>

Mark the lifecycle done: set STATUS=reviewed (if not already) and archive the package to .hyperflow-handoff/.archive/<slug>/. Commit chore(handoff): archive <slug>.

Resolution

  • Default <slug> = the most-recently-modified package when omitted from status/pickup/review.
  • A package whose STATUS=planned is a build-side task (run pickup); built is a review-side task (run review). The session-start hook surfaces the right verb automatically.

Iron rules

  • Never edit the build's commits. review is read-only over the diff range; fixes flow through the audit fix-gate → scope → dispatch, never by amending the second session's commits.
  • Never force-push; never --no-verify. Auto-push failures surface the exact git push -u origin <branch>.
  • No AI attribution in any commit or package file.
  • Honors handoff.* config (autoPush, remote, packageDir).

Doctrine

Shared rules in ../hyperflow/DOCTRINE.md. Package contract + templates in ../hyperflow/session-handoff.md.

More from jeremylongshore

Other Claude Code skills by this author in the directory.

🛠️
1w ago

SKILL.md Authoring

Teaches how to create Claude Code skills using SKILL.md files, covering frontmatter schema, body structure, testing, and iteration. Use when you want to build or refine agent skills from scratch.
AI Engineering
+0%2.6K367
📝
1w ago

SKILL.md Authoring

Provides a structured guide for creating SKILL.md files with proper frontmatter, tool permissions, and trigger phrases. Use when building Claude Code plugins to ensure skills auto-activate correctly.
AI Engineering
+0%2.6K367
🤖
1w ago

Agency OS

Notion-as-source-of-truth dispatch board that manages AI tasks through a five-stage workflow (Suggestion to Done) and fans out approved To-Do items to parallel agents with per-task model selection.
Automation
+0%2.6K367
🔍
1w ago

Audit

Performs multi-level code review on recent changes, checking syntax, security, performance, and spec compliance. Offers to automatically apply findings via the fix gate that triggers planning and dispatch.
Quality
+0%2.6K367
⚙️
1w ago

Background Agents

Lists, shows, cancels, and prunes background agents fired by Hyperflow skills. Use to inspect agent status, collect results, or clean up old output buffers.
Automation
+0%2.6K367
🌉
1w ago

Hyperflow Bridge

Embeds hyperflow's behavioral doctrine (autonomy, intent-routing, commit cadence, role separation) into CLAUDE.md so it applies in Claude Code Desktop, web, or IDE extensions that don't load CLI plugins. Useful for consistent AI agent behavior across surfaces.
Automation
+0%2.6K367

More DevOps skills

Handoff is one of 80 DevOps skills cataloged on DirSkills.

Browse all DevOps skills →
🛡️
1w ago

License to Audit

Performs comprehensive security audits, threat modeling (STRIDE/PASTA), red/blue team analysis, OWASP checks, code review, incident response, and infrastructure security assessments.
DevOps
+0%44.1K6.5K
📎
1w ago

Add App Clip

Adds an iOS App Clip target to an Expo project, allowing a lightweight version of the app to be invoked via URL. Handles associated domains, AASA file hosting, and smart app banner setup.
DevOps
+0%44.1K6.5K
🔍
2w ago

Vercel Optimize

Audit deployed Vercel apps for cost and performance issues using production metrics, project configuration, code scans, and version-aware recommendations.
DevOps
43.1K6.8K