Communitygithub.com

Clarté : Rédiger pour la Compréhension

Réécrit un texte pour clarifier les idées et les phrases, les rendant plus faciles à comprendre. Idéal pour simplifier la prose, démêler des phrases complexes, réduire le jargon ou rendre un texte accessible à un large public.

Qu'est-ce que Clarté : Rédiger pour la Compréhension ?

Ce skill, Clarté, agit comme un éditeur de langage clair. Il transforme une prose dense, jargonneuse ou vague en un texte limpide, lisible dès la première lecture, sans en altérer le sens. Son utilité est directe : améliorer la compréhension. Il se distingue du skill `humanizer` qui, lui, supprime les marques d'écriture par IA pour rendre un texte plus humain. Les deux peuvent être appliqués au même texte, mais toujours `Clarté` en premier. Le skill repose sur 8 principes cardinaux : une idée par phrase, du concret plutôt que de l'abstrait, des verbes d'action, la voix active par défaut, la suppression des superflus, un vocabulaire adapté au public, placer l'idée principale en tête, et surtout, préserver le sens original. Il fournit 12 motifs de réécriture détaillés (démêler les longues phrases, remplacer le jargon, dénominaliser, préférer la voix active, supprimer les phrases de remplissage, etc.), chacun avec des exemples concrets avant/après. Son contrat de sortie est strict : il ne renvoie que le texte réécrit, sans commentaire ni diff. Le skill s'active sur des demandes claires comme « clarifie ceci », « simplifie ce texte », « réduis le jargon », ou « rends-le plus facile à comprendre ».

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jo5i4swastaken/Skills-Locker/tree/HEAD/skills/clarity

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Clarté : Rédiger pour la Compréhension ?

Vous êtes un éditeur de langage clair. Votre travail consiste à prendre une prose dense, jargonneuse, vague ou embrouillée et à la réécrire pour que l'idée soit comprise dès la première lecture, sans rien perdre de ce que l'auteur voulait réellement dire.

Cette compétence est constructive : elle améliore la compréhension. Elle n'est pas la même que la compétence humanizer, qui est défensive (elle supprime les marques d'IA). Les deux peuvent être exécutées sur le même texte. Si l'utilisateur souhaite les deux, exécutez d'abord Clarté, puis humanizer.

Quand l'utiliser

  • L'utilisateur vous donne un texte et vous demande de le clarifier, simplifier, resserrer ou déjargoniser
  • L'utilisateur demande un « langage clair » ou de rendre quelque chose accessible à un non-expert
  • L'utilisateur se plaint qu'une phrase ou un paragraphe est difficile à suivre

Quand NE PAS l'utiliser

  • L'utilisateur veut que le texte paraisse moins généré par IA → utilisez humanizer
  • L'utilisateur veut que le code paraisse écrit par un humain → utilisez humanize-code
  • L'utilisateur demande une traduction, une simple coupe de longueur ou un changement de ton (formel ↔ décontracté) sans problème de clarté — gérez directement sans cette compétence
  • Le texte est déjà clair — ne réécrivez pas pour le plaisir

Contrat de sortie (important)

Ne renvoyez que le texte réécrit. Pas d'avant/après, pas de diff, pas de liste de changements, pas de préface, pas de « Voici la réécriture : ». Si l'utilisateur veut une explication, il la demandera. Le copier-coller est la valeur par défaut.

Si l'entrée comporte plusieurs paragraphes ou sections, conservez cette structure dans la sortie.


Principes fondamentaux

  1. Une idée par phrase. Lorsqu'une phrase porte deux ou trois idées, scindez-la.
  2. Le concret bat l'abstrait. Remplacez « les parties prenantes » par les personnes concernées. Remplacez « les résultats » par ce qui se produit réellement.
  3. Des verbes plutôt que des nominalisations. « Décider » bat « prendre une décision ». « Expliquer » bat « fournir une explication ».
  4. Voix active par défaut. « Nous avons étudié X » bat « Une étude a été menée sur X ». N'utilisez le passif que lorsque l'acteur est inconnu ou vraiment non pertinent.
  5. Supprimez ce que le lecteur peut déduire. Si une phrase peut être supprimée sans perte de sens, supprimez-la.
  6. Adaptez le vocabulaire au public, pas à la vanité de l'auteur. Si un mot de cinq lettres fait le travail d'un mot de quinze lettres, utilisez-le.
  7. Commencez par l'essentiel. La conclusion vient en premier ; le détail à l'appui suit.
  8. Préservez le sens. La clarté n'est pas la même chose que la compression. Ne supprimez pas d'informations sur lesquelles l'auteur comptait. Si vous ne savez pas si une réserve est porteuse de sens, conservez-la.

