save_cloud_skill

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.

Ferramenta MCP pública

save_cloud_skill

Finalidade

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

Quando usar

Publique um procedimento, regra ou SOP duradouro que agentes conectados possam recuperar e executar pelo contrato existente de Cloud Skill.
Crie um skill pessoal ou envie uma revisão com escopo de equipe para o fluxo de revisão da equipe.
Substitua um slug existente quando o procedimento precisar de uma nova versão com um novo hash canônico.

Quando NÃO usar

Não armazene chat temporário, credenciais, bearer tokens, chaves privadas ou segredos brutos como instruções do skill ou conteúdo de componentes.
Não use para um fato duradouro comum; use remember ou o fluxo de captura do SDK.
Não presuma que a publicação para uma equipe já está ativa: revisões de equipe são propostas, não publicadas diretamente.
Não ultrapasse os limites de instruções, componentes ou quantidade de componentes; a validação rejeita paths lógicos grandes demais ou inseguros.

Escopo necessário

memory:write é obrigatório na superfície MCP.
A ferramenta está catalogada na superfície avançada com tier mínimo pro; o escopo pessoal ou de equipe autenticado determina onde o skill é armazenado.

Parâmetros

Nome	Tipo	Descrição
`name`	string · obrigatório	Nome legível do skill; nomes vazios são rejeitados.
`instructions`	string · obrigatório	Corpo do procedimento raiz; é obrigatório e limitado a 64 KiB após a codificação UTF-8.
`slug`	string · padrão: derived from name	Identificador opcional do skill em minúsculas, compatível com o contrato de slug de 1–64 caracteres.
`description`	string · padrão: empty	Texto opcional para descoberta retornado pela descoberta de consulta de nível 0.
`publish`	boolean · padrão: 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 · padrão: []	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.

Esquema de retorno

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.

Exemplos

Publique um procedimento pessoal

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
})

Erros

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.

recall_cloud_skill — Descubra o skill, carregue seu manifesto raiz ou leia um recurso fixado depois de salvá-lo.
execute_cloud_skill — Execute um componente de script declarado somente depois de recuperar a revisão pretendida.
remember — Use a memória duradoura comum quando um procedimento reutilizável não for necessário.

Origem: Cloud Skills