Transformer un document en SKILL.md

Ce que le convertisseur écrit

Une skill est un dossier avec un seul fichier obligatoire, SKILL.md. Le fichier commence par un court bloc YAML (le frontmatter) et se poursuit avec vos instructions en Markdown. Le format ouvert Agent Skills exige deux champs dans ce bloc :

• name : de 1 à 64 caractères, lettres minuscules, chiffres et tirets, sans tiret au début ni à la fin, et sans deux tirets à la suite. Il doit correspondre au nom du dossier.
• description : de 1 à 1 024 caractères sur ce que fait la skill et quand l'utiliser.

Le convertisseur tire le nom du premier titre de votre document, rédige une description à partir de la première phrase, nettoie les puces et ajoute un titre si le document n'en a pas. Modifiez l'un ou l'autre champ : le fichier se met à jour pendant la saisie. Les règles d'Anthropic en ajoutent deux : un nom ne peut pas contenir « anthropic » ni « claude », et aucun des deux champs ne peut contenir de balises XML. Le convertisseur vérifie les deux.

Où placer le fichier

• Claude (web et ordinateur) : allez dans Customize > Skills, cliquez sur +, puis Create skill > Upload a skill, et choisissez le .zip. Il contient le dossier avec SKILL.md à l'intérieur, la forme que demande Claude. L'exécution de code doit être activée. (menus cités tels qu’ils s’affichent en anglais)
• Claude Code : décompressez dans ~/.claude/skills/ pour vous-même, ou dans .claude/skills/ d'un dépôt pour toutes les personnes qui le clonent.
• Codex, Cursor, OpenCode : chacun lit les dossiers de skills à son propre emplacement ; le guide de synchronisation les liste.

Chaque copie placée à la main est une copie que quelqu'un doit mettre à jour à la main. C'est ce travail qu'AI Skill Pod prend en charge.

Écrire une description sur laquelle l'IA agira

L'IA ne voit que le nom et la description de chaque skill jusqu'à ce que l'une corresponde à la demande : c'est donc la description qui décide si votre skill sera ouverte. Trois habitudes aident :

• Commencez par ce qu'elle fait : « Rédige les réponses de remboursement dans le ton de notre support. »
• Puis dites quand : « À utiliser quand un client demande un remboursement, un retour ou une rétrofacturation. »
• Citez les mots que les gens tapent : noms de produits, types de fichiers, termes propres à l'équipe.