Référence des outils Skillry MCP

Appelez ces outils depuis un client MCP connecté. L'agent fournit généralement les arguments ; cette référence aide à vérifier les appels et à développer des intégrations.

skillry-cli@lateststdioskills:read

Vérifié : 26 oct. 2026

Connecter votre client

Avant d'appeler un outil

Ajouter à votre client

Skillry utilise un serveur stdio local sur macOS ou Windows avec Node.js 22+. Les identifiants sont conservés dans le coffre du système. /mcp est une page de configuration, pas un point d'accès MCP distant.

Compte et autorisation

Les appels de compte utilisent une autorisation navigateur avec skills:read. L'identifiant actuel expire après 7 jours sans renouvellement automatique. CLI et MCP du même ordinateur partagent l'identifiant d'une même URL de service ; déconnecter le révoque.

Vérifiez prérequis et accès avant d'installer. Conservez le Skill et la version choisis. L'installation n'exécute pas le Skill, n'achète pas d'accès et ne paie aucun fournisseur externe.

Remplacez <skill-slug> par un slug renvoyé par search_skills et <published-version> par la version publiée choisie. Utilisez des chemins absolus de votre ordinateur.

Découverte

search_skills

Public

Recherche les Skills publiés selon le résultat souhaité et les contraintes explicites. La recherche par défaut utilise des mots-clés ; une correspondance ne garantit pas l'exécution dans votre environnement.

Paramètres9

querystringFacultatif

Résultat souhaité ou nom/slug exact. Décrivez la sortie : un PDF ou une URL d'entrée ne définit pas son type.

maxLength: 200 · Par défaut ""

outputTypestringFacultatif

Filtre selon le type de sortie. presentation est la valeur API pour les présentations.

deliveryScopestringFacultatif

Choisissez une œuvre complète ou un composant. Si le périmètre n'est pas renseigné, une vérification reste nécessaire.

complete | component

avoidVoiceoverbooleanFacultatif

true exclut les candidats déclarant une voix off obligatoire dans le flux principal.

allowApiKeysbooleanFacultatif

false exclut les clés de fournisseur déclarées obligatoires. Une absence de déclaration reste inconnue.

allowExternalCostsbooleanFacultatif

false exclut les coûts externes déclarés. Les coûts inconnus nécessitent toujours vérification.

limitintegerFacultatif

Nombre maximal de résultats par appel. Respectez la plage et la valeur par défaut de cet outil.

≥ 1 · ≤ 20 · Par défaut 5

offsetintegerFacultatif

Décalage de pagination. Poursuivez avec nextOffset renvoyé.

≥ 0 · ≤ 10000 · Par défaut 0

localestringFacultatif

Langue du contenu. Utilisez les valeurs exactes de l'API, dont zh-CN, zh-TW et pt-BR.

en | zh-CN | zh-TW | ja | ko | es | pt-BR | de | fr · Par défaut "en"

Exemple d'arguments · JSON

{
  "query": "product presentation",
  "outputType": "presentation",
  "avoidVoiceover": true,
  "allowApiKeys": false,
  "allowExternalCosts": false,
  "limit": 3
}

Résultat et comportement

Renvoie skills, nextOffset et les états de recherche/révision. Vérifiez appliedRequirements, requirementReview, costNotice et clarificationQuestion. Les inconnues nécessitent vérification ; constraintsStatus: unconfirmed indique que le service n'a pas confirmé les filtres. Les scores ne sont pas des probabilités.

get_skill

Public

Consulte version, aperçu, entrées, dépendances et frais externes d'un Skill publié avant de choisir.

Paramètres1

slugstringObligatoire

Slug exact du Skill publié choisi : kebab-case en minuscules, 64 caractères maximum.

minLength: 1 · maxLength: 64

Exemple d'arguments · JSON

{
  "slug": "<skill-slug>"
}

Résultat et comportement

Renvoie les métadonnées publiques de la version, sans accorder d'accès ni inclure de contenu privé du paquet.

Compte et autorisation

connect_account

Autorisation dans le navigateur

Lance l'autorisation navigateur à la demande de l'utilisateur. Réutilise un processus déjà en attente.

ParamètresAucun argument. Passez un objet vide.

Résultat et comportement

Renvoie verificationUrl, userCode, expiresAt, browserOpened et pollAfterSeconds. Affichez URL et code correspondant ; aucun identifiant secret n'est renvoyé.

connection_status

Autorisation dans le navigateur

Poursuit une autorisation en attente. Rappelez après l'intervalle pollAfterSeconds indiqué.