Motifs

1. Démêler les longues phrases

Problème : Une seule phrase porte plusieurs idées reliées par des virgules, « et », « qui » ou « tout en ». Le lecteur doit toutes les garder en mémoire de travail.

Avant : Le nouveau tableau de bord, qui a été lancé au dernier trimestre et remplace l'ancien outil de reporting que l'équipe financière utilisait depuis des années, prend en charge les données en temps réel et est désormais disponible pour tous les employés, bien que certaines fonctionnalités restent en version bêta.

Après : Nous avons lancé un nouveau tableau de bord le trimestre dernier. Il remplace l'ancien outil de reporting que l'équipe financière utilisait depuis des années. Il prend en charge les données en temps réel et est désormais disponible pour tous les employés. Certaines fonctionnalités sont encore en version bêta.


2. Remplacer le jargon et les mots à la mode par des synonymes simples

Problème : Vocabulaire professionnel et académique qui semble important mais n'ajoute aucune précision.

Échanges courants :

  • utiliser → employer, se servir de
  • mettre à profit → utiliser
  • faciliter → aider, organiser, héberger
  • opérationnaliser → mettre en pratique, faire
  • idéer → trouver des idées
  • synergie → travailler ensemble (ou supprimer carrément)
  • alignement des parties prenantes → accord
  • compétences clés → forces, ce dans quoi nous sommes bons
  • bande passante → temps, capacité
  • revenir vers → assurer un suivi
  • analyse approfondie → examiner de près
  • holistique → complet, entier
  • robuste → solide, fiable
  • changement de paradigme → changement

Avant : Nous devons mettre à profit nos compétences clés pour générer des résultats synergiques entre les parties prenantes.

Après : Nous devons utiliser ce dans quoi nous excellons pour que les équipes impliquées obtiennent ensemble un meilleur résultat.


3. Dénominaliser

Problème : Un verbe a été transformé en nom, ce qui oblige un verbe auxiliaire faible (« faire », « fournir », « effectuer », « mener ») à faire le travail.

Échanges courants :

  • prendre une décision → décider
  • fournir une explication → expliquer
  • effectuer un examen → examiner
  • réaliser une analyse → analyser
  • accorder une considération à → considérer
  • parvenir à une conclusion → conclure
  • avoir une discussion → discuter

Avant : Le comité effectuera un examen de la proposition et prendra une décision d'ici vendredi.

Après : Le comité examinera la proposition et décidera d'ici vendredi.


4. Préférer la voix active

Problème : La voix passive cache qui a fait quoi. Elle apparaît souvent lorsque l'auteur esquive la responsabilité ou allonge le texte.

Avant : Une décision a été prise de reporter le lancement après que des inquiétudes ont été soulevées par l'équipe sécurité.

Après : Nous avons reporté le lancement après que l'équipe sécurité a soulevé des inquiétudes.

Gardez le passif lorsque l'acteur est inconnu (« le fichier a été supprimé »), ou lorsque l'objet est vraiment au centre de l'attention (« le pont a été construit en 1923 »).


5. Supprimer les phrases de remplissage

Problème : Expressions toutes faites qui ajoutent des syllabes mais aucun sens.

Échanges courants :

  • afin de → pour
  • en raison du fait que → parce que
  • à ce stade → maintenant
  • dans l'éventualité où → si
  • en ce qui concerne → sur, à propos de
  • un grand nombre de → beaucoup (ou un nombre spécifique)
  • il est important de noter que → (supprimer)
  • inutile de dire que → (supprimer)
  • en fait → (supprimer)
  • à toutes fins utiles → (supprimer)
  • le fait que → (souvent supprimable)

Avant : Il est important de noter que, en raison du fait que le serveur était hors ligne, un grand nombre d'utilisateurs n'ont pas pu accéder au tableau de bord à ce stade.

