# save_cloud_skill

Salve ou atualize um Cloud Skill reutilizável e crie sua próxima revisão versionada.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/save-cloud-skill
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: 04d9414473b38ac4dc5cc2f5060d7c6b004a36ed2d57cf20fbda34994c123a3f
- Edition-Digest: 31d432ea585593e14e320961d286563eb642aeab3dba48a0fabb659f3ca5d470
- Source-Revision: sha256:718059b6bf8760a2fbcf899877706dcb1219cbf46ea3053aecd788d1274ab789

## Tool Reference: `save_cloud_skill`

### Purpose

Crie ou atualize um Cloud Skill reutilizável e produza a próxima revisão imutável de suas instruções e componentes tipados.

### Parameters

- `name` (string, required): Nome legível do skill; nomes vazios são rejeitados.
- `instructions` (string, required): Corpo do procedimento raiz; é obrigatório e limitado a 64 KiB após a codificação UTF-8.
- `slug` (string, optional, default: derived from name): Identificador opcional do skill em minúsculas, compatível com o contrato de slug de 1–64 caracteres.
- `description` (string, optional, default: empty): Texto opcional para descoberta retornado pela descoberta de consulta de nível 0.
- `publish` (boolean, optional, default: true): Intenção de publicação; o escopo pessoal pode publicar diretamente, enquanto o escopo de equipe cria uma revisão proposta.
- `components_json` (JSON array string, optional, default: []): Objetos de componentes opcionais com type, logical_path, content ou artifact_ref, mime_type e metadata; no máximo 50, e cada corpo de conteúdo é limitado a 128 KiB.

### Returns

Um JSON CloudSkillResponseEnvelope com object='cloud_skill', schema_version='xmemo.cloud_skill.v1', kind='root', render_status, warnings e data contendo skill_id, slug, name, description, revision_id, revision_number, instructions, canonical_hash e um manifesto de resources tipados.

### Errors

- Falha de autorização: o token MCP não possui memory:write ou o chamador não pode gravar no escopo pessoal/de equipe resolvido.
- Falha de validação: name ou instructions está vazio, o slug é inválido ou o corpo de instruções excede 64 KiB.
- Falha de validação de componente: components_json não é uma matriz JSON, um path de componente está vazio, é absoluto, parece traversal, é reservado ou duplicado, o type é inválido ou um componente excede 128 KiB.
- Ciclo de vida do escopo: a publicação pessoal é direta; a publicação para equipe é armazenada como proposta e exige o fluxo de revisão da equipe.

### Examples

#### Publique um procedimento pessoal



```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): Descubra o skill, carregue seu manifesto raiz ou leia um recurso fixado depois de salvá-lo.
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): Execute um componente de script declarado somente depois de recuperar a revisão pretendida.
- [remember](/docs/tools/remember): Use a memória duradoura comum quando um procedimento reutilizável não for necessário.

## Publique somente um procedimento revisado

Forneça instruções duradouras e componentes tipados opcionais. Mantenha credenciais e material privado fora do corpo do skill; a ferramenta armazena o procedimento no escopo pessoal ou de equipe autenticado.