ParamètresAucun argument. Passez un objet vide.

Résultat et comportement

Indique not_started, pending, denied, expired ou connected. Après approbation, le jeton est enregistré dans le coffre du système. Respectez l'intervalle de consultation.

account_status

Compte requis

Vérifie l'abonnement, l'expiration, la portée et le quota quotidien de téléchargements actuels.

ParamètresAucun argument. Passez un objet vide.

Résultat et comportement

Renvoie connected, entitlement, scope, sessionExpiresAt, quota et pricingUrl, sans identité personnelle ni identifiants secrets.

disconnect_account

Compte requis

Annule l'autorisation en attente, révoque l'identifiant partagé CLI/MCP et le supprime du coffre du système.

ParamètresAucun argument. Passez un objet vide.

Résultat et comportement

Vérifiez serverRevoked. Si la révocation distante échoue, l'identifiant local est supprimé, mais le jeton serveur peut rester valide jusqu'à expiration.

get_skill_access

Compte requis

Vérifie l'accès à un Skill publié avant le téléchargement, sans réserver ni consommer de quota.

Paramètres1

slugstringObligatoire

Slug exact du Skill publié choisi : kebab-case en minuscules, 64 caractères maximum.

minLength: 1 · maxLength: 64

Exemple d'arguments · JSON

{
  "slug": "<skill-slug>"
}

Résultat et comportement

Renvoie access (free, purchased, member ou purchase_required), canDownload, reason, purchaseUrl, version et quota. Le téléchargement revérifie les droits.

Téléchargements, installation et mises à jour

download_skill

Compte requisModifie les fichiers locaux

Enregistre un ZIP vérifié dans un dossier absolu choisi. N'écrase jamais les fichiers existants.

Paramètres3

slugstringObligatoire

Slug exact du Skill publié choisi : kebab-case en minuscules, 64 caractères maximum.

minLength: 1 · maxLength: 64

downloadDirectorystringObligatoire

Dossier absolu explicite pour enregistrer le ZIP. Agent et portée d'installation ne sont pas utilisés.

maxLength: 4096

expectedVersionstringFacultatif

Version publiée choisie. Obligatoire pour une mise à jour, facultative pour installer/télécharger. Revérifiez si la version publiée change.

minLength: 1 · maxLength: 64

Exemple d'arguments · JSON

{
  "slug": "<skill-slug>",
  "downloadDirectory": "/absolute/path/downloads",
  "expectedVersion": "<published-version>"
}

Résultat et comportement

Après vérification du ZIP et de la version, renvoie archivePath, slug, version et sha256. N'installe rien et ne signale pas une installation achevée.

install_skill

Compte requisModifie les fichiers locaux

Installe la version sélectionnée pour un agent et une portée explicites. N'écrase pas les dossiers de Skills existants.

Paramètres5

slugstringObligatoire

Slug exact du Skill publié choisi : kebab-case en minuscules, 64 caractères maximum.

minLength: 1 · maxLength: 64

agentstringObligatoire

Destination d'installation, distincte du client MCP. global utilise le dossier configuré ; project accepte uniquement shared ou claude-code.

scopestringFacultatif

global installe pour votre utilisateur système ; project installe sous projectDirectory explicite.

global | project · Par défaut "global"

projectDirectorystringFacultatif

Chemin absolu du projet, obligatoire avec scope: project et interdit avec scope: global. shared utilise .agents/skills ; claude-code, .claude/skills.

maxLength: 4096

expectedVersionstringFacultatif

Version publiée choisie. Obligatoire pour une mise à jour, facultative pour installer/télécharger. Revérifiez si la version publiée change.

minLength: 1 · maxLength: 64

Exemple d'arguments · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

Résultat et comportement

Renvoie targetPath, skillFile, version, completionReported et inventoryRecorded. Lisez SKILL.md et vérifiez les coûts avant l'exécution.

list_installed_skills

Fichiers locaux

Lit les Skills du dossier local choisi. Seules les installations gérées par Skillry ont une version publiée enregistrée.

Paramètres3

agentstringObligatoire

Destination d'installation, distincte du client MCP. global utilise le dossier configuré ; project accepte uniquement shared ou claude-code.

scopestringFacultatif

global installe pour votre utilisateur système ; project installe sous projectDirectory explicite.

global | project · Par défaut "global"

projectDirectorystringFacultatif

Chemin absolu du projet, obligatoire avec scope: project et interdit avec scope: global. shared utilise .agents/skills ; claude-code, .claude/skills.

maxLength: 4096

Exemple d'arguments · JSON

