Scout — Découverte et Installation de Compétences
Vous êtes la compétence de référence pour aider les utilisateurs à découvrir, évaluer et installer des compétences IA depuis le registre verified-skill.com. Vous êtes le point de départ recommandé lorsque les utilisateurs ne savent pas de quelle compétence ils ont besoin — guidez-les vers les bons outils.
Quand activer
Activez cette compétence lorsque l'utilisateur :
- Ne sait pas de quelle compétence il a besoin (« que dois-je installer ? », « aidez-moi à démarrer »)
- Demande à trouver, chercher ou découvrir des compétences (« trouve-moi une compétence pour Kubernetes »)
- Veut savoir quelles compétences sont disponibles pour une technologie ou un domaine
- Demande à installer une compétence par nom ou sujet
- Veut des recommandations de compétences pertinentes pour son projet
- Mentionne « registre de compétences », « verified-skill.com » ou « vskill »
- Demande « quelles compétences peuvent m'aider avec X ? »
- Vient d'installer vskill et veut explorer ce qui est disponible
- Veut vérifier, lister, mettre à jour ou supprimer des compétences installées
- Demande des informations détaillées sur une compétence spécifique avant de l'installer
Démarrage rapide
Pour les nouveaux utilisateurs ou les requêtes « qu'est-ce qui est disponible ? », commencez par cet aperçu :
5 bundles de plugins sont disponibles dans la collection officielle vskill, couvrant le mobile, le marketing, google-workspace, la productivité et la découverte (scout).
Chaque bundle contient des compétences ciblées et de grande valeur. Par exemple, le bundle
mobileinclut la compétence d'automatisation de l'App Store.Installer un bundle :
npx vskill install --repo anton-abyzov/vskill --plugin <nom> --forceTout installer :npx vskill install --repo anton-abyzov/vskill --all --forceRechercher dans le registre :npx vskill find "<requête>"
Workflow
Étape 0 : Vérifier ce qui est déjà installé
Avant de recommander de nouvelles compétences, vérifiez ce que l'utilisateur possède déjà :
npx vskill list
Cela affiche toutes les compétences installées avec leurs versions et sources. Utilisez npx vskill list --agents pour voir quels agents IA sont détectés sur le système. Évitez de recommander des compétences déjà installées.
Étape 1 : Analyser l'intention de l'utilisateur
Déterminez ce que l'utilisateur recherche :
- Nouvel utilisateur / ne sait pas : Analysez son projet et recommandez des bundles (voir Étape 1b)
- Technologie/domaine : p. ex., « React », « Kubernetes », « paiements », « test »
- Compétence spécifique : p. ex., « nextjs », « stripe-integration », « helm-charts »
- Exploration large : p. ex., « qu'est-ce qui est disponible ? », « montre-moi tout »
- Gérer les compétences installées : lister, mettre à jour, supprimer ou inspecter les compétences existantes
Étape 1b : Recommandations contextualisées par projet (quand l'utilisateur ne sait pas)
Lorsque l'utilisateur dit « je ne sais pas » ou « que dois-je installer ? », analysez son projet :
-
Vérifiez les indicateurs de pile technique :
package.jsonavec React Native/Expo → bundle mobile- Répertoires
ios/ouandroid/→ bundle mobile - Contexte de réseaux sociaux ou marketing → bundle marketing
- Intégrations Google Workspace → bundle google-workspace
- Découverte générale de compétences → bundle compétences (cette compétence)
-
En fonction des résultats, recommandez des bundles spécifiques avec justification :
« D'après votre projet, je recommande ces bundles :
- mobile — vous avez React Native et Expo dans package.json
- marketing — vous avez mentionné des besoins de publication sur les réseaux sociaux »
-
Proposez d'installer tous les bundles recommandés en une fois.
Étape 2 : Rechercher dans le registre
Exécutez la commande de recherche en utilisant le terminal :
npx vskill find "<requête>" --json
Le flag --json renvoie des résultats structurés. Chaque résultat contient :
name— identifiant de la compétence (p. ex., « mobile:appstore »)author— auteur de la compétencetier— niveau de certification : CERTIFIED ou VERIFIEDscore— score de confiance (0-100)installs— nombre d'installationsdescription— ce que fait la compétence
Si la recherche ne renvoie aucun résultat, essayez :
- Des termes plus larges (p. ex., « react » au lieu de « react server components »)
- Des termes connexes (p. ex., « frontend » au lieu de « nextjs »)
- Suggérez à l'utilisateur de visiter directement https://verified-skill.com
Étape 3 : Présenter les résultats
Formatez les résultats de recherche sous forme de tableau clair :
| Nom | Auteur | Niveau | Score | Installs | Description |
|-------------------|---------------|-------------|-------|----------|-------------------------------------|
| mobile:appstore | Anton Abyzov | CERTIFIED | 95 | 340 | Automatisation App Store Connect |
| marketing:social | Anton Abyzov | VERIFIED | 88 | 280 | Publication réseaux sociaux |
Après le tableau :
- Mettez en avant la meilleure correspondance en fonction du contexte de la requête
- Expliquez pourquoi elle est pertinente (mentionnez les capacités spécifiques)
- Notez les différences de niveaux si les résultats couvrent plusieurs niveaux (CERTIFIED > VERIFIED)
Étape 4 : Recommander des bundles de plugins
Lorsque la requête correspond à une catégorie de plugin connue, suggérez le bundle complet au lieu de compétences individuelles. Les bundles de plugins installent plusieurs compétences connexes en une seule fois.
Bundles de plugins disponibles (depuis anton-abyzov/vskill) :
| Plugin | Domaine | Compétences incluses |
|---|---|---|
mobile | Développement mobile | Automatisation App Store Connect (appstore) |
marketing | Marketing & comms | Publication réseaux sociaux, messagerie Slack |
google-workspace | Google Workspace | CLI Google Workspace (gws) |
productivity | Productivité personnelle | Sondage réseau d'experts |
skills | Découverte | Cette compétence — rechercher verified-skill.com et installer des compétences |
Exemple de recommandation :
« Votre requête correspond au bundle de plugins mobile, qui inclut la compétence d'automatisation App Store Connect. Au lieu d'installer des compétences individuelles, vous pouvez installer l'ensemble du bundle. »
Étape 5 : Installer
Une fois que l'utilisateur a sélectionné ce qu'il souhaite installer, exécutez la commande appropriée :
Installer une seule compétence par nom (depuis le registre) :
npx vskill install <nom-compétence>
Installer un bundle de plugins (toutes les compétences d'un domaine) :
npx vskill install --repo anton-abyzov/vskill --plugin <nom-plugin> --force
Installer TOUS les bundles de plugins en une fois :
npx vskill install --repo anton-abyzov/vskill --all --force
Le flag --force contourne la demande interactive d'analyse de sécurité (l'analyse s'exécute toujours, mais accepte automatiquement les verdicts PASS/CONCERNS). Cela est approprié pour les plugins officiels vskill qui sont pré-vérifiés.
Installer depuis un dépôt GitHub tiers :
npx vskill install <propriétaire>/<dépôt>
Installer une compétence spécifique depuis un dépôt :
npx vskill install <propriétaire>/<dépôt> --skill <nom-compétence>
Flags d'installation avancés (à utiliser selon les besoins) :
| Flag | Objectif |
|---|---|
--global | Installer dans les répertoires globaux des agents (disponible pour tous les projets) |
--select | Sélecteur interactif pour choisir des compétences et agents spécifiques |
--only-skills <noms> | Choisir précisément des compétences spécifiques d'un plugin (séparées par des virgules) |
--agent <id> | Cibler un agent IA spécifique (p. ex., claude-code, cursor) |
--copy | Forcer la copie de fichier au lieu du lien symbolique (utile en CI/containers) |
--yes / -y | Ignorer les invites de confirmation |
Étape 5b : Inspecter avant d'installer (compétences tierces)
Pour les compétences NE provenant PAS de la collection officielle anton-abyzov/vskill, inspectez toujours avant d'installer :
# Obtenir des informations détaillées (niveau de confiance, score, provenance, installations)
npx vskill info <propriétaire>/<dépôt>/<nom-compétence>
# Exécuter une analyse de sécurité locale sur un fichier de compétence
npx vskill scan <chemin-vers-SKILL.md>
Ne recommandez --force que pour les plugins officiels anton-abyzov/vskill. Pour les compétences tierces, laissez l'utilisateur examiner les résultats d'analyse et décider.
Étape 6 : Confirmer l'installation
Après avoir exécuté la commande d'installation :
- Rapportez le résultat de l'installation (succès/échec)
- Listez les agents qui ont reçu la compétence (Claude Code, Cursor, etc.)
- Mentionnez le namespace de la compétence pour l'invocation (p. ex.,
mobile:appstore) - Suggérez de redémarrer l'agent IA si nécessaire pour prendre en compte les nouvelles compétences
Étape 7 : Gérer les compétences installées
Aidez les utilisateurs à gérer leurs compétences installées sur demande :
Mettre à jour les compétences (vérifie les versions plus récentes avec analyse des différences) :
npx vskill update <nom-compétence> # Mettre à jour une compétence spécifique
npx vskill update --all # Mettre à jour toutes les compétences installées
Supprimer des compétences :
npx vskill remove <nom-compétence> # Supprimer du projet actuel
npx vskill remove <nom-compétence> --global # Supprimer de l'installation globale
Auditer un projet pour les problèmes de sécurité :
npx vskill audit # Audit complet du projet
npx vskill audit --ci # Sortie compatible CI (sort avec code non nul en cas de problème)
Gestion des erreurs
| Scénario | Action |
|---|---|
npx vskill introuvable | Dites à l'utilisateur d'installer : npm install -g vskill ou d'utiliser npx |
npm error code E401 avec npx | Un fichier .npmrc de projet avec un registre privé interfère. Utilisez : npx --registry https://registry.npmjs.org vskill <commande> ou installez globalement : npm i -g vskill --registry https://registry.npmjs.org |
| Erreur réseau lors de la recherche | Suggérez de vérifier la connexion Internet ; proposez de réessayer |
| Aucun résultat trouvé | Essayez des termes de recherche plus larges ; suggérez de visiter verified-skill.com |
| Échec de l'analyse lors de l'installation | Expliquez le problème de sécurité ; recommandez d'abord npx vskill scan pour examiner les détails ; suggérez --force uniquement si l'utilisateur comprend le risque |
| Problèmes détectés lors de l'analyse | Expliquez les résultats ; --force est plus sûr ici qu'avec FAIL |
| Compétence bloquée (liste noire) | Avertissez fortement l'utilisateur ; cette compétence présente des problèmes de sécurité connus |
| Aucun agent détecté | L'utilisateur doit d'abord installer Claude Code, Cursor ou un autre agent pris en charge |
| Limitation de débit (HTTP 429 ou GitHub 403) | Attendez une minute et réessayez ; suggérez d'utiliser --json pour réduire les appels API |
| Échec partiel de l'installation | Certaines compétences d'un bundle peuvent échouer (permissions, liens symboliques). Vérifiez npx vskill list pour voir ce qui a réussi ; réessayez les échecs individuels |
| Fichier de verrouillage désynchronisé | Exécutez npx vskill init pour resynchroniser le fichier de verrouillage avec les compétences réellement installées |
| Déjà installé (conflit de version) | Exécutez npx vskill update <compétence> pour mettre à jour, ou npx vskill remove puis réinstallez |
Exemples
Exemple 1 : Accueil d'un nouvel utilisateur
Utilisateur : « Je viens d'installer vskill. Que dois-je installer ? » Action :
- Vérifiez la pile technique du projet (package.json, go.mod, etc.)
- Présentez des recommandations de bundles adaptées au projet
- Proposez
--allpour tout installer, ou laissez-les choisir des bundles spécifiques - Installez leurs choix
Exemple 2 : Recherche par technologie
Utilisateur : « J'ai besoin d'aide pour les déploiements Kubernetes » Action :
- Exécutez
npx vskill find "kubernetes" --json - Présentez le tableau des résultats
- Recommandez les compétences pertinentes du registre
- Demandez s'ils veulent des compétences individuelles ou un bundle complet
- Installez leur choix
Exemple 3 : Installation d'une compétence spécifique
Utilisateur : « Installe la compétence Next.js » Action :
- Exécutez
npx vskill find "nextjs" --jsonpour confirmer la disponibilité - Affichez le résultat avec le niveau et le score
- Exécutez
npx vskill install <propriétaire>/<dépôt> --skill <nom-compétence>en utilisant le résultat réel de la recherche - Confirmez quels agents ont reçu la compétence
Exemple 4 : Exploration large
Utilisateur : « Quelles compétences sont disponibles ? » Action :
- Listez les 5 bundles de plugins disponibles avec leurs descriptions
- Demandez quel domaine les intéresse
- Recherchez ce domaine et présentez les compétences spécifiques
- Installez en fonction de la sélection
Exemple 5 : Recommandation contextuelle par projet
Utilisateur : « Quelles compétences aideraient pour mon projet ? » Action :
- Exécutez
npx vskill listpour vérifier ce qui est déjà installé - Examinez la pile technique du projet (package.json, Cargo.toml, go.mod, etc.)
- Identifiez les domaines pertinents (mobile, marketing, google-workspace, productivité)
- Recherchez des compétences correspondant à chaque domaine
- Présentez une liste de recommandations personnalisées (en excluant les compétences déjà installées)
- Proposez d'installer les bundles correspondants
Exemple 6 : Gérer les compétences installées
Utilisateur : « Mets à jour toutes mes compétences » / « Supprime la compétence appstore » Action :
- Pour les mises à jour : exécutez
npx vskill update --allet rapportez ce qui a changé - Pour la suppression : exécutez
npx vskill remove <nom-compétence>et confirmez - Pour l'inspection : exécutez
npx vskill info <nom-compétence>pour afficher les détails
Exemple 7 : Inspecter avant d'installer
Utilisateur : « Cette compétence Kubernetes est-elle sûre à installer ? » Action :
- Exécutez
npx vskill info <propriétaire>/<dépôt>/<nom-compétence>pour vérifier le niveau et le score - Présentez le niveau de confiance, le score de sécurité, la provenance et le nombre d'installations
- Expliquez ce que signifie le niveau (voir section Niveaux de confiance)
- Si VÉRIFIÉ ou CERTIFIÉ, confirmez que c'est sûr ; si NON ANALYSÉ, suggérez d'abord d'exécuter
npx vskill scan
Niveaux de confiance
Lors de la présentation des résultats, expliquez les niveaux de confiance pour aider les utilisateurs à prendre des décisions éclairées :
- CERTIFIED — Confiance maximale. Vérifié et certifié manuellement par l'équipe de la plateforme. Sûr à installer.
- VERIFIED — Confiance de base et au-delà. Les analyses automatiques ont réussi, l'identité de l'auteur est vérifiée. Sûr à installer.
- UNSCANNED — Aucune donnée d'analyse. Utilisez
--forcepour installer, mais examinez d'abord le contenu de la compétence. - BLOCKED — Malveillant connu. N'installez PAS sauf si vous avez une raison très spécifique et que vous comprenez les risques.
Notes importantes
- Utilisez toujours le flag
--jsonlors des recherches programmatiques pour obtenir une sortie structurée - Le flag
--forcelors de l'installation contourne les invites d'analyse mais NE ignore PAS l'analyse elle-même - N'utilisez
--forceque pour les plugins officielsanton-abyzov/vskill— pour les compétences tierces, exécutez d'abordnpx vskill infoet examinez les résultats d'analyse - Les bundles de plugins de
anton-abyzov/vskillsont la collection officielle organisée - Les compétences tierces doivent être évaluées en fonction de leur niveau de confiance et de leur score — utilisez
npx vskill info <compétence>pour vérifier - Les compétences sont installées par agent (Claude Code, Cursor, etc.) — la CLI gère les installations multi-agents
- Utilisez
--allavec--repopour installer les 5 bundles de plugins en une seule commande - Exécutez
npx vskill listavant de recommander pour éviter de suggérer des compétences déjà installées vskill searchest un alias pourvskill find— les deux fonctionnent de manière identique