# Orca Per Workspace Env

> Configura, revisa, depura o valida recetas de entorno por-workspace de Orca: runtimes efímeros bajo demanda (sandboxes en la nube, VMs o locales) creados para cada workspace.

Fuente: https://skillsagentes.com/skills/stablyai/orca/orca-per-workspace-env
Markdown: https://skillsagentes.com/skills/stablyai/orca/orca-per-workspace-env.md

Repositorio: https://github.com/stablyai/orca
Autor: stablyai
Licencia: MIT
Actualizado: hace 2 meses
Coste de contexto: 133 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 orca-per-workspace-env --agent claude-code
# Cursor
npx -y skills add stablyai/orca --skill orca-per-workspace-env --agent cursor
# Codex
npx -y skills add stablyai/orca --skill orca-per-workspace-env --agent codex
# Gemini CLI
npx -y skills add stablyai/orca --skill orca-per-workspace-env --agent gemini
# Windsurf
npx -y skills add stablyai/orca --skill orca-per-workspace-env --agent windsurf
# Cline
npx -y skills add stablyai/orca --skill orca-per-workspace-env --agent cline
```

## Qué hace

- Actúa como stub de descubrimiento que carga la guía completa y versionada de entornos por-workspace desde el binario `orca`
- Resuelve qué ejecutable de Orca usar según la sesión (ORCA_CLI_COMMAND, orca-dev, orca-ide u orca)
- Ejecuta `ORCA skills get orca-per-workspace-env` para obtener instrucciones de setup, snapshots y `environmentRecipes`
- Ofrece un modo de arranque limitado con `ORCA status --json` y `orca vm recipe doctor` si el binario es antiguo

## Cuándo usarla

- Configurar, revisar, depurar o validar una receta de entorno por-workspace
- Arreglar una entrada `environmentRecipes` en `orca.yaml`
- Scaffolding de scripts de ciclo de vida de un proveedor
- Resolver un fallo de `orca vm recipe doctor`

## Qué la activa

- "Necesito configurar un entorno por workspace en Orca"
- "Ayúdame a arreglar mi entrada environmentRecipes en orca.yaml"
- "orca vm recipe doctor está fallando, ¿qué hago?"
- "Quiero scaffoldear los scripts de ciclo de vida del proveedor"

## Antes de instalar

- Requiere el binario `orca` (o variante orca-dev/orca-ide según la sesión) y, para aprovisionar recursos reales, aprobación explícita del usuario por el posible gasto.

## 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.

# Per-Workspace Environments

This discovery stub loads the version-matched guide from the Orca executable used for this session.

## 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 orca-per-workspace-env
```

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: [DevOps e infraestructura](https://skillsagentes.com/categorias/devops-infraestructura.md) — Despliegues, contenedores, IaC y flujos de gestión de incidentes.
- 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.
- [Orchestration](https://skillsagentes.com/skills/stablyai/orca/orchestration.md): 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.
- [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.

---

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