/ Annuaire / Playground / skill-doctor
← Tous les serveurs ↗ GitHub
● Communauté marian2js ⚡ Instantané

skill-doctor

par marian2js · marian2js/skill-doctor

Développez vos compétences Claude avant l'expédition : frontmatter, références de ressources, clarté des déclencheurs, hygiène d'évaluation, score de 0 à 100 avec gravité.

Skill-doctor est une CLI qui analyse un ensemble de compétences locales et signale les problèmes qui nuisent à l'activation, à la fiabilité ou à la qualité. Il vérifie le contenu et les métadonnées YAML, vérifie que les références aux ressources sont ininterrompues, évalue les descriptions des déclencheurs pour plus de clarté et valide « evals/evals.json ». Le résultat est un score de 0 à 100 avec des résultats classés en termes de gravité ; prend en charge les modes texte, JSON et score uniquement – ​​parfait pour le pré-commit, le pré-routage ou le gate CI.

▶ Voir la démo 📦 Installer 💡 Cas d'usage

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

skill-doctor-skill.replay ▶ prêt
0/0

Installation

Dépôt de l’auteur · Documentation officielle des Skills Claude

Cas d'usage

Usages concrets : skill-doctor

Améliorez vos compétences avant de publier sur une place de marché

👤 Auteurs de compétences sur le point de partager un SKILL.md ⏱ ~15 min beginner

Quand l'utiliser : Vous avez terminé une compétence et souhaitez un laissez-passer mental avant que quelqu'un d'autre ne l'installe.

Prérequis
  • Nœud 18+ — nvm installer 18
Déroulement
  1. Exécutez le docteur
    Exécutez Skill-Doctor à la racine de la compétence.✓ Copié
    → Score + liste des résultats par gravité
  2. Corriger les éléments de haute gravité
    Résolvez d’abord les problèmes de haute gravité ; réexécuter jusqu'à ce que le score soit ≥ 85.✓ Copié
    → Le score grimpe ; les critiques disparaissent

Résultat : Une compétence qui s'active quand vous l'attendez et qui n'a pas de références brisées.

Pièges
  • À la poursuite d'un 100 parfait — Les articles de faible gravité (lentes de style) conviennent souvent ; se concentrer sur les déclencheurs et les ressources
Combiner avec : oaustegard-claude-skills

Créez un référentiel de compétences sur un score de qualité minimum en CI

👤 Équipes conservant plusieurs compétences dans un seul dépôt ⏱ ~30 min intermediate

Quand l'utiliser : Vous expédiez souvent des compétences et souhaitez éviter la dérive.

Prérequis
  • Actions GitHub (ou équivalent) — Dépôt avec .github/workflows/
Déroulement
  1. Ajouter le flux de travail
    Ajoutez un travail GH Actions qui exécute Skill-Doctor et échoue si le score est < 80.✓ Copié
    → Fichier de workflow ajouté ; fonctionne sur PR
  2. Définir la rigueur par chemin
    Les compétences de production échouent < 90 ; les courants d'air autorisent <70.✓ Copié
    → Seuils matriciels ou conditionnels dans le workflow

Résultat : Les PR qui dégradent la qualité des compétences sont détectés avant la fusion.

Pièges
  • Verrouiller la barre trop haut, trop tôt — Commencez permissive, resserrez sur 2-3 mois à mesure que les résultats sont corrigés
Combiner avec : agent-skills-cli-skill

Diagnostiquer pourquoi une compétence ne s'active pas

👤 Compétences des utilisateurs ayant des problèmes d'activation ⏱ ~15 min beginner

Quand l'utiliser : Vous avez installé une compétence mais Claude ne la déclenche jamais.

Déroulement
  1. Modifier la description
    Réécrivez la description afin que les mots-clés concrets des tâches utilisateur y apparaissent.✓ Copié
    → La gravité de la clarté du déclencheur diminue

Résultat : Activation plus claire ; Claude sélectionne les compétences pour les bonnes tâches.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

skill-doctor-skill + oaustegard-claude-skills

Lint avant de publier sur le marché

Exécutez Skill-Doctor localement ; puis ouvrez un PR sur oaustegard/claude-skills.✓ Copié
skill-doctor-skill + agent-skills-cli-skill

Enchaînez Skill-Doctor avec d'autres outils de création de compétences

Utilisez agent-skills-cli pour échafauder ; compétence-médecin à valider avant de s'engager.✓ Copié
skill-doctor-skill + claude-skill

Suivez le guide de création, puis lint

Écrivez selon le guide de compétences de Claude ; vérifier avec un médecin compétent.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
skill-doctor <path> skill directory path Avant la publication, dans CI, ou pour diagnostiquer les problèmes d'activation 0

Coût et limites

Coût d'exécution

Quota d'API
Aucun — analyse statique locale
Tokens par appel
Aucun (CLI, pas une API)
Monétaire
Gratuite
Astuce
Exécuter uniquement sur les répertoires modifiés ; dans CI, utilisez des filtres de chemin pour éviter d'analyser l'intégralité du dépôt à chaque PR.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Aucune information d'identification
Sortie de données : Aucun — analyse locale uniquement

Dépannage

Erreurs courantes et correctifs

Le médecin dit que SKILL.md est introuvable

Exécuté à partir de la racine de la compétence (répertoire contenant SKILL.md), et non de la racine du dépôt.

Vérifier : ls SKILL.md in CWD
Échecs du schéma 'evals/evals.json'

Assurez-vous que chaque évaluation comporte les champs obligatoires ; mieux vaut un talon minimal que cassé.

Vérifier : jq . evals/evals.json
Le score ne s'améliore pas après les modifications

Rediffusion; si un résultat persiste, lisez la gravité et les détails : les correctifs introduisent parfois de nouveaux problèmes de faible gravité.

Vérifier : Diff the JSON reports between runs

Alternatives

skill-doctor vs autres

AlternativeQuand l'utiliserCompromis
agent-skills-cli-skillVous souhaitez des outils CLI généraux pour les compétences d'échafaudage/de gestionEnsemble de fonctionnalités différent ; pas un linter
claude-skillVous voulez que le guide de rédaction comprenne à quoi ressemble le « bon »Des documents, pas un linter

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills