SkillSmith

Que fait SkillSmith ?

Génère des compétences d'agent conformes à la spécification à partir d'une simple idée, et vérifie les fichiers SKILL.md (règles de nommage, longueur de la description et son contenu « quand utiliser », limite de compatibilité, dictionnaire de métadonnées, longueur du corps, secrets divulgués). Le CLI sans dépendance cli.js situé à la racine du dépôt SkillSmith effectue le travail.

Quand utiliser

• L'utilisateur souhaite une nouvelle compétence pour une tâche (« crée une compétence qui… »).
• L'utilisateur veut savoir si un dossier de compétence ou un fichier SKILL.md respecte le standard, ou souhaite le corriger.

Étapes

1. Pour valider, exécutez node <chemin-vers-skillsmith>/cli.js validate <dossier-compétence> (plusieurs dossiers sont autorisés). Le code de sortie 0 signifie valide.
2. Signalez chaque erreur et corrigez-les dans le SKILL.md de l'utilisateur : renommez avec des noms en minuscules avec traits d'union, faites correspondre le nom du dossier avec name, gardez la description à 1024 caractères ou moins et incluez « Utiliser quand… ». Puis relancez l'étape 1.
3. Pour créer une compétence, assurez-vous que GEMINI_API_KEY est définie (ne l'affichez jamais), puis exécutez node <chemin-vers-skillsmith>/cli.js new "<description de ce qu'elle fait et quand l'utiliser>" --out <dossier-compétences> --author "<nom>".
4. Montrez à l'utilisateur le SKILL.md généré, puis lancez l'étape 1 sur le nouveau dossier. Modifiez si nécessaire ; le CLI ne remplace jamais un SKILL.md existant.

Exemples

• node cli.js validate skills/commitcraft skills/skillsmith
• node cli.js new "Résume un fichier CSV et suggère des graphiques. À utiliser lorsque l'utilisateur partage un .csv" --out ./skills

Remarques

• Les champs de premier niveau inconnus produisent un avertissement ; les données personnalisées doivent figurer sous metadata.
• La spécification recommande un corps de moins de 500 lignes ; déplacez les longues documentations dans references/.