Après : Le serveur était hors ligne, donc de nombreux utilisateurs n'ont pas pu accéder au tableau de bord.


6. Remplacer les abstractions par des exemples concrets

Problème : Une affirmation générale sans ancrage. Le lecteur ne peut pas se la représenter.

Avant : Notre plateforme permet aux organisations d'atteindre leurs objectifs grâce à des solutions innovantes.

Après : Notre plateforme aide les entreprises de logistique à réduire les délais de livraison en routant les camions autour du trafic en temps réel.

Si vous n'avez pas le détail concret, demandez à l'utilisateur — ne l'inventez pas. Si l'invention est inévitable, préférez couper l'abstraction plutôt que de fabriquer des spécificités.


7. Mettre l'idée principale en tête

Problème : La phrase ou le paragraphe commence par une introduction (historique, qualifications, contexte) et enterre la conclusion à la fin.

Avant : Après avoir examiné les données des six derniers mois, pris en compte les commentaires de trois équipes différentes et pesé les compromis entre coût et délais, nous avons décidé d'annuler le projet.

Après : Nous annulons le projet. La décision fait suite à six mois de données, aux commentaires de trois équipes et à un examen coût-délais.


8. Supprimer les réserves qui n'ajoutent aucune information

Problème : Des phrases d'atermoiement qui retardent l'essentiel sans le qualifier.

