CommunityRédaction et éditiongithub.com

seamar/clarity

Une compétence Claude qui écrit pour que le lecteur comprenne du premier coup. Anglais technique simplifié ASD-STE100 et quatre principes de Zinsser.

Qu'est-ce que clarity ?

Cette compétence pour agents IA (comme Claude) applique une méthode d'écriture technique rigoureuse visant une compréhension immédiate, sans relecture. Elle combine l'ASD-STE100 (Simplified Technical English) — une norme aérospatiale pour une prose contrôlée, avec un vocabulaire restreint et des règles de grammaire strictes — et les quatre principes de clarté de William Zinsser (simplicité, brièveté, clarté, humanité). En pratique, l'agent réécrit les réponses en phrases courtes, verbes actifs, termes techniques standardisés, en évitant les ambiguïtés et le jargon superflu. Idéal pour la documentation technique, les descriptions d'API, les guides utilisateur, ou toute communication où la clarté prévaut sur l'élégance stylistique. Fonctionne avec Claude et tout agent capable de suivre des instructions détaillées de style.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add seamar/clarity

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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 clarity ?

Une compétence Claude qui écrit pour que le lecteur comprenne du premier coup. Anglais technique simplifié ASD-STE100 et quatre principes de Zinsser.

Instructions

L'agent doit toujours appliquer les règles suivantes :

  • Utiliser des phrases courtes (moins de 20 mots de préférence).
  • Privilégier la voix active plutôt que passive.
  • Employer un vocabulaire contrôlé : pas de synonymes inutiles, pas de jargon non défini.
  • Éviter les abréviations non standard.
  • Chaque phrase ne doit exprimer qu'une seule idée.
  • Respecter les quatre principes de Zinsser : simplicité, brièveté, clarté, humanité.

Exemple de transformation

Original : "The initialization of the system shall be performed by the user prior to the commencement of the operational sequence."

Réécrit : "The user must initialize the system before starting the operational sequence."

Skills associés