# execute_cloud_skill

Ejecuta un componente de script declarado de un Cloud Skill activo mediante el motor de ejecución aislado.

- Canonical: https://docs.xmemo.dev/es/docs/tools/execute-cloud-skill
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: aba94d94556b98106266c559e78f7c9d3f934fda4c6f83458f67a7a938bb42c9
- Edition-Digest: b6818eed191d4b477be779a0b1ded856a1bd2db87b6845848dc3331421e2019a
- Source-Revision: sha256:23bbbd009c5356d1653ef90add53c2a5821b45798e2ded6d766cdffe5bd291f5

## Tool Reference: `execute_cloud_skill`

### Purpose

Ejecuta un componente de script declarado de un Cloud Skill activo mediante SandboxExecutionEngine aislado.

### Parameters

- `script_path` (string, optional): Ruta lógica o ID del componente de script que se ejecutará.
- `slug` (string, optional, default: empty): Slug de la skill usado para resolver la skill activa.
- `skill_id` (string, optional, default: empty): Identidad estable de la skill como alternativa al slug.
- `revision_id` (string, optional, default: empty): Fijación opcional de revisión; si se omite, se selecciona primero la revisión publicada y después la última revisión.
- `input_args` (object, optional, default: empty object): Valores compatibles con JSON codificados en la entrada estándar del script.
- `timeout_seconds` (integer, optional, default: 30): Tiempo de espera de ejecución limitado por ExecutionLimits a 1–60 segundos.

### Returns

Un CloudSkillResponseEnvelope JSON con kind='execution' y data que contiene execution_id, skill_id, revision_id, script_path, runtime, status, exit_code, stdout, stderr, indicadores de truncamiento, output_data opcional, duration_ms, memory_peak_bytes, cpu_time_ms, marcas de tiempo y error_kind.

### Errors

- ACCESS_DENIED, SKILL_NOT_FOUND, or SKILL_ARCHIVED: no se puede resolver la skill dentro del ámbito del caller.
- REVISION_NOT_FOUND: la revisión solicitada no pertenece a la skill o no existe una revisión activa.
- SCRIPT_NOT_FOUND or INVALID_COMPONENT_TYPE: la ruta no existe o nombra un componente que no es un script.
- SANDBOX_UNAVAILABLE: el host no tiene un driver de aislamiento bubblewrap operativo y el fallback inseguro está desactivado.
- EXECUTION_TIMEOUT, RESOURCE_EXHAUSTED, or SCRIPT_EXECUTION_ERROR: el watchdog, los límites de recursos o el estado de salida del script finalizaron la ejecución.

### Examples

#### Ejecuta un componente de script fijado



```typescript
execute_cloud_skill({
  slug: "deployment-procedure",
  revision_id: "revision-id-from-root-recall",
  script_path: "scripts/check.py",
  input_args: { environment: "staging" },
  timeout_seconds: 30
})
```

### Related Tools

- [recall_cloud_skill](/docs/tools/recall-cloud-skill): Descubre la skill y fija la revisión/recurso antes de ejecutar.
- [save_cloud_skill](/docs/tools/save-cloud-skill): Crea el procedimiento y el componente de script que se pueden ejecutar.
- [recall_context](/docs/tools/recall-context): Reúne el contexto acotado del agente alrededor de la tarea de ejecución.

## Ejecuta mediante la ruta de script y la revisión

Elige una skill activa, fija una revisión cuando importe la reproducibilidad y nombra un componente cuyo tipo sea script. La ejecución requiere memory:write y devuelve un sobre de ejecución tipado.