find-skills

Par cherryhq · cherry-studio

Aide les utilisateurs à découvrir et installer des agent skills lorsqu'ils posent des questions comme « comment faire X », « trouve un skill pour X », « existe-t-il un skill qui peut… », ou expriment le souhait d'étendre des fonctionnalités. Ce skill doit être utilisé quand l'utilisateur recherche une fonctionnalité qui pourrait exister sous forme de skill installable.

npx skills add https://github.com/cherryhq/cherry-studio --skill find-skills

Trouver des Skills

Ce skill vous aide à découvrir et installer des skills à partir de l'écosystème ouvert de skills pour agents.

Quand utiliser ce skill

Utilisez ce skill quand l'utilisateur :

  • Demande « comment faire X » où X pourrait être une tâche courante avec un skill existant
  • Dit « trouve un skill pour X » ou « existe-t-il un skill pour X »
  • Demande « peux-tu faire X » où X est une capacité spécialisée
  • Exprime l'intérêt d'étendre les capacités de l'agent
  • Veut chercher des outils, templates ou workflows
  • Mentionne qu'il souhaiterait avoir de l'aide dans un domaine spécifique (design, testing, déploiement, etc.)

Qu'est-ce que la Skills CLI ?

La Skills CLI (npx skills) est le gestionnaire de paquets pour l'écosystème ouvert de skills pour agents. Les skills sont des paquets modulaires qui étendent les capacités des agents avec des connaissances spécialisées, des workflows et des outils.

Commandes principales :

  • npx skills find [query] - Chercher des skills de façon interactive ou par mot-clé
  • npx skills add <package> - Installer un skill depuis GitHub ou d'autres sources
  • npx skills check - Vérifier les mises à jour des skills
  • npx skills update - Mettre à jour tous les skills installés

Parcourir les skills : https://skills.sh/

Détection du runtime

Avant d'exécuter une commande npx skills, vérifiez que npx est disponible :

which npx

Si npx est introuvable, basculez sur le bun fourni avec Cherry Studio. Cherry Studio définit la variable d'environnement CHERRY_STUDIO_BUN_PATH qui pointe vers son binaire bun fourni. Utilisez-le comme suit :

if [ -n "$CHERRY_STUDIO_BUN_PATH" ] && [ -x "$CHERRY_STUDIO_BUN_PATH" ]; then
  "$CHERRY_STUDIO_BUN_PATH" x skills <subcommand> [args]
else
  echo "Error: Neither npx nor bundled bun found. Install Node.js or run Cherry Studio's bun installer."
fi

Par exemple, npx skills find react devient "$CHERRY_STUDIO_BUN_PATH" x skills find react.

Essayez toujours npx en premier. Utilisez le fallback bun uniquement quand npx est indisponible.

Comment aider les utilisateurs à trouver des skills

Étape 1 : Comprendre ce qu'ils ont besoin

Quand un utilisateur demande de l'aide pour quelque chose, identifiez :

  1. Le domaine (par ex. React, testing, design, déploiement)
  2. La tâche spécifique (par ex. écrire des tests, créer des animations, revoir des PR)
  3. Si c'est une tâche assez courante pour qu'un skill existe probablement

Étape 2 : Chercher des skills

Exécutez la commande find avec une requête pertinente :

npx skills find [query]

Par exemple :

  • L'utilisateur demande « comment rendre mon application React plus rapide ? » → npx skills find react performance
  • L'utilisateur demande « peux-tu m'aider avec la revue des PR ? » → npx skills find pr review
  • L'utilisateur demande « je dois créer un changelog » → npx skills find changelog

La commande retournera des résultats comme :

Install with npx skills add <owner/repo@skill>

vercel-labs/agent-skills@vercel-react-best-practices
└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices

Étape 3 : Présenter les options à l'utilisateur

Quand vous trouvez des skills pertinents, présentez-les à l'utilisateur avec :

  1. Le nom du skill et ce qu'il fait
  2. Le lien du référentiel source pour que l'utilisateur puisse revoir le code
  3. La commande d'installation qu'il peut exécuter

Exemple de réponse :

J'ai trouvé un skill qui pourrait vous aider ! Le skill « vercel-react-best-practices »
fournit des directives d'optimisation des performances React et Next.js de Vercel Engineering.

Source : https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices

Pour l'installer (après avoir revu la source) :
npx skills add vercel-labs/agent-skills@vercel-react-best-practices

Étape 4 : Installer (nécessite la confirmation de l'utilisateur)

⚠️ Sécurité : Les skills sont du code tiers qui s'exécute avec les permissions complètes de l'agent. Un skill malveillant pourrait lire, modifier ou supprimer des fichiers de votre projet.

Avant d'installer un skill, vous DEVEZ :

  1. Afficher un avertissement de sécurité — dites à l'utilisateur que le skill est du code tiers et aura accès aux fichiers de son projet.
  2. Fournir le lien source pour que l'utilisateur puisse revoir le SKILL.md et tous les scripts qu'il contient.
  3. Demander une confirmation explicite — n'exécutez PAS npx skills add avant que l'utilisateur dise « oui » ou l'équivalent. N'installez jamais silencieusement.

Uniquement après la confirmation de l'utilisateur, exécutez :

npx skills add <owner/repo@skill> -y

Le flag -y est requis pour une exécution non-interactive, mais l'étape de confirmation utilisateur ci-dessus garantit que l'utilisateur a revu et approuvé l'installation.

Les skills sont installés dans le répertoire .claude/skills/ du projet actuel.

Catégories courantes de skills

Lors de la recherche, considérez ces catégories courantes :

Catégorie Exemples de requêtes
Développement web react, nextjs, typescript, css, tailwind
Testing testing, jest, playwright, e2e
DevOps deploy, docker, kubernetes, ci-cd
Documentation docs, readme, changelog, api-docs
Qualité du code review, lint, refactor, best-practices
Design ui, ux, design-system, accessibility
Productivité workflow, automation, git

Conseils pour des recherches efficaces

  1. Utilisez des mots-clés spécifiques : « react testing » est mieux que juste « testing »
  2. Essayez des termes alternatifs : Si « deploy » ne fonctionne pas, essayez « deployment » ou « ci-cd »
  3. Vérifiez les sources populaires : Beaucoup de skills proviennent de vercel-labs/agent-skills ou ComposioHQ/awesome-claude-skills

Quand aucun skill n'est trouvé

Si aucun skill pertinent n'existe :

  1. Reconnaissez qu'aucun skill existant n'a été trouvé
  2. Proposez d'aider avec la tâche directement en utilisant vos capacités générales
  3. Suggérez que l'utilisateur pourrait créer son propre skill avec npx skills init

Exemple :

J'ai cherché des skills liés à « xyz » mais je n'ai trouvé aucune correspondance.
Je peux quand même vous aider avec cette tâche directement ! Voulez-vous continuer ?

Si c'est quelque chose que vous faites souvent, vous pourriez créer votre propre skill :
npx skills init my-xyz-skill

Skills similaires