Contrat d'Activation
Utilisez ce skill lors de l'audit, de la refactorisation, de la normalisation ou de l'amélioration des fichiers SKILL.md existants. Utilisez gentle-ai-skill-creator lors de la création d'un tout nouveau skill à partir d'un motif réutilisable.
Règles Strictes
- Lisez
docs/skill-style-guide.mden premier et traitez-le comme le contrat de style normatif. - Traitez
SKILL.mdcomme la source de vérité ; préservez l'intention de l'auteur, les règles critiques, la sémantique d'activation et les exigences de sortie. - Utilisez
.atl/skill-registry.mdcomme index des noms de skills, déclencheurs, portées et chemins exacts lorsqu'il est disponible. - Par défaut, procédez à un audit uniquement. Modifiez les fichiers uniquement lorsque l'utilisateur demande explicitement d'appliquer des améliorations.
- Ne supprimez jamais de contenu significatif en silence ; déplacez les longues explications, exemples, modèles ou schémas dans les répertoires locaux
references/ouassets/. - N'inventez pas de déclencheurs, politiques ou règles de domaine. Signalez les cas ambigus pour révision humaine.
Portes de Décision
| Situation | Action |
|---|---|
| Front-matter manquant ou invalide | Corrigez name, description sur une ligne avec guillemets, license et metadata |
| Le skill ressemble à un tutoriel | Convertissez en instructions d'exécution et déplacez le contexte dans references/ |
| Le corps dépasse le budget | Préservez les règles, déplacez les exemples/contexte dans des fichiers de support |
| Logique de branchement cachée dans la prose | Convertissez en un tableau de décision compact |
| Conflit de règles ou intention floue | Signalez le problème ; ne réécrivez pas cette règle automatiquement |
Étapes d'Exécution
- Lisez
docs/skill-style-guide.md. - Lisez
.atl/skill-registry.md; utilisez les chemins listés pour sélectionner les skills. En l'absence, scannez les répertoires de skills connus pour*/SKILL.md. - Pour chaque skill sélectionné, auditez les métadonnées, la clarté du déclencheur, l'ordre des sections, le budget du corps, l'actionnabilité, les portes de décision, le contrat de sortie et les références locales.
- Retournez un rapport d'audit groupé par skill avec la sévérité et les modifications exactes proposées.
- En mode application, modifiez uniquement les problèmes sûrs, préservez le contenu, créez des fichiers de support si nécessaire, puis rafraîchissez ou demandez
/skill-registry:refresh.
Contrat de Sortie
Retournez :
- Skills audités et chemins utilisés.
- Problèmes trouvés, groupés par sévérité.
- Fichiers modifiés, si le mode application a été demandé.
- Recommandation de rafraîchissement du registre lorsque les métadonnées ou les chemins des skills ont changé.
- Ambiguïtés nécessitant une révision humaine.
Références
docs/skill-style-guide.md— guide de style normatif pour les skills LLM-first.skills/skill-registry/SKILL.md— contrat de rafraîchissement et d'indexation du registre.