Ne traitez pas le hub ou une page companion comme l’outil de travail.

Le hub liste les packs. Une page companion est la configuration : copier ou télécharger. Aucune ne dessine un wireframe, n’exécute un audit ni ne capture des breakpoints. Pour ces travaux, ouvrez l’outil navigateur correspondant ou laissez la compétence installée s’exécuter dans votre agent.

N’installez pas une fois puis ne téléchargez pas la même compétence comme second workflow.

Exécutez npx skills@latest add iruhdam1/skills ou téléchargez un pack depuis la companion — pas les deux pour la même compétence. Deux copies divergent ; l’agent peut charger celle qui est obsolète.

N’écrivez pas de descriptions à la première personne ou vagues.

Claude et d’autres hôtes découvrent les compétences à partir du champ description. La première personne (« I help you… ») ou un périmètre vide signifie que l’agent ne choisit jamais le fichier. Écrivez ce qu’elle fait et quand l’utiliser, à la troisième personne. Les notes d’auteur d’Anthropic couvrent la même règle.

Ne remplissez pas SKILL.md de tout.

Gardez le corps comme une procédure. Placez les notes longues un niveau plus bas dans un fichier de référence frère afin que les hôtes ne les chargent qu’en cas de besoin. Un mur de texte brûle le contexte et masque le déclencheur.

Ne copiez pas .agents/skills de la boutique et n’éditez pas Analog.

Le dossier .agents/skills de cette boutique (COSS, Phosphor et d’autres aides d’agent) n’est pas le pack public. Ne le copiez pas. N’éditez pas Analog. L’ensemble public est le pack GitHub listé sur le hub.

Ne poursuivez pas un listing manquant sur skills.sh.

skills.sh est un listing public plus une télémétrie d’installation. Un badge manquant n’est pas un push GitHub en échec. Utilisez GitHub ou la companion de la boutique si un pack n’est pas encore listé. Voir skills.sh vs GitHub.