controle-voix
Skill2 starsChanged 20 days agoMITView on GitHub
Installe le lint de voix : un script qui contrôle chaque texte contre les règles dures et mesurables de la voix de l'utilisateur (mots et tournures interdits, tirets longs, répétitions en début de phrase), règles écrites dans un fichier JSON rempli pendant l'interview. Utiliser quand l'utilisateur dit « ça sonne IA », « Claude répète les mêmes tics », « vérifie mon style avant de publier ». Pas pour la vérité des chiffres (utiliser controle-verite), pas pour écrire le guide de voix (bloc D).
In this repository87 other files it gives its agents.
- kit-site-cloudflare/CLAUDE.mdCLAUDE.md
- accrochesSkill
- agent-client-idealSkill
- ameliorer-les-skillsSkill
- appel-de-venteSkill
- appels-analyseSkill
- apps-locales-et-modsSkill
- architecture-vaultSkill
- article-lettre-seoSkill
- banque-ideesSkill
- bibliothecaire-installerSkill
- bibliothecaireSkill
- board-textesSkill
- carnets-expertsSkill
- carrousel-htmlSkill
- carrousel-image-iaSkill
- catalogue-automatisationsSkill
- charte-graphiqueSkill
- claude-sans-fenetreSkill
- cockpit-appSkill
- coeur-claude-mdSkill
- comite-decisionSkill
- comite-roast-ancreSkill
- connecteurs-mcpSkill
- controle-veriteSkill
- couts-et-limitesSkill
- creer-un-skillSkill
- crm-et-messagesSkill
- decoupe-shortsSkill
- distribution-apiSkill
- dossier-client-idealSkill
- email-listeSkill
- entretien-fondateurSkill
- essais-multiplesSkill
- fiches-clientsSkill
- fin-de-sessionSkill
- format-et-autonomieSkill
- gardienSkill
- hooks-ecrireSkill
- images-de-marqueSkill
- ingestion-appelsSkill
- ingestion-articlesSkill
- ingestion-driveSkill
- ingestion-fichiersSkill
- ingestion-notionSkill
- ingestion-reseauxSkill
- jardinierSkill
- journal-coachSkill
- lint-wikiSkill
- memoire-fichiersSkill
- mesure-et-apprentissageSkill
- montage-video-codeSkill
- notebooklm-brancherSkill
- notifications-telegramSkill
- offre-et-echelleSkill
- outils-locauxSkill
- passation-repriseSkill
- plan-uniqueSkill
- posts-reseauxSkill
- pubs-apres-tunnelSkill
- The first 60 shown.
The file
Files
Le lint de voix
Pourquoi
Un guide de voix se lit une fois et s'oublie ; un script se lance à chaque texte. Dans le système d'origine, les tics d'écriture de l'IA revenaient sans cesse (tirets longs, « ce n'est pas X, c'est Y », trois phrases qui commencent pareil, anglicismes) malgré les consignes. Un lint sans modèle de langue, qui sort 1 dès qu'une règle dure tombe, a réglé ça : la chaîne de production le lance en dernier, et un texte qui échoue ne part pas.
Prérequis
- Le guide de voix de l'utilisateur (bloc D, entretien fondateur et voix) et quelques textes qu'il a écrits lui-même.
- Python 3.8 ou plus.
Interview
Lis d'abord : le guide de voix du vault, 3 à 5 textes écrits par l'utilisateur (pas par Claude), et les corrections qu'il a déjà faites sur des textes de Claude (mémoire feedback_*).
Puis demande, en petit lot :
- « Quels mots tu ne veux JAMAIS voir dans tes textes ? » (exemples à proposer : anglicismes, mots de jargon, tics de ta région que tu ne veux pas à l'écrit.) Pour chacun : « Par quoi on le remplace, ou on le signale seulement ? »
- « Quelles tournures te font dire " ça, c'est écrit par une IA " ? » (proposer : le tiret long, « ce n'est pas X, c'est Y », trois phrases de suite qui commencent par le même mot, la liste de trois en rythme.)
- « Tu tutoies ou tu vouvoies ton client ? » (une règle mesurable : un motif sur « vous » ou « tu », selon la réponse.)
- « Y a-t-il des mots sensibles dans ton métier qu'il faut remplacer ? »
- « Quand un texte cite quelqu'un mot pour mot, on laisse la citation intacte ? » (par défaut : oui, les lignes « > » sont signalées, jamais corrigées.)
Ce qui ne se mesure pas (« trop froid », « pas assez moi ») reste dans le guide de voix. Range les règles mesurables dans regles-voix.json.
Construire
- Poser l'outil (Claude) : copier
outils/lint_voix.pydansscripts/lint_voix.pydu vault.python scripts/lint_voix.py selftestdoit imprimerselftest OK. - Écrire les règles (Claude) : copier
outils/regles-voix.modele.jsonenregles-voix.jsonà la racine du vault, puis le remplir :mots_interdits: un objet par mot, avecremplacer_parquand le remplacement est sûr partout, sans quand il dépend du contexte (alors le script signale et l'humain ou Claude réécrit).motifs_interdits: une expression régulière par tournure, avecmessage(pourquoi) etniveau(durbloque,alertesignale). Le modèle contient déjà l'antithèse « ce n'est pas X, c'est Y ».anaphore:min(3 par défaut) et les petits mots à ignorer en début de phrase. Claude teste chaque nouvelle règle sur une phrase qui doit tomber et une qui doit passer, avant de la garder.
- Lancer :
python scripts/lint_voix.py <texte> # 0 propre, 1 règle dure tombée, 2 problème d'usage python scripts/lint_voix.py <texte> --fix # applique les remplacements sûrs, puis contrôle python scripts/lint_voix.py <texte> --json # pour les scripts - Brancher (Claude) : dernière étape de chaque skill qui écrit pour les clients, siège Voix du board, et chaque skill de publication avant la porte. Règle dans
CLAUDE.md: « Tout texte pour les clients sort 0 au lint de voix avant d'être montré. » - Relecture humaine de ce que le script ne voit pas. Écrire dans le guide de voix les deux ou trois tics que le lint rate encore (exemple : la liste de trois en rythme, difficile à mesurer sans faux positifs), et demander à Claude de les relire à la main sur les textes longs.
Test
Sur un texte piège (un tiret long, une tournure interdite, trois phrases de suite au même premier mot, un mot banni) : lint_voix.py sort 1 et nomme chaque ligne. Sur un vrai texte de l'utilisateur, relu et approuvé par lui : il sort 0. Si ce texte approuvé sort 1, une règle est trop large : la resserrer.
Pièges vécus
- Un mot exclu, un trou dans le filet. Le premier lint ignorait les pronoms en début de phrase, pour éviter les faux positifs. Résultat : « Tu... Tu... Tu... », la répétition la plus fréquente, passait. Ici les pronoms ne sont jamais exclus par défaut.
- Corriger une citation. Remplacer un mot dans une phrase citée mot pour mot la rend fausse. Les lignes « > » sont signalées, jamais corrigées.
- Les URL et le code. Un double tiret dans une adresse web ou une commande n'est pas une faute de style. Le script les ignore.
- Le remplacement automatique aveugle. Certains mots ont un sens correct selon le contexte. Sans
remplacer_par, le script signale seulement, et la phrase se réécrit avec du sens. - Un juge de style par modèle de langue varie. Pour les règles dures, un script déterministe : même texte, même verdict, chaque fois. Le modèle reste utile pour le reste du guide, en relecture.
- L'outil « anti-IA » qui invente. Un outil qui réécrivait les textes pour les rendre « plus humains » ajoutait des faits inventés. Le lint ne réécrit rien d'autre que les remplacements que l'utilisateur a validés.
Entretien dans le temps
- Chaque fois que l'utilisateur corrige un tic dans un texte de Claude : se demander s'il se mesure. Si oui, une règle de plus dans
regles-voix.json, testée, et une ligne dans le selftest si c'est un cas délicat. - Une fois par trimestre : relancer le lint sur les textes publiés du trimestre. Une règle qui ne tombe jamais peut sortir ; une alerte qui tombe souvent sur de bons textes se retire.
Après
Mets à jour wiki/maps/parcours.md, log.md, la mémoire (« le lint de voix est la dernière étape de tout texte »). Propose ensuite board-textes s'il n'est pas fait, sinon skills-marketing.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

