save_cloud_skill

Ne publier qu'une procédure revue

Fournissez des instructions durables et des composants typés facultatifs. Conservez les identifiants et le matériel privé hors du corps de la compétence ; l'outil stocke la procédure dans le périmètre personnel ou d'équipe authentifié.

Outil MCP public

save_cloud_skill

Objectif

Créer ou mettre à jour un Cloud Skill réutilisable et produire la prochaine révision immuable de ses instructions et de ses composants typés.

Quand l'utiliser

Publier une procédure, une règle ou une SOP durable que les agents connectés peuvent rappeler et exécuter selon le contrat Cloud Skill existant.
Créer une nouvelle compétence personnelle ou soumettre une révision de périmètre d'équipe pour le flux de révision de l'équipe.
Remplacer un slug existant lorsque la procédure nécessite une nouvelle version avec un nouveau hash canonique.

Quand NE PAS l'utiliser

Ne stockez pas de chat éphémère, d'identifiants, de jetons porteurs, de clés privées ou de secrets bruts comme instructions ou contenu de composants de compétence.
Ne l'utilisez pas pour un fait durable ordinaire ; utilisez remember ou le flux de travail de capture du SDK.
Ne supposez pas que l'intention de publication d'équipe soit immédiatement active : les révisions d'équipe sont proposées plutôt que directement publiées.
Ne dépassez pas les limites d'instructions, de composants ou de nombre de composants ; la validation rejette les chemins logiques surdimensionnés ou dangereux.

Périmètre requis

memory:write est requis sur la surface MCP.
L'outil est répertorié sur la surface avancée avec un niveau minimal pro ; le périmètre personnel ou d'équipe authentifié détermine l'endroit où la compétence est stockée.

Paramètres

Nom	Type	Description
`name`	string · requis	Nom de la compétence lisible par un humain ; les noms vides sont rejetés.
`instructions`	string · requis	Corps de la procédure racine ; requis et limité à 64 Kio après encodage UTF-8.
`slug`	string · par défaut : derived from name	Identifiant de compétence en minuscules facultatif respectant le contrat de slug de 1 à 64 caractères.
`description`	string · par défaut : empty	Texte de découverte facultatif renvoyé lors d'une découverte par requête Level 0.
`publish`	boolean · par défaut : true	Intention de publication ; le périmètre personnel peut publier directement, tandis que le périmètre d'équipe crée une révision proposée.
`components_json`	JSON array string · par défaut : []	Objets de composants facultatifs avec type, logical_path, content ou artifact_ref, mime_type et metadata ; au maximum 50 et chaque corps de contenu est limité à 128 Kio.

Schéma de retour

Une enveloppe JSON CloudSkillResponseEnvelope avec object='cloud_skill', schema_version='xmemo.cloud_skill.v1', kind='root', render_status, avertissements et data contenant skill_id, slug, name, description, revision_id, revision_number, instructions, canonical_hash et un manifeste de ressources typées.

Exemples

Publier une procédure personnelle

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

Erreurs

Échec d'autorisation : le jeton MCP ne dispose pas de memory:write ou l'appelant ne peut pas écrire dans le périmètre personnel/équipe résolu.
Échec de validation : le nom ou les instructions sont vides, le slug est invalide, ou le corps des instructions dépasse 64 Kio.
Échec de validation de composant : components_json n'est pas un tableau JSON, un chemin de composant est vide/absolu/traverse des répertoires/réservé/dupliqué, un type est invalide, ou un composant dépasse 128 Kio.
Cycle de vie de périmètre : la publication personnelle est directe ; la publication d'équipe est stockée comme proposée et requiert le flux de révision d'équipe.

recall_cloud_skill — Découvrir la compétence, charger son manifeste racine ou lire une ressource épinglée après l'enregistrement.
execute_cloud_skill — Exécuter un composant de script déclaré uniquement après avoir rappelé la révision prévue.
remember — Utiliser la mémoire durable ordinaire lorsqu'une procédure réutilisable n'est pas nécessaire.

Source : Cloud Skills