sail-voyage

Instrument AI agent workflows with Sail Voyage traces and structured execution attribution.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/sailresearchco/sail-skills --skill sail-voyage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sail-voyage
Source: https://github.com/sailresearchco/sail-skills/tree/main/plugins/sail/skills/sail-voyage
Command: npx skills add https://github.com/sailresearchco/sail-skills --skill sail-voyage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers instrument long-running AI agents so their execution can be observed as structured Sail Voyages instead of opaque background processes.

Core Features & Use Cases

  • Voyage Instrumentation: Guides the creation of runs, agents, spans, and events that accurately represent agent workflow execution.
  • Attribution and Debugging: Helps connect model calls, Sailbox executions, artifacts, and multi-agent activities to the correct workflow ownership.
  • Production Workflow Design: Supports building reliable research agents, code review systems, support workflows, evaluations, and other recurring agent processes with lifecycle tracking.

Quick Start

Ask the sail-voyage skill to instrument my background agent workflow as a Sail Voyage with traceable agents, spans, events, and execution evidence.

Frequently Asked Questions about sail-voyage

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

FAQPage Schema
How do I trace multi-agent workflow execution for debugging?

Multi-agent workflow tracing requires instrumenting background processes with structured Sail Voyages, creating observable runs, spans, and events that capture execution attribution for accurate debugging.

What is agent tracing and when do I need it for long-running agents?

Agent tracing is the instrumentation of long-running AI execution to capture lifecycle states. You need it when background agents operate as opaque processes, preventing you from connecting model calls and artifacts to workflow ownership.

How do I instrument sandbox execution to track agent activity?

Instrument sandbox execution by applying Sail SDK lifecycle management to track Sailbox executions, logging events, and attributing artifacts to the correct agent spans within the workflow.

Can I use workflow instrumentation for code review and evaluation systems?

Yes, workflow instrumentation supports building reliable recurring agent processes like code review systems and evaluations by providing lifecycle tracking and terminal state handling for production workflows.

What's the best way to handle terminal states in multi-agent observability?

Handling terminal states in multi-agent observability involves using Sail SDK lifecycle management to properly close runs and spans, ensuring execution evidence and final agent states are captured correctly.