Better Codex
Ce skill constitue une « reliability overlay » destinée à corriger au niveau prompt les comportements problématiques les plus fréquemment reprochés à Codex lors de travaux sur une codebase. Il est publié par l'utilisateur GitHub noobnooc dans son repository personnel noobnooc/noobnooc, aux côtés d'autres agent skills comme wtf.
Ce que couvre le skill
Le SKILL.md est entièrement rédigé et structuré autour de plusieurs contrats de comportement :
- Core Contract : limiter la portée aux chemins et fichiers explicitement désignés par l'utilisateur, traiter investigation et audit comme des opérations en lecture seule.
- Request Validation : confronter la demande de l'utilisateur aux faits du code et à l'architecture existante avant d'exécuter, plutôt que d'implémenter aveuglément une direction techniquement douteuse.
- Working With Files & Execution Behavior : re-lire les fichiers avant modification, préférer les patches ciblés, aller au bout de l'implémentation sans s'arrêter à mi-chemin.
- Implementation Quality & Product Quality : partir de la couche la plus profonde pertinente, éviter les patches superficiels, produire des interfaces cohérentes et non génériques.
- Project Artifact Boundary : ne pas laisser fuiter le raisonnement interne, les notes d'implémentation ou les fragments de prompt dans le repository ou l'UI produit.
- Tests, Reviews, Context Discipline : privilégier des tests qui exercent de vrais comportements, structurer les revues par criticité, et respecter les instructions locales (
AGENTS.md,SKILL.md, etc.).
Comment l'utiliser
Ce skill s'active en le référençant dans un agent Claude (par exemple via Codex) qui travaille sur une codebase. Les règles s'appliquent silencieusement : l'agent ne cite pas les plaintes publiques qui ont motivé chaque règle, il les suit simplement. Il n'est pas nécessaire de modifier le fichier pour un usage standard ; il suffit de pointer l'agent vers ce SKILL.md.
Pour l'adapter à un projet spécifique, on peut dupliquer le dossier skills/better-codex/ et ajuster les sections selon les contraintes architecturales ou les conventions propres au projet cible.