skills.rest
SynkraAI
SynkraAIOFFICIAL
Explore all skills by this author →
GitHub

aiox-handoff

Creates a compact YAML handoff artifact when switching between AIOX agent personas.

3.1k|952|Updated Dec 9, 2025
Search Tags:#YAML#agent handoff#Workflow#context compaction#AIOX#persona switching#Multi-Agent
One-click install
npx skills add https://github.com/SynkraAI/aios-core --skill aiox-handoff
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aiox-handoff
Source: https://github.com/SynkraAI/aios-core/tree/main/.grok/skills/aiox-handoff
Command: npx skills add https://github.com/SynkraAI/aios-core --skill aiox-handoff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When switching between specialized AIOX agents mid-workflow, context is lost and the new agent starts blind. This Skill compresses the current working state into a small, structured handoff artifact so the next agent can resume work without reloading the full previous persona.

Core Features & Use Cases

  • Structured Handoff Artifact: Writes a YAML file to .aiox/handoffs/handoff-{from}-to-{to}-{timestamp}.yaml capturing story context, decisions, modified files, blockers, and the next action.
  • Token-Bounded Context: Enforces strict limits (max ~500 tokens, up to 5 decisions, 10 files, and 3 blockers) so the handoff stays cheap to load.
  • Persona Reset: Discards the previous agent's full persona, keeping only the handoff artifact plus the new agent definition.
  • Use Case: While working with a developer agent on a story, you switch to a QA agent via /aiox-qa; the Skill records the story status, branch, and pending task so QA continues exactly where development stopped.

Quick Start

Invoke the aiox-handoff skill to create a handoff artifact before switching from the current agent to the next AIOX persona.

Frequently Asked Questions about aiox-handoff

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

FAQPage Schema
How do I hand off context between AIOX agents?▼

Invoke the aiox-handoff skill or run /aiox-handoff before switching agents. It writes a YAML artifact to .aiox/handoffs containing story context, decisions, modified files, blockers, and the next action for the incoming agent.

What information does an AIOX agent handoff artifact contain?▼

The artifact includes from_agent and to_agent IDs, story context (story ID, path, status, current task, branch), plus lists of decisions, modified files, blockers, and a next_action field.

What are the size limits of the handoff artifact?▼

The handoff is capped at roughly 500 tokens, with at most 5 decisions, 10 modified files, and 3 blockers. Anything beyond these limits is discarded to keep the artifact cheap to load.

Does the previous agent persona persist after a handoff?▼

No. The previous agent's full persona is discarded after the handoff. Only the compact handoff artifact and the new agent definition remain in context.

Where are AIOX handoff files stored?▼

Handoff files are written to .aiox/handoffs/ using the naming pattern handoff-{from}-to-{to}-{timestamp}.yaml, based on the template at .aiox-core/development/templates/agent-handoff-tmpl.yaml.

Related Skills

Explore More Software Engineering Skills→
SynkraAISynkraAI
3.1k

aiox-master

Create and modify AIOX framework agents, tasks, and workflows.

Official
Advanced
garyjgaryj

pickup

Load a handoff file from .claude/handoffs to resume work.

Community
Basic
samwelmungasamwelmunga

reconcile

Synchronize project management board status with git history and documentation artifacts.

Community
Advanced
bhaumikmaanbhaumikmaan
3

context-summarization

Summarize conversation sessions into structured artifacts with code snippets and pending tasks.

Community
Advanced