# save_cloud_skill

Enregistrez ou mettez à jour un Cloud Skill réutilisable et créez sa prochaine révision versionnée.

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

## Tool Reference: `save_cloud_skill`

### Purpose

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.

### Parameters

- `name` (string, required): Nom de la compétence lisible par un humain ; les noms vides sont rejetés.
- `instructions` (string, required): Corps de la procédure racine ; requis et limité à 64 Kio après encodage UTF-8.
- `slug` (string, optional, default: derived from name): Identifiant de compétence en minuscules facultatif respectant le contrat de slug de 1 à 64 caractères.
- `description` (string, optional, default: empty): Texte de découverte facultatif renvoyé lors d'une découverte par requête Level 0.
- `publish` (boolean, optional, default: 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, optional, default: []): 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.

### Returns

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.

### Errors

- É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.

### Examples

#### Publier une procédure personnelle



```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): Découvrir la compétence, charger son manifeste racine ou lire une ressource épinglée après l'enregistrement.
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): Exécuter un composant de script déclaré uniquement après avoir rappelé la révision prévue.
- [remember](/docs/tools/remember): Utiliser la mémoire durable ordinaire lorsqu'une procédure réutilisable n'est pas nécessaire.

## 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é.