handoff-receiver

Parse and execute Cursor handoffs using the normalized handoff schema with IMPLEMENT mode gating.

2|Updated Nov 15, 2025
One-click install
npx skills add https://github.com/grandinh/claude-chaos-express --skill handoff-receiver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff-receiver
Source: https://github.com/grandinh/claude-chaos-express/tree/main/.claude/skills/handoff-receiver
Command: npx skills add https://github.com/grandinh/claude-chaos-express --skill handoff-receiver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually parsing and acting on handoff documents from other AI agents (like Cursor) can be time-consuming and lead to missed context or errors. This Skill automates the interpretation and execution of these handoffs.

Core Features & Use Cases

  • Automated Handoff Parsing: Reads and interprets normalized handoff schemas from docs/ai_handoffs.md, extracting key information.
  • Contextual Execution: Executes next tasks from the handoff, leveraging context_files and repo_state for informed action.
  • Handoff Update: Automatically updates the handoff log with completed tasks and touched files, maintaining an accurate record.
  • Use Case: After Cursor completes a task and hands it off, simply ask this Skill to process the handoff, and it will automatically read the context, validate the tasks, and begin execution in IMPLEMENT mode.

Quick Start

Check if Cursor handed anything off and execute the next steps.

Frequently Asked Questions about handoff-receiver

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

FAQPage Schema
How do I execute a handoff from Cursor automatically?

Parse and execute incoming handoffs from Cursor by providing the normalized handoff schema. The Skill reads context files, validates acceptance criteria, and executes next tasks in IMPLEMENT mode with detailed logging of any issues encountered.

What information does the Skill extract from a Cursor handoff?

Handoff parsing extracts key task information, context files, repo state, and acceptance criteria from the normalized handoff schema in docs/ai_handoffs.md, then applies read-only analysis before execution.

Can I use this Skill to validate a handoff before executing it?

Yes. The Skill performs strict validation of acceptance criteria and context files in Phases 1-2 as read-only analysis, verifying repo state before proceeding to write-capable execution in Phases 3-4.

How does the Skill track completed handoff tasks?

After execution, the Skill automatically updates the handoff log with completed tasks and touched files, maintaining an accurate record while preserving original handoff data for reference.

What schema versions does this Skill support?

The Skill supports schema_version 1.0 and provides backward compatibility, ensuring handoffs from different Cursor versions are processed correctly with consistent validation.

When should I use this Skill in my AI collaboration workflow?

Use this Skill after Cursor completes a task and hands it off. It automatically reads context, validates tasks, and begins execution, keeping work flowing without manual parsing or missed context.