Clarity

writing-clearly-and-concisely est un skill de révision réutilisable pour retravailler des textes destinés à être lus par des humains. Il aide à transformer des brouillons verbeux, vagues ou au ton trop IA en un anglais simple et direct pour la documentation, les README, les messages de commit, les descriptions de PR, les messages d’erreur, le texte d’interface, les rapports et les explications. Le repo associe des règles de clarté dans l’esprit de Strunk à des conseils pratiques pour éviter les formulations IA inutilement ampoulées.

requirements-clarity est un workflow structuré qui transforme des demandes de fonctionnalités floues en exigences prêtes pour l’implémentation. Il repère les zones de périmètre manquantes, les contraintes, les critères d’acceptation, les cas limites et le contexte technique, puis pose des questions ciblées en plusieurs passes afin de produire un livrable plus clair, de type PRD, avant le démarrage du code.

naming-analyzer passe en revue les variables, fonctions, classes, fichiers, champs de base de données et noms d’API afin de repérer les identifiants vagues ou trompeurs, puis propose des alternatives plus claires et alignées sur les conventions pour la revue de code et le refactoring.