Que fait Éclaireur de compétences ?
Utilisez cette compétence avant d'en créer une nouvelle. L'objectif est d'éviter de dupliquer du travail existant de la communauté ou de la marketplace, tout en vérifiant tout contenu externe avant de l'adopter.
Source : récupéré de la PR communautaire obsolète #1232 par redminwang.
Quand l'utiliser
- L'utilisateur dit "créer une compétence", "construire une compétence", "fabriquer une compétence" ou "nouvelle compétence".
- L'utilisateur demande "existe-t-il une compétence pour X ?" ou "y a-t-il une compétence qui fait Y ?"
- L'utilisateur décrit un workflow et vous êtes sur le point de suggérer la création d'une nouvelle compétence.
- L'utilisateur souhaite forker ou étendre une compétence existante.
Si l'utilisateur demande explicitement d'ignorer la recherche ou de créer à partir de zéro, reconnaissez-le et poursuivez avec le workflow de création demandé.
Comment ça fonctionne
Étape 1 - Capturer l'intention
Extrayez :
- La tâche que la compétence doit accomplir.
- Les conditions de déclenchement pour l'utiliser.
- Le domaine, les outils, les frameworks ou les sources de données impliqués.
- Trois à cinq mots-clés de recherche ainsi que des synonymes utiles.
Étape 2 - Rechercher dans les sources locales
Recherchez d'abord dans les noms des compétences installées et de la marketplace. Les sources locales sont préférées car elles font déjà partie de l'environnement de l'utilisateur.
find ~/.claude/skills -maxdepth 2 -name SKILL.md 2>/dev/null | grep -iE "mot-clé|synonyme"
find ~/.claude/plugins/marketplaces -path '*/skills/*/SKILL.md' 2>/dev/null | grep -iE "mot-clé|synonyme"
Ensuite, recherchez dans les descriptions du frontmatter :
grep -RilE "mot-clé|synonyme" ~/.claude/skills ~/.claude/plugins/marketplaces 2>/dev/null
Étape 3 - Rechercher dans les sources distantes
Utilisez les outils de recherche GitHub et web disponibles. Privilégiez les requêtes concises :
gh search repos "compétence claude code mot-clé" --limit 10 --sort stars
gh search code "name: mot-clé" --filename SKILL.md --limit 10
Pour la recherche web, utilisez au maximum trois requêtes ciblées telles que :
"compétence claude code" mot-clé
"SKILL.md" mot-clé
"everything-claude-code" mot-clé
Étape 4 - Vérifier les correspondances externes
Avant de recommander une compétence externe pour adoption ou fork :
- Lisez le frontmatter et les instructions du
SKILL.md. - Recherchez des commandes shell inattendues, des écritures de fichiers, des appels réseau, de la gestion d'identifiants ou des installations de paquets.
- Vérifiez si le dépôt semble maintenu.
- Privilégiez la copie dans une nouvelle branche locale et la révision du diff plutôt que la modification des originaux de la marketplace.
Étape 5 - Classer les résultats
Classez les candidats par :
- Correspondance exacte du mot-clé dans le nom de la compétence.
- Correspondance du mot-clé ou du synonyme dans la description.
- Source locale installée ou marketplace.
- Source GitHub maintenue avec activité récente.
- Mention web uniquement.
Limitez la liste finale à 10 résultats.
Étape 6 - Présenter les options de décision
Donnez à l'utilisateur un court tableau :
| Option | Signification |
|---|---|
| Utiliser existante | Invoquer ou installer une compétence correspondante telle quelle. |
| Forker ou étendre | Copier la compétence la plus proche et la modifier. |
| Créer de zéro | Construire une nouvelle compétence après avoir confirmé qu'aucune correspondance proche n'existe. |
Ne créez une nouvelle compétence qu'après que l'utilisateur a choisi cette voie ou après que la recherche n'a trouvé aucune correspondance proche.
Exemples
Tableau de résultats
| # | Compétence | Source | Pourquoi elle correspond | Écart |
| --- | --- | --- | --- | --- |
| 1 | article-writing | ECC local | Rédige des articles et des guides | Non axé sur les notes de version |
| 2 | content-engine | ECC local | Workflow de contenu multi-format | Plus lourd que nécessaire |
| 3 | blog-writer | GitHub | Compétence d'écriture de blog avec commits récents | Nécessite une revue de sécurité |
Résumé pour l'utilisateur
J'ai trouvé deux correspondances locales proches et un candidat externe. La plus proche est
`article-writing` ; elle couvre la rédaction et la révision, mais elle n'inclut pas la liste de contrôle
de notes de version que vous avez demandée. Je peux soit l'utiliser telle quelle, la forker en une variante
pour notes de version, soit créer une compétence de zéro.
Anti-patrons
- Ne sautez pas directement à la création d'une nouvelle compétence alors qu'une recherche est raisonnable.
- N'installez pas de compétences externes sans les avoir lues d'abord.
- Ne présentez pas une longue liste non classée de correspondances faibles.
- Ne traitez pas les mentions web uniquement comme des sources fiables.
- Ne modifiez pas les originaux installés de la marketplace sur place.
Associé
search-first- Workflow général de recherche avant construction.skill-stocktake- Auditer les compétences installées pour la santé, les doublons et les lacunes.agent-sort- Catégoriser et organiser les agents et compétences existants.