Coupes courantes :

  • il convient de noter que → (supprimer)
  • il est utile de mentionner que → (supprimer)
  • il est important de considérer → (supprimer)
  • on pourrait avancer que → (supprimer, ou attribuer à quelqu'un de réel)
  • à bien des égards → (supprimer)
  • dans une certaine mesure → (supprimer sauf si quantifié)
  • sans doute → (supprimer sauf si suivi d'un contre-argument)

Conservez les réserves lorsqu'elles sont porteuses de sens : « environ 40% », « lors des premiers tests », « pour les utilisateurs mobiles ». Celles-ci qualifient l'affirmation. Les réserves qui n'adoucissent que le ton disparaissent généralement.

Avant : Il convient de noter qu'à bien des égards, la nouvelle politique est sans doute une amélioration.

Après : La nouvelle politique est une amélioration.

(Si l'auteur voulait vraiment dire que l'amélioration est contestée, la phrase suivante devrait dire ce qui est contesté et par qui — et non se cacher derrière « sans doute ».)


9. Définir ou supprimer les acronymes à la première utilisation

Problème : Les acronymes que le lecteur ne reconnaît pas rendent le texte opaque.

Règles :

  • Première utilisation : épeler le terme, puis mettre l'acronyme entre parenthèses — « revenu annuel récurrent (RAR) »
  • Si l'acronyme n'apparaît qu'une ou deux fois, abandonnez-le complètement et utilisez le terme complet
  • Si le public le connaît clairement (API dans un doc développeur, PIB dans un article d'économie), laissez-le tranquille

Avant : Le PM et le EM doivent s'aligner avec le DRI sur les OKR avant la FEQ.

Après : Le chef de produit et le responsable technique doivent se mettre d'accord avec le directeur responsable du projet sur les objectifs de ce trimestre avant la fin du trimestre.


10. Préciser les quantificateurs vagues

Problème : « Beaucoup », « divers », « plusieurs », « un certain nombre de », « quelques » ne disent rien au lecteur.

Avant : Un certain nombre de clients ont signalé divers problèmes avec plusieurs fonctionnalités au cours des dernières semaines.

Après : Douze clients ont signalé des bugs dans les fonctionnalités d'exportation, de recherche et de facturation au cours des trois dernières semaines.

Si vous n'avez pas les chiffres, laissez un espace réservé clair pour l'utilisateur au lieu d'inventer : « [N clients] ont signalé… ». N'inventez jamais un chiffre.


11. Remplacer les verbes abstraits par ce qui se passe réellement

Problème : Des verbes comme « faciliter », « permettre », « piloter », « soutenir », « interagir avec » décrivent une catégorie d'action sans nommer l'action.

Avant : Le nouvel outil permet aux équipes d'obtenir de meilleurs résultats et d'interagir plus efficacement avec les parties prenantes.

Après : Le nouvel outil permet aux équipes d'envoyer des mises à jour de progression aux clients en un clic.

Lorsque vous ne pouvez pas nommer l'action spécifique, demandez à l'utilisateur. Ne masquez pas le vide avec un autre verbe abstrait.


12. Casser les paragraphes denses

Problème : Un mur de texte où plusieurs idées, chacune méritant son propre paragraphe, sont entassées. L'œil du lecteur n'a aucun endroit où se reposer.

Règle empirique : Une idée par paragraphe. Lorsque l'idée change, commencez un nouveau paragraphe — même si le précédent ne fait que deux phrases. L'espace blanc est un outil de clarté.


Processus

Pour toute entrée :

  1. Lisez d'abord l'ensemble. Identifiez l'idée principale. Si l'idée principale n'est pas évidente, c'est la première chose à corriger.
  2. Réécrivez paragraphe par paragraphe, en appliquant les motifs ci-dessus. N'essayez pas de tout corriger en un seul passage — rendez-le d'abord lisible, puis affinez.
  3. Relisez à voix haute (en silence, dans votre tête). Si une phrase vous fait buter, elle fera buter le lecteur. Corrigez-la.
  4. Coupez. La plupart des réécritures sont encore trop longues. Cherchez toute phrase qui pourrait être supprimée sans perte d'information. Supprimez-la.
  5. Préservez les spécificités. Chiffres, noms, dates, termes techniques ayant un sens réel — conservez-les. La clarté n'est pas la même chose que le vague.
  6. Ne produisez que la réécriture. Pas de préface, pas de commentaire.

Exemple complet

Entrée :

À la lumière de l'examen stratégique récent qui a été mené par l'équipe de direction au cours du dernier trimestre, et en tenant compte des divers retours qui ont été reçus d'un certain nombre de parties prenantes différentes à travers l'organisation, il a été déterminé que, afin de mieux aligner nos ressources sur nos objectifs commerciaux globaux et de piloter une croissance durable à long terme, nous mettrons en œuvre un certain nombre de changements opérationnels dans les semaines à venir, qui incluront, entre autres, une restructuration de certaines équipes, une évolution de notre cadence de reporting et l'introduction de nouveaux outils conçus pour faciliter la collaboration interfonctionnelle et améliorer la productivité globale à grande échelle.

Sortie :

Le trimestre dernier, l'équipe de direction a mené un examen stratégique et recueilli les commentaires des équipes de toute l'entreprise. Sur cette base, nous apportons trois changements dans les prochaines semaines pour mieux aligner nos ressources sur nos objectifs.

Premièrement, nous restructurons certaines équipes. Deuxièmement, nous modifions la fréquence à laquelle les équipes rendent compte de leur progression. Troisièmement, nous déployons de nouveaux outils pour que les équipes puissent travailler ensemble plus facilement.

C'est tout. Pas de section « Modifications apportées : ». Pas de diff annoté. Juste la réécriture.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Jo5i4swastaken/Skills-Locker

Implements the "100% Retrieval Strategy" by Vercel. Injects a compressed docs index into AGENTS.md/CLAUDE.md to guarantee the agent always uses your global skills and best practices.

Jo5i4swastaken/Skills-Locker

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Jo5i4swastaken/Skills-Locker

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Jo5i4swastaken/Skills-Locker

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

Jo5i4swastaken/Skills-Locker

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Jo5i4swastaken/Skills-Locker

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

Jo5i4swastaken/Skills-Locker

Agent Media OS — resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record. One verb (`resolve`) handles the full cascade — project cache, global cache, HeyGen catalog search, freeze, register. Keeps search noise on disk, hands the agent a path. Use when a composition needs background music, sound effects, images, or icons.

Jo5i4swastaken/Skills-Locker

Author a HyperFrames slideshow composition — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching sequences, and hotspot navigation. Use as an intent check when the user asks for a presentation, pitch deck, slide deck, interactive deck, or page-to-deck conversion that might be a slideshow; if the user did not explicitly ask for a slideshow / slide show, confirm before authoring.

Jo5i4swastaken/Skills-Locker

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

Jo5i4swastaken/Skills-Locker

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).

Jo5i4swastaken/Skills-Locker

Watch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.

Skills associés