technical-clarity
Améliorer la clarté de la rédaction technique
Le contenu technique peut sembler clair aux experts tout en déroutant les apprenants. Cette compétence examine les brouillons en fonction de l’adéquation au public, du jargon, du contexte manquant, de l’accessibilité et des étapes pratiques de révision.
Télécharger le ZIP de la compétence
Importer dans Claude
Accédez à Paramètres → Capacités → Skills → Importer une compétence
Activez et commencez à utiliser
Ressources lisibles par les agents
Utilisez ces liens lorsqu’un Agent IA, un crawler ou un script a besoin d’un contexte propre au lieu de lire toute la page.
Tester
Utilisation de « technical-clarity ». Un paragraphe qui dit qu’un concept est évident et utilise plusieurs termes non définis.
Résultat attendu:
- Signale le langage excluant qui peut donner aux apprenants le sentiment d’être mis à l’écart.
- Liste les termes non définis et recommande des définitions à la première occurrence.
- Suggère une introduction plus claire qui explique pourquoi le concept est important.
Utilisation de « technical-clarity ». Une section de tutoriel qui commence par une théorie abstraite avant de montrer un exemple.
Résultat attendu:
- Identifie la structure commençant par l’abstraction comme un risque pour la compréhension.
- Recommande de placer un exemple concret avant l’explication.
- Ajoute des notes de prérequis et de motivation pour l’apprenant cible.
Utilisation de « technical-clarity ». Une documentation qui s’appuie sur la couleur et des captures d’écran pour expliquer les erreurs.
Résultat attendu:
- Signale la communication uniquement visuelle comme un problème d’accessibilité.
- Recommande des libellés textuels, des légendes et du texte alternatif.
- Suggère une formulation adaptée aux utilisateurs de lecteurs d’écran.
Audit de sécurité
SûrStatic analysis reported shell execution, weak cryptography, and system reconnaissance patterns. Review found these are false positives from Markdown fences, inline code formatting, HTTPS examples, accessibility prose, and readability metrics in SKILL.md. No executable scripts, network calls, credential access, prompt injection attempts, or malicious intent were found.
Confirmed security concerns (3)
Score de qualité
Ce que vous pouvez créer
Revoir un tutoriel pour débutants
Vérifier si un tutoriel explique les prérequis, définit les termes et évite les suppositions d’expert.
Préparer une documentation d’API
Améliorer le texte de référence afin que les lecteurs comprennent l’objectif, les contraintes, les exemples et les cas d’erreur.
Auditer du matériel de cours
Évaluer les leçons en fonction du niveau de lecture, de la densité du jargon, de l’accessibilité et de la confiance des apprenants.
Essayez ces prompts
Examine cette explication technique pour en évaluer la clarté. Identifie les formulations confuses, les termes non définis et le contexte manquant. Public cible : débutant. Brouillon : [paste text].
Audite ce contenu pour un apprenant intermédiaire B1. Vérifie la longueur des phrases, la densité du jargon, les prérequis, les exemples et l’accessibilité. Fournis des corrections priorisées. Contenu : [paste text].
Examine ce tutoriel et crée un plan de révision. Concentre-toi sur une structure qui montre avant d’expliquer, les définitions, la motivation, les cas d’erreur et la confiance de l’apprenant. Tutoriel : [paste text].
Réalise un audit complet de clarté technique pour cette documentation. Inclus les hypothèses sur le public, les risques de lisibilité, les problèmes d’accessibilité, la gravité des problèmes, leur impact et des exemples réécrits lorsque c’est utile. Documentation : [paste text].
Bonnes pratiques
- Fournir le public cible, le contexte d’apprentissage et les connaissances prérequises attendues.
- Demander la gravité des problèmes, l’impact sur les apprenants et des suggestions concrètes de réécriture.
- Revoir à nouveau le texte révisé après avoir appliqué d’importantes modifications de clarté.
Éviter
- Ne demandez pas une relecture générique lorsque vous avez besoin d’une analyse de compréhension par les apprenants.
- N’omettez pas le niveau de compétence cible ni le profil attendu des lecteurs.
- N’acceptez pas les scores de lisibilité sans vérifier les exemples, le contexte et l’accessibilité.