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.
Outil MCP public
recall_cloud_skill
Objectif
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.
Quand l'utiliser
- Découvrir les compétences disponibles par une requête en langage naturel lorsque vous ne connaissez pas encore le slug exact.
- Charger le manifeste racine d'une compétence pour inspecter ses instructions, sa révision actuelle et ses composants déclarés.
- Récupérer le contenu d'un composant de ressource spécifique pour une révision immuable épinglée avant exécution.
Quand NE PAS l'utiliser
- Ne l'utilisez pas pour exécuter un composant de script ; utilisez execute_cloud_skill une fois la révision et le composant inspectés.
- Ne l'utilisez pas pour créer ou mettre à jour des compétences ; utilisez save_cloud_skill pour produire la révision suivante.
- N'omettez pas revision_id pour la récupération de ressources Level 2 ; la lecture de ressources requiert un épinglage strict de révision.
- Ne demandez pas de ressources de compétences non publiées ou archivées ; l'outil n'expose que les compétences actives autorisées.
Périmètre requis
- memory:read est requis sur la surface MCP.
- La compétence doit être résolue dans le périmètre personnel ou d'équipe de l'appelant authentifié ; les compétences d'équipe requièrent l'appartenance à l'équipe.
Paramètres
| Nom | Type | Description |
|---|---|---|
query | string · par défaut : empty | Texte de découverte Level 0 ; utilisé lorsque skill_id et slug sont vides. |
skill_id | string · par défaut : empty | Identifiant stable de Cloud Skill pour le rappel de racine ou de ressource. |
slug | string · par défaut : empty | Identifiant lisible de compétence pour le rappel de racine ou de ressource. |
revision_id | string · par défaut : empty | Épinglage facultatif de la révision racine ; requis pour le rappel de ressource Level 2. |
resource | string · par défaut : empty | Chemin logique ou ID du composant pour le rappel Level 2. |
Schéma de retour
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.
Exemples
recall_cloud_skill({ query: "deployment verification" })recall_cloud_skill({
slug: "deployment-procedure",
revision_id: "revision-id-from-root-recall",
resource: "scripts/check.py"
})Erreurs
- É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.
Outils associés
- save_cloud_skill — Créer la compétence durable ou publier sa prochaine révision.
- execute_cloud_skill — Exécuter un composant de script rappelé via le bac à sable (sandbox).
- 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.
Source : Cloud Skills