# Orchestration

> Usa la orquestación de Orca para coordinación multi-agente estructurada: mensajes en hilo, ask/reply bloqueante, dispatch de tareas, waits de worker_done/escalación, DAGs, gates de decisión y loops de coordinador.

Fuente: https://skillsagentes.com/skills/stablyai/orca/orchestration
Markdown: https://skillsagentes.com/skills/stablyai/orca/orchestration.md

Repositorio: https://github.com/stablyai/orca
Autor: stablyai
Licencia: MIT
Actualizado: hace 2 meses
Coste de contexto: 203 tok instalada, 1.1k tok al activarse, 1.1k tok con todos los archivos del bundle
Bundle: 1 archivo, 4 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add stablyai/orca --skill orchestration --agent claude-code
# Cursor
npx -y skills add stablyai/orca --skill orchestration --agent cursor
# Codex
npx -y skills add stablyai/orca --skill orchestration --agent codex
# Gemini CLI
npx -y skills add stablyai/orca --skill orchestration --agent gemini
# Windsurf
npx -y skills add stablyai/orca --skill orchestration --agent windsurf
# Cline
npx -y skills add stablyai/orca --skill orchestration --agent cline
```

## Qué hace

- Resuelve el ejecutable correcto de Orca para la sesión (ORCA_CLI_COMMAND, orca-dev, orca-ide u orca)
- Carga la guía completa y versionada con `ORCA skills get orchestration` antes de ejecutar comandos
- Habilita coordinación multi-agente estructurada: mensajes en hilo, ask/reply bloqueante, dispatch de tareas, waits de worker_done/escalación, DAGs de tareas, gates de decisión y loops de coordinador
- Ofrece un bootstrap acotado de solo lectura (status, task-list, terminal list) si el binario es antiguo y no reconoce `skills get`

## Cuándo usarla

- Necesitas coordinación multi-agente estructurada: mensajes en hilo, flujos ask/reply bloqueantes, dispatch de tareas
- Necesitas esperas de worker_done/escalación, DAGs de tareas, gates de decisión o loops de coordinador
- Necesitas descomponer trabajo entre agentes usando estado real del runtime de Orca

## Cuándo no

- El usuario pide un traspaso completo de propiedad ('hand off', 'handoff', 'handover', 'give this to another agent', 'another worktree') sin pedir supervisión, monitoreo, espera de resultados o coordinación de un DAG: usa orca-cli
- Control ordinario de terminal, prompts ligeros, comandos de shell, gestión de worktrees de Orca, lectura/espera de terminales, o automatización del navegador embebido: usa orca-cli
- Ventanas del navegador, webviews, UI de la app Orca o UI de escritorio fuera del navegador embebido de Orca: usa Computer Use

## Qué la activa

- "Coordina estas tres tareas con un DAG y espera a que cada worker termine"
- "Crea un gate de decisión antes de continuar con el despliegue"
- "Dispara tareas a varios agentes y notifícame cuando terminen"
- "Necesito un loop de coordinador que supervise el progreso de los workers"

## Antes de instalar

- Requiere el binario Orca (orca, orca-dev u orca-ide según la sesión) en ejecución, confirmado con `ORCA status --json`.

## Archivos

- SKILL.md — 4 KB

## SKILL.md

Reproducido tal cual desde stablyai/orca bajo MIT. Esta sección es el documento original y está en inglés.

# Orca Orchestration

This file is a discovery stub, not the usage guide. The full, version-matched Orca
orchestration reference is served by the `orca` binary itself — kept out of this file on
purpose so it can never drift from the binary that will actually run your commands.

Engage Orca orchestration whenever you need structured multi-agent coordination: threaded
messages, blocking ask/reply flows, task dispatch, worker_done/escalation waits, task DAGs,
decision gates, coordinator loops, or decomposing work across agents. Use the orca-cli skill
instead for full ownership handoffs ("hand off", "handoff", "handover", "give this to
another agent", "another worktree") when the user did not ask to supervise, monitor, wait
for results, or coordinate a DAG — and for ordinary terminal control, shell commands,
worktree management, and the built-in browser. Coordination requires real Orca runtime
state; never substitute a non-Orca subagent tool.

## Resolve the CLI for this session

Choose the executable once and reuse it for every later command:

- If the `ORCA_CLI_COMMAND` environment variable is set, use its value. Orca exports this
  for managed WSL sessions.
- Otherwise, in a dev checkout whose session exposes `ORCA_DEV_REPO_ROOT`, use `orca-dev`.
- Otherwise, on Linux outside an Orca-managed terminal, use `orca-ide`. Never run bare
  `orca` there — outside Orca's terminals it normally resolves to the
  GNOME Orca screen reader (`/usr/bin/orca`) and starts speech on the user's machine.
- Otherwise, use `orca`.

Below, `ORCA` is a placeholder for the executable you resolved. Substitute it before
running anything; do not create a shell variable or run `ORCA` literally. This works the
same way in POSIX shells, PowerShell, and cmd.exe.

If the selected executable cannot run, report its exact error and stop. Do not fall through
to another executable, which could silently target a different Orca build.

## Load the version-matched guide before running Orca commands

```text
ORCA skills get orchestration
```

That prints the compact, version-matched guide for the exact binary that will handle your
next commands. It covers the normal local coordinator loop. For a conditional action gate
such as remote placement, uncertain release recovery, or expanded DAG work, load only the
reference that gate names with
`ORCA skills get orchestration --reference references/<file>.md`
(`--references` lists the names). If that binary rejects `--reference`, run
`ORCA skills get orchestration --full` and read the named bundled reference before acting.

Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.

## Dónde encaja

- Categoría: [Automatización](https://skillsagentes.com/categorias/automatizacion.md) — Flujos de varios pasos que se ejecutan sin supervisión.
- Creador: [stablyai](https://skillsagentes.com/creators/stablyai.md) — 8 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Orca Cli](https://skillsagentes.com/skills/stablyai/orca/orca-cli.md): Usa el CLI público `orca` para gestionar worktrees, contextos de carpeta, terminales, repos, automations, artifacts, comentarios de worktree y el navegador embebido de la app Orca.
- [Linear Tickets](https://skillsagentes.com/skills/stablyai/orca/linear-tickets.md): Alias antiguo (legacy) del paquete para orca-linear; usa la CLI Linear de Orca vía orca linear ... para leer contexto de tickets, publicar avances, mover estados, adjuntar links de PR/MR y triagear tareas.
- [Orca Linear](https://skillsagentes.com/skills/stablyai/orca/orca-linear.md): Usa la CLI de Linear de Orca (`orca linear ...`) para leer contexto de tickets, publicar avances, mover estados, adjuntar enlaces de PR/MR y triagear tareas de Linear vinculadas, sin tratar el texto del ticket como instrucciones.
- [Computer Use](https://skillsagentes.com/skills/stablyai/orca/computer-use.md): Usa la CLI computer-use de Orca para inspeccionar y operar ventanas de apps de escritorio mediante árboles de accesibilidad, capturas de pantalla y acciones seguras de UI como clic, escritura y scroll.
- [Orca Emulator](https://skillsagentes.com/skills/stablyai/orca/orca-emulator.md): Controla un emulador/simulador móvil (iOS) desde Orca con la CLI `orca`: taps, gestos, tipeo, botones, cámara, permisos y árbol de accesibilidad, viendo la vista en vivo en Orca.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)