# recall_cloud_skill

Découvrez les Cloud Skills, chargez un manifeste racine ou récupérez une ressource à partir d'une révision explicitement épinglée.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/recall-cloud-skill
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: a66c09970d11396c99dee1375dcc4f98f14752723e76286acb0b1929010be8fc
- Edition-Digest: a99505f572c8ca14a7078b5b2e48ecf043218961233e4dfcfdc3657b4e127001
- Source-Revision: sha256:ede99f126c525b2202720b7cc58a07f4545e9b33620f111c105e26739e87783c

## Tool Reference: `recall_cloud_skill`

### Purpose

Lire les métadonnées et ressources de Cloud Skill selon un modèle progressif à 3 niveaux : découverte Level 0, manifeste racine Level 1 et ressource de révision épinglée Level 2.

### Parameters

- `query` (string, optional, default: empty): Texte de découverte Level 0 ; utilisé lorsque skill_id et slug sont vides.
- `skill_id` (string, optional, default: empty): Identifiant stable de Cloud Skill pour le rappel de racine ou de ressource.
- `slug` (string, optional, default: empty): Identifiant lisible de compétence pour le rappel de racine ou de ressource.
- `revision_id` (string, optional, default: empty): Épinglage facultatif de la révision racine ; requis pour le rappel de ressource Level 2.
- `resource` (string, optional, default: empty): Chemin logique ou ID du composant pour le rappel Level 2.

### Returns

Une enveloppe JSON CloudSkillResponseEnvelope avec object='cloud_skill', schema_version='xmemo.cloud_skill.v1', render_status, avertissements et data contenant la liste de découverte Level 0, le manifeste de compétence racine Level 1 ou la ressource de révision typée Level 2.

### Errors

- Échec d'autorisation : le jeton MCP ne dispose pas de memory:read ou l'appelant ne peut pas lire le périmètre personnel/équipe résolu.
- SKILL_NOT_FOUND : la compétence demandée n'existe pas dans le périmètre de l'appelant ou a été archivée.
- REVISION_NOT_FOUND : le revision_id demandé n'appartient pas à la compétence ou n'existe pas.
- RESOURCE_NOT_FOUND : le chemin logique ou l'ID de ressource demandé n'existe pas dans la révision épinglée.
- Échec de validation : les identifiants sont manquants, la longueur de la requête dépasse les limites, ou la récupération de ressources omet revision_id.

### Examples

#### Découvrir une compétence publiée



```typescript
recall_cloud_skill({ query: "deployment verification" })
```

#### Charger une ressource de script épinglée



```typescript
recall_cloud_skill({
  slug: "deployment-procedure",
  revision_id: "revision-id-from-root-recall",
  resource: "scripts/check.py"
})
```

### Related Tools

- [save_cloud_skill](/docs/tools/save-cloud-skill): Créer la compétence durable ou publier sa prochaine révision.
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): Exécuter un composant de script rappelé via le bac à sable (sandbox).
- [recall_context](/docs/tools/recall-context): Utiliser la récupération de contexte de mémoire lorsque la cible est la mémoire d'agent plutôt qu'une ressource Cloud Skill.

## Ne charger que la couche nécessaire

Commencez par une recherche Level 0 avec query lorsque le slug n'est pas encore connu, puis chargez le manifeste racine Level 1 ou épinglez une révision pour la ressource Level 2 dont vous avez besoin.