# Aiox Handoff

> Create an AIOX agent handoff artifact when switching personas. Use on agent switch, handoff, or /aiox-handoff.

- Skill: `synkraai/aiox-handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add synkraai/aiox-handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/synkraai/aiox-handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: synkraai (https://skillmd.com/u/synkraai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/synkraai/aiox-handoff

---


# AIOX Agent Handoff

When switching agents (`/aiox-*` skills), compact context into a handoff artifact.

## Write

Path: `.aiox/handoffs/handoff-{from}-to-{to}-{timestamp}.yaml`

```yaml
handoff:
  from_agent: "{id}"
  to_agent: "{id}"
  story_context:
    story_id: ""
    story_path: ""
    story_status: ""
    current_task: ""
    branch: ""
  decisions: []
  files_modified: []
  blockers: []
  next_action: ""
```

## Limits

- Max ~500 tokens, ≤5 decisions, ≤10 files, ≤3 blockers
- Discard previous agent full persona; keep only this artifact + new agent definition

Template: `.aiox-core/development/templates/agent-handoff-tmpl.yaml`