Gentleman-Programming/gentle-ai-skill-creator

Contrat d'activation

Utilisez cette compétence lors de la création ou de la mise à jour d'une compétence IA réutilisable pour Pi ou un autre runtime d'agent.

Créez une compétence lorsque :

• un workflow ou une convention est réutilisé d'une session à l'autre ;
• un comportement générique d'agent a besoin de contraintes spécifiques au projet ;
• un arbre de décision aide l'agent à choisir en toute sécurité ;
• des exemples, modèles ou références rendraient l'exécution future plus fiable.

Ne créez pas de compétence pour une tâche ponctuelle, une documentation générique ou des règles qui appartiennent au code/aux tests.

Règles strictes

• Suivez docs/skill-style-guide.md comme source normative pour la structure et le style de la compétence.
• Une compétence est un contrat d'exécution LLM, pas une documentation destinée aux humains.
• Gardez SKILL.md concis : ciblez 180 à 450 tokens, maximum 1000.
• Utilisez des instructions impératives et des portes concrètes ; évitez les tutoriels et le texte de fond.
• La description du frontmatter doit être une ligne physique compatible YAML et inclure les mots déclencheurs en premier.
• N'ajoutez pas de section Keywords ; placez les mots déclencheurs essentiels dans la description.
• Mettez les modèles, schémas et exemples générés dans assets/.
• Mettez les justifications plus longues ou les liens vers la documentation locale dans references/.
• Après avoir modifié les compétences du projet, actualisez le registre avec /skill-registry:refresh lorsque disponible.

Portes de décision

Besoin	Action
Petit comportement réutilisable	Créez uniquement skills/{skill-name}/SKILL.md
Modèles, schémas, exemples	Ajoutez skills/{skill-name}/assets/
Explication longue ou cas particuliers	Ajoutez skills/{skill-name}/references/
Une compétence existante couvre le besoin	Mettez à jour la compétence existante
La compétence affecte la découverte de délégation	Assurez-vous que les mots déclencheurs apparaissent dans la description

Étapes d'exécution

1. Lisez docs/skill-style-guide.md avant de créer ou de mettre à jour des compétences.
2. Inspectez les compétences existantes et confirmez que la nouvelle ne fait pas double emploi.
3. Choisissez un nom de compétence en kebab-case qui correspond au déclencheur visible par l'utilisateur.
4. Créez ou mettez à jour cette structure :

skills/{skill-name}/
├── SKILL.md
├── assets/       # optionnel
└── references/   # optionnel

5. Utilisez ce modèle de frontmatter :

---
name: {skill-name}
description: "Trigger: {phrases que les utilisateurs ou agents diront}. {Ce que fait cette compétence}."
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.0"
---

6. Écrivez les sections dans cet ordre : Contrat d'activation, Règles strictes, Portes de décision, Étapes d'exécution, Contrat de sortie, Références.
7. S'il s'agit d'une compétence packagée gentle-pi, ajoutez-la dans scripts/verify-package-files.mjs.
8. Actualisez ou documentez le chemin de mise à jour du registre de compétences.

Contrat de sortie

Retournez :

• Les fichiers créés ou modifiés.
• Si cela a créé une nouvelle compétence ou mis à jour une compétence existante.
• Tout fichier assets/ ou references/ ajouté.
• Si une vérification du package ou une actualisation du registre de compétences est nécessaire.

Références

• docs/skill-style-guide.md — guide de style normatif axé LLM pour les compétences.
• skills/skill-registry/SKILL.md — contrat d'actualisation et d'indexation du registre.