# execute_cloud_skill

active Cloud Skill에서 선언된 script component 하나를 격리된 execution engine으로 실행합니다.

- Canonical: https://docs.xmemo.dev/ko/docs/tools/execute-cloud-skill
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: aba94d94556b98106266c559e78f7c9d3f934fda4c6f83458f67a7a938bb42c9
- Edition-Digest: 573f0f0922e0d42d8ece9b803a2f37b01758666eb2939736716683fc1adb71af
- Source-Revision: sha256:23bbbd009c5356d1653ef90add53c2a5821b45798e2ded6d766cdffe5bd291f5

## Tool Reference: `execute_cloud_skill`

### Purpose

active Cloud Skill에서 선언된 script component 하나를 격리된 SandboxExecutionEngine을 통해 실행합니다.

### Parameters

- `script_path` (string, optional): 실행할 script component의 logical path 또는 component ID입니다.
- `slug` (string, optional, default: empty): active skill을 확인하는 데 사용하는 skill slug입니다.
- `skill_id` (string, optional, default: empty): slug 대신 사용하는 안정적인 skill identity입니다.
- `revision_id` (string, optional, default: empty): 선택적 revision pin입니다. 없으면 published revision, 그 다음 latest revision을 선택합니다.
- `input_args` (object, optional, default: empty object): script의 stdin으로 encode되는 JSON-compatible value입니다.
- `timeout_seconds` (integer, optional, default: 30): ExecutionLimits가 1–60초로 제한하는 실행 timeout입니다.

### Returns

kind='execution'인 JSON CloudSkillResponseEnvelope를 반환하며, data에는 execution_id, skill_id, revision_id, script_path, runtime, status, exit_code, stdout, stderr, truncation flags, optional output_data, duration_ms, memory_peak_bytes, cpu_time_ms, timestamps 및 error_kind가 들어 있습니다.

### Errors

- ACCESS_DENIED, SKILL_NOT_FOUND, or SKILL_ARCHIVED: caller scope에서 skill을 확인할 수 없습니다.
- REVISION_NOT_FOUND: 요청한 revision이 skill에 속하지 않거나 active revision이 없습니다.
- SCRIPT_NOT_FOUND or INVALID_COMPONENT_TYPE: path가 없거나 script가 아닌 component를 가리킵니다.
- SANDBOX_UNAVAILABLE: host에 working bubblewrap isolation driver가 없고 unsafe fallback이 비활성화되어 있습니다.
- EXECUTION_TIMEOUT, RESOURCE_EXHAUSTED, or SCRIPT_EXECUTION_ERROR: watchdog, resource limit 또는 script exit status가 실행을 종료했습니다.

### Examples

#### pin한 script component 실행



```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): 실행 전에 skill을 검색하고 revision/resource를 pin합니다.
- [save_cloud_skill](/docs/tools/save-cloud-skill): 실행할 수 있는 procedure와 script component를 생성합니다.
- [recall_context](/docs/tools/recall-context): 실행 task 주변의 bounded agent context를 구성합니다.

## script path와 revision으로 실행하기

active skill을 선택하고 재현성이 중요하면 revision을 pin하며 type이 script인 component를 지정합니다. 실행에는 memory:write가 필요하고 typed execution envelope을 반환합니다.