# save_cloud_skill

Guarda o actualiza un Cloud Skill reutilizable y crea su siguiente revisión versionada.

- Canonical: https://docs.xmemo.dev/es/docs/tools/save-cloud-skill
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: 04d9414473b38ac4dc5cc2f5060d7c6b004a36ed2d57cf20fbda34994c123a3f
- Edition-Digest: 2a0907f876aa81c4f624d7c58cb3fafdf133be95a554a00145b23d2356104dd7
- Source-Revision: sha256:718059b6bf8760a2fbcf899877706dcb1219cbf46ea3053aecd788d1274ab789

## Tool Reference: `save_cloud_skill`

### Purpose

Crea o actualiza un Cloud Skill reutilizable y produce la siguiente revisión inmutable de sus instrucciones y componentes tipados.

### Parameters

- `name` (string, required): Nombre legible de la skill; los nombres vacíos se rechazan.
- `instructions` (string, required): Cuerpo del procedimiento raíz; es obligatorio y está limitado a 64 KiB después de la codificación UTF-8.
- `slug` (string, optional, default: derived from name): Identificador opcional de la skill en minúsculas que cumple el contrato de slug de 1–64 caracteres.
- `description` (string, optional, default: empty): Texto opcional de descubrimiento devuelto por el descubrimiento de consultas de Level 0.
- `publish` (boolean, optional, default: true): Intención de publicación; el ámbito personal puede publicar directamente, mientras que el ámbito de equipo crea una revisión propuesta.
- `components_json` (JSON array string, optional, default: []): Objetos de componentes opcionales con type, logical_path, content o artifact_ref, mime_type y metadata; como máximo 50, y cada cuerpo de content está limitado a 128 KiB.

### Returns

Un CloudSkillResponseEnvelope JSON con object='cloud_skill', schema_version='xmemo.cloud_skill.v1', kind='root', render_status, warnings y data que contiene skill_id, slug, name, description, revision_id, revision_number, instructions, canonical_hash y un manifiesto de recursos tipados.

### Errors

- Authorization failure: el token MCP carece de memory:write o el caller no puede escribir en el ámbito personal/equipo resuelto.
- Validation failure: name o instructions está vacío, el slug no es válido o el cuerpo de instrucciones supera 64 KiB.
- Component validation failure: components_json no es un array JSON, una ruta de componente está vacía, es absoluta, similar a traversal, reservada o duplicada, el type no es válido o un componente supera 128 KiB.
- Scope lifecycle: la publicación personal es directa; la publicación de equipo se almacena como propuesta y requiere el flujo de revisión del equipo.

### Examples

#### Publica un procedimiento personal



```typescript
save_cloud_skill({
  name: "deployment-procedure",
  instructions: "Check the release, run the smoke test, and report the result.",
  slug: "deployment-procedure",
  description: "A bounded deployment verification procedure",
  publish: true
})
```

### Related Tools

- [recall_cloud_skill](/docs/tools/recall-cloud-skill): Descubre la skill, carga su manifiesto raíz o lee un recurso fijado después de guardarla.
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): Ejecuta un componente de script declarado solo después de recuperar la revisión prevista.
- [remember](/docs/tools/remember): Usa la memoria durable ordinaria cuando no se necesite un procedimiento reutilizable.

## Publica solo un procedimiento revisado

Proporciona instrucciones duraderas y componentes tipados opcionales. Mantén las credenciales y el material privado fuera del cuerpo de la skill; la herramienta guarda el procedimiento en el ámbito personal o de equipo autenticado.