.claude/skills/handoff-coordinator/SKILL.md
Clean transitions between agents and sessions. Use when preparing handoffs, serializing state, bridging context between agents, or coordinating multi-agent workflows.
npx skillsauth add adaptationio/skrillz handoff-coordinatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Manages clean transitions between agents and sessions with state serialization and context bridging.
from scripts.handoff_coordinator import HandoffCoordinator
coordinator = HandoffCoordinator(project_dir)
package = await coordinator.prepare_handoff(
source_agent="coding-agent",
summary="Completed auth-001, starting auth-002"
)
await coordinator.execute_handoff(
package=package,
target_agent="coding-agent"
)
┌─────────────────────────────────────────────────────────────┐
│ HANDOFF WORKFLOW │
├─────────────────────────────────────────────────────────────┤
│ │
│ SOURCE AGENT │
│ ├─ Complete current work │
│ ├─ Save state to files │
│ ├─ Create handoff package │
│ └─ Signal ready for handoff │
│ │
│ COORDINATOR │
│ ├─ Validate state consistency │
│ ├─ Serialize handoff package │
│ ├─ Store in handoff file │
│ └─ Trigger target agent │
│ │
│ TARGET AGENT │
│ ├─ Load handoff package │
│ ├─ Restore context │
│ ├─ Verify state │
│ └─ Continue work │
│ │
└─────────────────────────────────────────────────────────────┘
{
"id": "handoff-20250115-103000",
"source_agent": "coding-agent",
"target_agent": "coding-agent",
"timestamp": "2025-01-15T10:30:00",
"state": {
"current_feature": "auth-002",
"completed_features": ["auth-001"],
"blockers": [],
"next_steps": ["Implement logout endpoint"]
},
"context": {
"recent_files": ["src/auth/login.ts"],
"git_hash": "abc1234",
"session_number": 5
},
"summary": "Completed auth-001, starting auth-002"
}
| Type | Description | Use Case | |------|-------------|----------| | Session | Same agent, new session | Context limit reached | | Agent | Different agent | Specialized task | | Parallel | Multiple targets | Split work | | Recovery | After failure | Error recovery |
references/HANDOFF-PROTOCOL.md - Protocol detailsreferences/AGENT-TRANSITIONS.md - Transition patternsscripts/handoff_coordinator.py - Core coordinatorscripts/state_serializer.py - State serializationscripts/context_bridge.py - Context bridgingscripts/handoff_protocol.py - Protocol implementationdevelopment
Setup secure web-based terminal access to WSL2 from mobile/tablet via ttyd + ngrok/Cloudflare/Tailscale. One-command install, start, stop, status. Use when you need remote terminal access, web terminal, browser-based shell, or mobile access to WSL2 environment.
development
Complete development workflows where Claude writes the code while Gemini and Codex provide research, planning, reviews, and different perspectives. Claude remains the main developer. Use for complex projects requiring expert planning and multi-perspective reviews.
development
Systematic progress tracking for skill development. Manages task states (pending/in_progress/completed), updates in real-time, reports progress, identifies blockers, and maintains momentum. Use when tracking skill development, coordinating work, or reporting progress.
testing
Comprehensive testing workflow orchestrating functional testing, example validation, integration testing, and usability assessment. Sequential workflow for complete skill testing from examples through scenarios to integration validation. Use when conducting thorough testing, pre-deployment validation, ensuring skill functionality, or comprehensive quality checks.