Trouvez le dossier installé ; éditez SKILL.md.

Ouvrez le répertoire de la compétence sur le disque et éditez SKILL.md. C’est le fichier que les hôtes chargent. Alignez le nom du dossier et le name du frontmatter lorsque l’hôte exige une correspondance (Cursor et VS Code indiquent que le nom doit correspondre au dossier parent).

Description à la troisième personne : ce qu’elle fait et quand l’utiliser.

Les champs obligatoires de la norme ouverte sont name et description. La description est le moyen par lequel l’agent découvre la compétence. Troisième personne, déclencheurs concrets, pas de voix d’assistant à la première personne.

Gardez le corps comme une procédure.

Rédigez des étapes que l’agent peut suivre. Déplacez les notes longues vers un fichier de référence frère un niveau plus bas et liez-le depuis le corps afin que le chargement progressif fonctionne encore.

Réinvoquez /skill-name ou un prompt correspondant.

Dans Claude, saisissez /skill-name. Dans Cursor, / et le nom de la compétence. Dans Codex, /skills ou $ pour la mentionner. Ou demandez en langage clair en utilisant les mêmes mots déclencheurs que la description.

N’éditez pas Analog ni .agents/skills de la boutique.

Laissez Analog et le .agents/skills interne de cette boutique. Ce ne sont pas le pack public. Voir Comment ne pas utiliser les compétences portables.