From crew
Use when delegating or concluding substantial work so tasks, ownership, risks, and next steps are explicit and easy to inspect.
How this skill is triggered — by the user, by Claude, or both
Slash command
/crew:writing-task-handoffsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use this skill whenever work passes between lead, builder, reviewer, researcher, or the user.
Use this skill whenever work passes between lead, builder, reviewer, researcher, or the user.
Without a clean handoff, the next agent (or the user) starts blind — they waste time rediscovering context that was already known. The handoff should be good enough that a new teammate can continue without guessing.
Include:
light | standard (default: standard)Use size: light for trivial tasks (typo fixes, one-line config changes, variable renames) — the specialist skips the artifact write but still emits the structured completion message. Use size: standard (default) for anything substantive.
The lead is responsible for populating files, call_sites, and design_notes via its own built-in exploration (Explore/Plan subagents). Specialists cannot delegate exploration, so a thin handoff forces them to grep from scratch inside their own context budget. If a specialist receives a thin handoff, it should emit a help_request (see the protocol's Help Request section) rather than compensate silently.
A good handoff is:
These waste the user's time by forcing the next agent to re-discover what should have been recorded:
files — specialist is forced to grep from scratch, wasting their context budgetcall_sites when the change is cross-cutting — specialist cannot see where the affected logic is invokeddesign_notes — specialist has to rediscover decisions, edge cases, and constraints the lead already knewWhen persisting a handoff, prefer:
.claude/artifacts/crew/handoffs/Preferred command:
node "${CLAUDE_PLUGIN_ROOT}/scripts/crew.mjs" write-handoff --repo "$PWD" --title "<short title>" ...Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub alex-radaev/engineering-os --plugin crew