What is the difference between blocking and enhancement priorities?

Blocking markers indicate that the current development flow cannot proceed until the request is addressed, while enhancement markers suggest improvements that are not critical for immediate functionality.

What are Agent Handoff Markers?

They are standardized, structured comments embedded in source code that allow AI agents to request specific work from other agents, providing requirements and context asynchronously.

Can these markers be used for human-to-agent communication?

Absolutely. Developers can use the same structured syntax to leave precise instructions for Claude to pick up and process during its next session.

Do I need to manually delete markers when finished?

The best practice is to convert them to an '@AGENT-HANDOFF-MARKER-COMPLETE' status, which provides a historical record of what was implemented and by whom.

How do I find pending handoffs in my project?

You can use the built-in /handoffs command or search your codebase for the '@AGENT-HANDOFF-MARKER' string using Grep to see all active requests.

Agent Handoff Markers

Name: Agent Handoff Markers
Author: laurigates

bylaurigates

•

Collaboration Tools

Implements structured inline comments for asynchronous coordination and work tracking between multiple AI agents.

About

This skill introduces a standardized syntax for cross-agent communication within source code, allowing Claude and other AI agents to leave detailed work requests, requirements, and context for one another. By using structured markers like @AGENT-HANDOFF-MARKER, it enables non-linear development workflows, reduces context switching, and creates a clear audit trail of inter-agent tasks without requiring real-time interaction. It is particularly useful for complex, multi-agent projects where specialized agents—such as those focused on UX, backend architecture, or security—need to hand off specific implementation details or define constraints for downstream work.

Key Features

Rich context preservation via file references, constraints, and requirement lists
Integrated priority levels for triage, including 'blocking' and 'enhancement'
Standardized marker syntax for structured inter-agent work requests
Automated scanning and discovery of pending tasks using Regex/Grep integration
3 GitHub stars
Detailed completion tracking with @AGENT-HANDOFF-MARKER-COMPLETE tags

Use Cases

Coordinating specialized tasks between UI design agents and frontend implementation agents
Flagging code sections that require specialized security audits or accessibility reviews
Managing asynchronous development workflows where tasks are discovered and processed across different sessions

About

Key Features

Rich context preservation via file references, constraints, and requirement lists
Integrated priority levels for triage, including 'blocking' and 'enhancement'
Standardized marker syntax for structured inter-agent work requests
Automated scanning and discovery of pending tasks using Regex/Grep integration
3 GitHub stars
Detailed completion tracking with @AGENT-HANDOFF-MARKER-COMPLETE tags

Use Cases

Coordinating specialized tasks between UI design agents and frontend implementation agents
Flagging code sections that require specialized security audits or accessibility reviews
Managing asynchronous development workflows where tasks are discovered and processed across different sessions