skill-doctor MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Valide le frontmatter SKILL.md et les métadonnées YAML
Détecte les liens rompus et les ressources du bundle manquantes
Les scores déclenchent la description et la clarté des instructions
Valide le schéma evals/evals.json
Score de 0 à 100 avec des résultats exploitables
Formats de sortie : texte, JSON, partition uniquement
Modèle de workflow GitHub Actions intégré

Démo en direct

Aperçu en pratique

skill-doctor-skill.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "skill-doctor-skill",
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "skill-doctor-skill": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "skill-doctor@latest",
          "."
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add skill-doctor-skill -- npx -y skill-doctor@latest .

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

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

Exécutez le docteur

Exécutez Skill-Doctor à la racine de la compétence.✓ Copié

→ Score + liste des résultats par gravité
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

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
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

Exécutez le médecin sur le répertoire de compétences

Exécutez Skill-doctor sur ~/.claude/skills/<skill>.✓ Copié

→ Les résultats mettent en évidence des problèmes de déclenchement ou de front-matter faibles
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

Outil	Entrées	Quand appeler	Coû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

le médecin compétent signale des problèmes structurels ; il ne juge pas la sécurité. Un score élevé ≠ une compétence sûre – révisez quand même ce que la compétence demande à Claude de faire.

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

Alternative	Quand l'utiliser	Compromis
agent-skills-cli-skill	Vous souhaitez des outils CLI généraux pour les compétences d'échafaudage/de gestion	Ensemble de fonctionnalités différent ; pas un linter
claude-skill	Vous 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