VividKit Crystal clear AI coding
VI
Choose Your Setup Get Started with AgentKit Continue with ClaudeKit Migrate from ClaudeKit to AgentKit Clean cutover from ClaudeKit What Is AgentKit? How AgentKit Works AgentKit Kits, Skills, Agents & Hooks AgentKit Runtime Support AgentKit Desktop App AgentKit Configuration AgentKit CLI Quick Reference AgentKit Skills Cheatsheet AgentKit Workflows AgentKit Statusline Update AgentKit CLI & Kits AgentKit Helper Clean reinstall of AgentKit AgentKit Troubleshooting What is ClaudeKit? ClaudeKit CLI Guide Command Finder Commands Cheat Sheet Workflow Recipes CLI Quick Reference Claude Mechanics Permission Modes ClaudeKit Hooks Coexistence ClaudeKit x Codex CK → Other coding tools How ClaudeKit Works Inside ClaudeKit Finding Your Unknowns Session Recovery Fix from Logs UI/UX Guide Accounts Switcher IDE Config Remote Control Codex App System Diagramming UI Review Gate Promotions Support VividKit

Quick Ref / Command

Engineer Kit

/ak:handover

Captured Agent Handover

Hand in-progress work to one selected coding runtime by producing or validating a handoff, wiring a deterministic single-job orchestration spec, dispatching through ak:orchestrate, and reporting the result.

01

Require runtime

02

Screen task text

03

Capture or load

04

Validate handoff

Rule 01

Compose ak:handoff and ak:orchestrate; do not duplicate their internals.

Rule 02

The user selects the runtime; the skill wires and validates, not “best agent” advice.

Rule 03

Reference artifacts and run logs by path instead of inlining them.

Execution Map

Core lanes from input to output, aligned with the command's real execution path.

01

Start

Input, scope, route

  1. 1 Require runtime Resolve --agent against the runtime catalog; there is no default and no silent substitution.
  2. 2 Screen task text Refuse task text that embeds credentials before writing any artifact.
02

Work

Agent / skill execution

  1. 3 Capture or load Invoke ak:handoff unless a valid existing --handoff PATH is supplied.
  2. 4 Validate handoff Check required H2 sections, first-safe-step marker, redaction patterns, and handoff-version before dispatch.
03

Verify

Gate, review, validation

  1. 5 Build spec Construct one single-job orchestration spec: prompt reads the artifact as context, task enum is chosen from next actions, effect is scoped-write, approval defaults to require.
  2. 6 Route model Pass --model only for CLI runtimes; reject --model with --agent internal because internal jobs omit model.
04

Close

Report, handoff, artifact

  1. 7 Dispatch Invoke ak:orchestrate and leave preflight, runtime matrix, capture, resume, and arbiter review to it.
  2. 8 Report pointers Print the handoff path, orchestrate run directory, runtime/model, job result, arbiter verification, produced artifact pointers, first safe step, next action, and blockers.

Syntax, arguments, subcommands

How to invoke the skill: syntax, positional arguments, shared options, then each subcommand with its own syntax and outcome.

Syntax

/ak:handover [task] --agent <id> [--cwd PATH] [--task TEXT] [--handoff PATH] [--model NAME] [--yes]

Arguments

[task]

Successor focus

Optional natural-language focus for the coding agent that continues the work. It is written into the handoff mission and the orchestrate job prompt; use --task TEXT as the flag form.

/ak:handover --agent claude-code "continue the OAuth callback fix"

Shared options

--agent <id>

Coding runtime

Required selected runtime such as claude-code, codex, opencode, cursor, or internal. It must resolve in the runtime catalog; the skill never picks a fallback silently.

/ak:handover --agent codex --task "implement the next action in the handoff"
--cwd PATH

Workspace root

Workspace root for the dispatched job. Defaults to the current workspace root and is passed to ak:orchestrate as cwd.

/ak:handover --agent codex --cwd . --task "implement the next action in the handoff"
--task TEXT

Flag task text

Alternative to the positional task text. If both are provided, the positional task wins and --task is ignored with a warning.

/ak:handover --agent codex --task "implement the next action in the handoff"
--handoff PATH

Existing handoff

Use an existing handoff artifact instead of generating a new one. The path must exist and pass schema and redaction validation before dispatch.

/ak:handover --agent cursor --handoff plans/handoffs/oauth-callback.md
--model NAME

CLI model

Model override for CLI-runtime jobs only. Rejected with --agent internal because internal jobs omit model.

/ak:handover --agent opencode --model anthropic/claude-sonnet-5
--yes

Approve continuation

Explicitly approve write or destructive continuation work by changing the generated job approval from require to inherit.

/ak:handover --agent opencode --model anthropic/claude-sonnet-5 --yes

Don't skip the required step

Each item contrasts a tempting shortcut with the required approach.

Tempting shortcut

Pick a fallback runtime if the requested one fails.

Do this instead

No silent substitution; report the blocker and suggest rerun with another --agent.

Tempting shortcut

Permission-bypass flags help the successor move faster.

Do this instead

Runtime-specific bypass flags are refused by this skill.

Sample Prompt

Concrete invocations for each flag, subcommand, mode, or route available in the live workflow.

Generate handoff and dispatch Recommended 
/ak:handover --agent claude-code "continue the OAuth callback fix"
Use when:
You need a chosen coding runtime to continue the current work from a captured continuation contract.
Expected:
Runs ak:handoff first, validates the artifact schema and redaction state, builds one claude-code job with approval required, invokes ak:orchestrate, then reports the handoff and run paths.
Dispatch an existing handoff 
/ak:handover --agent cursor --handoff plans/handoffs/oauth-callback.md
Use when:
A handoff artifact already exists and should be validated and handed to a specific runtime without recapturing.
Expected:
Skips fresh capture, checks the supplied file for required H2 sections, first-safe-step marker, version, and raw-secret patterns, then dispatches a single cursor job through orchestrate.
Set cwd and task text 
/ak:handover --agent codex --cwd . --task "implement the next action in the handoff"
Use when:
The successor should run in a specific workspace root and receive an explicit task string in the orchestrate prompt.
Expected:
Uses the current workspace as the orchestrate cwd, includes the task text in the handoff mission and job prompt, maps the routing enum from next actions, and keeps default scoped-write approval.
CLI model override with approval 
/ak:handover --agent opencode --model anthropic/claude-sonnet-5 --yes
Use when:
A CLI runtime should use a particular model and the user has explicitly approved write continuation.
Expected:
Passes the model only because opencode is a CLI runtime, flips the generated job approval to inherit, preserves scoped-write isolation, and still leaves preflight and arbiter review to ak:orchestrate.

Handled Scope

  • Single-job orchestration specs
  • Runtime-catalog handover
  • Handoff schema validation
  • Approval and isolation wiring

Artifacts Produced

Handover result

Pattern

Handoff artifact, orchestrate run, runtime, model, job result, verification, produced artifact pointers, first safe step, next action, unresolved.

The report is a pointer summary; handoff bodies, stdout, and logs stay referenced by path.

Related skills

Next