Skills Guide

Réparer les Subagents

VérifiéPrudence

Synchronise les Subagents avec les compétences disponibles, suggère des liaisons et supprime les liens brisés pour maintenir la cohérence de l'écosystème d'agents.

Télécharger et utiliser
Spar Skills Guide Bot
DeveloppementIntermédiaire
02/03/2026
Claude CodeCursor
#subagents#agent-skills#frontmatter#link-integrity#claude-code

Recommandé pour

Développeur backendClaude CodeRevue de codeDéveloppeur frontendCursorDéveloppeur fullstack

Synthèse automatique

Ce skill maintient la cohérence entre les définitions de subagents et les Agent Skills disponibles, en supprimant les liens morts et en proposant de nouveaux rattachements.

Points forts

  • Indexe les SKILL.md des répertoires skills/ racine et spécifiques à la plateforme en lisant le frontmatter YAML (name, description)
  • Nettoie les références obsolètes à la fois dans le frontmatter skills et dans la section ## Capabilities de l'agent
  • Réécrit les chemins relatifs selon la convention de la plateforme (Claude Code vs Cursor)
  • Synchronise le tableau de skills du corps de l'agent via les marqueurs SKILLS_START / SKILLS_END
  • Propose ou ajoute automatiquement des bindings pertinents en comparant les descriptions, avec confirmation interactive possible

Limites

  • La suggestion de nouveaux bindings repose sur une comparaison heuristique de descriptions, donc la pertinence reste approximative
  • Ne couvre que les conventions de chemins de Claude Code et Cursor
  • Modifie directement les fichiers de définition d'agents : les changements doivent être relus et versionnés
  • La synchronisation du corps de l'agent suppose que les marqueurs SKILLS_START / SKILLS_END sont déjà présents
Quand l'utiliser

À exécuter après avoir créé, renommé ou supprimé des skills, ou lorsqu'un subagent semble ne plus disposer des capacités attendues.

Quand l'éviter

À éviter si vous ne voulez pas que les fichiers d'agents soient modifiés automatiquement ou si vos définitions n'utilisent pas les conventions de chemins et les marqueurs pris en charge.

Analyse de sécurité

Prudence
Score qualité80/100

The skill performs only local, legitimate maintenance of agent definition files: scanning skills, parsing frontmatter, removing dead links, and updating tables. There are no destructive commands, network calls, secret handling, or obfuscated payloads. The concern is moderate: it writes to configuration files, can auto-apply heuristic bindings without confirmation, and declares no allowed-tools despite needing write access. This warrants caution rather than risk.

Points d'attention
  • •No allowed-tools declared even though the skill requires file reads, file writes/edits, directory scanning, and AskQuestion — an inconsistent permission surface that could lead an agent to use broad tools.
  • •Step 4 'Proactive' mending automatically adds skill bindings when heuristic confidence is 'high' without a defined threshold or user confirmation, mutating agent definitions silently.
  • •Instructions edit agent frontmatter and body sections in place with no backup, dry-run, or diff-review step, so a parsing error could corrupt agent files.
  • •No explicit path scoping/validation for the scanned skills/ and agents/ directories.
Comment cette analyse est faite

Exemples

Clean up after deleting skills
I just deleted three skills from my repo. Audit all subagents in .claude/agents and remove any references to skills that no longer exist.
Suggest missing bindings
Review each subagent definition and suggest which available Agent Skills it should be bound to but currently isn't.
Wire up a new skill
I added a new skill called deploy-checklist. Update the subagents that should reference it and refresh their Capabilities sections.

name: mend-subagents description: Synchronizes Subagents with available Agent Skills, suggesting bindings and removing broken links.

Mend Subagents

Purpose

This skill ensures that all Subagents have accurate references to the available Agent Skills. It manages the binding between agents and skills, ensuring they remain consistent as the ecosystem grows or changes.

When to Use

  • After creating new Agent Skills.
  • After deleting or renaming skills.
  • When an agent seems to lack the capabilities it needs to perform its role.

Instructions

1. Index Available Skills

  • Scan the platform-specific skills/ directory and the root skills/ directory.
  • For each SKILL.md, extract the name and description from the YAML frontmatter.

2. Audit Subagents

  • Iterate through each agent definition (e.g., in .claude/agents/ or root agents/).
  • Parse the YAML frontmatter skills list and the ## Capabilities section.

3. Synchronize Bindings

  • Remove Dead Links: If an agent references a skill that no longer exists, remove it from the frontmatter and the Capabilities section.
  • Update Links: Ensure all links point to the correct relative path for the current platform.
    • Claude Code: [skill-name](../skills/skill-name/SKILL.md)
    • Cursor: [skill-name](../../skills/meta-agent-skills/skill-name/SKILL.md)
  • Capabilities Section: Use the <!-- SKILLS_START --> and <!-- SKILLS_END --> markers to synchronize the table of skills in the agent's body.

4. Suggestive Mending (AI Heuristic)

  • Compare the Agent's description with the descriptions of all available skills.
  • If a skill appears relevant but is not bound to the agent:
    • Interactive: Suggest the binding to the user via AskQuestion.
    • Proactive: If confidence is high, add the binding and report it.

5. Final Report

  • List all agents updated.
  • List all new bindings suggested or added.
  • Highlight any broken links that were removed.

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/mend-subagents-mm8o52cb/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/mend-subagents-mm8o52cb' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/mend-subagents-mm8o52cb/download' --output '.skill-downloads/mend-subagents-mm8o52cb/SKILL.md.part' && mv '.skill-downloads/mend-subagents-mm8o52cb/SKILL.md.part' '.skill-downloads/mend-subagents-mm8o52cb/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/mend-subagents-mm8o52cb/SKILL.md' && test -s '.skill-downloads/mend-subagents-mm8o52cb/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/mend-subagents' && cp -R '.skill-downloads/mend-subagents-mm8o52cb' '.claude/skills/mend-subagents'

Cursor
test -f '.skill-downloads/mend-subagents-mm8o52cb/SKILL.md' && test -s '.skill-downloads/mend-subagents-mm8o52cb/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/mend-subagents' && cp -R '.skill-downloads/mend-subagents-mm8o52cb' '.cursor/skills/mend-subagents'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/mend-subagents-mm8o52cb'

openskills read 'mend-subagents-mm8o52cb'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/mend-subagents-mm8o52cb/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires

Bonnes pratiques React Hook Form

Developpement

Maîtrisez React Hook Form : évitez les anti-patterns, gérez les abonnements, et traitez correctement reset, dirty state et entrées contrôlées.

Claude CodeCursorWindsurf+2intermediateSûr 108,623
Skills Guide Bot

Migration Emotion vers Mantine

Developpement

Migrer les styled-components Emotion vers des composants Mantine avec style props et modules CSS. Pour convertir .styled.tsx ou supprimer les imports @emotion.

Claude CodeCursorWindsurf+1intermediateSûr 48,981
Skills Guide Bot

Détecteur de dérive de périmètre

Developpement

Analyse les diffs git par rapport à une intention pour détecter la dérive de périmètre, fichiers non liés et PR trop larges, puis suggère de garder, diviser ou justifier.

Claude CodeCursorCodexintermediateSûr 135,015
Skills Guide Bot