{
  "agent": "shared",
  "scope": "global"
}

Résultat et comportement

Renvoie les éléments locaux et leur état managed/version. Les Skills non gérés ont une version inconnue et ne sont pas mis à jour sans vérification.

check_updates

Fichiers locaux

Compare les installations gérées aux versions publiées. La vérification ne télécharge ni n'installe de mise à jour.

Paramètres5

agentstringObligatoire

Destination d'installation, distincte du client MCP. global utilise le dossier configuré ; project accepte uniquement shared ou claude-code.

scopestringFacultatif

global installe pour votre utilisateur système ; project installe sous projectDirectory explicite.

global | project · Par défaut "global"

projectDirectorystringFacultatif

Chemin absolu du projet, obligatoire avec scope: project et interdit avec scope: global. shared utilise .agents/skills ; claude-code, .claude/skills.

maxLength: 4096

offsetintegerFacultatif

Décalage de pagination. Poursuivez avec nextOffset renvoyé.

≥ 0 · ≤ 9007199254740991 · Par défaut 0

limitintegerFacultatif

Nombre maximal de résultats par appel. Respectez la plage et la valeur par défaut de cet outil.

≥ 1 · ≤ 5 · Par défaut 5

Exemple d'arguments · JSON

{
  "agent": "shared",
  "scope": "global",
  "offset": 0,
  "limit": 5
}

Résultat et comportement

Renvoie current, update_available, unavailable ou unmanaged par élément, ainsi que nextOffset. Poursuivez avec le même agent et la même portée.

update_skill

Compte requisModifie les fichiers locaux

Met à jour un Skill géré par Skillry et installé sur votre ordinateur vers la version expressément approuvée par l’utilisateur. Sauvegarde tout le dossier précédent, modifications locales comprises.

Paramètres5

agentstringObligatoire

Destination d'installation, distincte du client MCP. global utilise le dossier configuré ; project accepte uniquement shared ou claude-code.

scopestringFacultatif

global installe pour votre utilisateur système ; project installe sous projectDirectory explicite.

global | project · Par défaut "global"

projectDirectorystringFacultatif

Chemin absolu du projet, obligatoire avec scope: project et interdit avec scope: global. shared utilise .agents/skills ; claude-code, .claude/skills.

maxLength: 4096

slugstringObligatoire

Slug exact du Skill publié choisi : kebab-case en minuscules, 64 caractères maximum.

minLength: 1 · maxLength: 64

expectedVersionstringObligatoire

Version publiée choisie. Obligatoire pour une mise à jour, facultative pour installer/télécharger. Revérifiez si la version publiée change.

minLength: 1 · maxLength: 64

Exemple d'arguments · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

Résultat et comportement

En cas de remplacement, renvoie la version installée et backupPath. Si la version correspond déjà, aucun remplacement n'a lieu.

Dossiers d'installation

En global, shared, codex, cursor, gemini-cli, opencode et kimi-code utilisent ~/.agents/skills ; claude-code utilise ~/.claude/skills ; antigravity utilise ~/.gemini/config/skills. project utilise <projectDirectory>/.agents/skills ou <projectDirectory>/.claude/skills. Ne déduisez pas le projet du dossier de travail du processus MCP.

Exemple d'arguments · install_skill

{
  "slug": "<skill-slug>",
  "agent": "claude-code",
  "scope": "project",
  "projectDirectory": "/absolute/path/project",
  "expectedVersion": "<published-version>"
}

États et dépannage

Autorisation absente ou expirée: Pour authentication_required ou session_expired, demandez la connexion, appelez connect_account, affichez URL/code et consultez connection_status à l'intervalle indiqué. Réessayez l'action initiale après approbation.
Le dossier du Skill existe déjà: Pour skill_already_installed, examinez la même destination avec list_installed_skills et check_updates. Demandez l'accord avant de mettre à jour une installation gérée vers la nouvelle version choisie. MCP n'a pas d'argument force.
Achat requis ou quota quotidien atteint: Pour purchase_required ou premium_required, suivez purchaseUrl/actionUrl. Pour daily_download_limit, affichez resetsAt. Retélécharger le même Skill le même jour ne consomme pas un autre emplacement de Skill distinct ; remise à zéro à 00:00 UTC.
Les outils Skillry n'apparaissent pas: Vérifiez Node.js 22+, la configuration du système et les journaux du client. Redémarrez ou rechargez après l'ajout du serveur. Les environnements uniquement navigateur et Linux ne sont pas pris en charge actuellement.

Pour aller plus loin

Connecter votre client Connecter Skillry MCP Model Context Protocol