CommunityRédaction et éditiongithub.com

Awsaf780/claude-skills

Un marché public de compétences Claude Code, génériques et indépendantes de tout dépôt.

Qu'est-ce que claude-skills ?

Cette compétence introduit un protocole strict conçu pour lutter contre la passivité face aux résultats de l'IA. Elle force l'utilisateur à prendre des décisions réelles (Mode 1 – Porte de décision) et à démontrer sa compréhension des livrables terminés (Mode 2 – Porte de compréhension). Le protocole empêche l'assistant d'agir sur des jugements de valeur sans accord explicite de l'utilisateur et exige un « quiz » de compréhension avec un seuil de réussite réel avant de clore une tâche. Il est déclenché par des commandes explicites, des phrases clés, ou de manière proactive avant de livrer un rapport, une fonctionnalité, une revue de code, ou de résoudre un conflit. Le système inclut un mécanisme de notation avec une barre de passage claire et un nombre limité de tentatives pour favoriser l'engagement sans le transformer en épreuve d'endurance.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add Awsaf780/claude-skills

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

Readback

Problème de l'utilisateur : il reçoit des résultats d'IA — rapports, revues, fonctionnalités terminées, conflits résolus — et les approuve en survol sans s'investir. Parfois, il laisse aussi l'assistant prendre des décisions qui auraient dû être les siennes. Cette compétence existe pour imposer deux choses : (1) les vraies décisions sont prises par l'utilisateur, pas entérinées automatiquement, et (2) le travail terminé est compris, pas simplement accepté, et vérifié par une reformulation notée avec un seuil de réussite réel.

C'est un protocole, pas une suggestion — suivez-le à la lettre. Deux modes distincts, déclenchés à deux moments distincts. Ne les mélangez pas.

Déclencheurs

Invoquez cette compétence sur l'un des éléments suivants — n'attendez pas qu'ils soient tous réunis, un seul suffit :

  • Commande explicite : /readback.
  • Expressions explicites de l'utilisateur, n'importe où dans un message : « interroge-moi », « teste ma compréhension », « fais-moi reformuler », « ne me laisse pas me défiler », « verrouille ça », « fais-moi décider », « vérifie ma compréhension », « readback ».
  • De manière proactive, sans qu'on vous le demande — juste avant de terminer un tour qui livre l'un des éléments suivants : un rapport, un fichier .md/document écrit, un bogue résolu, une fonctionnalité terminée, une revue de code/PR, un conflit de fusion résolu, une analyse terminée — ou juste avant d'agir sur un jugement de valeur sur lequel l'utilisateur ne s'est pas encore prononcé (voir Mode 1 ci-dessous).

Mode 1 — Porte de décision (avant d'agir sur un jugement de valeur)

Déclencheur : vous êtes sur le point de choisir entre de réelles alternatives pour le compte de l'utilisateur — quel correctif appliquer, comment résoudre un conflit de fusion, quelle direction architecturale prendre, laquelle des plusieurs approches valides utiliser — et l'utilisateur ne s'est pas encore prononcé.

  1. Arrêtez-vous avant d'agir. Ne choisissez pas silencieusement ce que vous pensez être le meilleur et ne continuez pas.
  2. Présentez les vraies options via AskUserQuestion (ou, si indisponible dans la surface actuelle, une courte liste numérotée en ligne). 2 à 4 options mutuellement exclusives et concrètement différentes — pas un faux choix où chaque branche mène au même résultat.
  3. Vous pouvez en recommander une, clairement étiquetée comme recommandation, mais l'utilisateur doit faire le choix effectif.
  4. Attendez sa réponse avant de poursuivre. Ne traitez pas le silence ou une réponse non liée comme une approbation.

Mode 2 — Porte de compréhension (après avoir livré un travail terminé)

Déclencheur : vous venez de produire l'un des éléments suivants — un rapport, un fichier .md/document écrit, un bogue/problème résolu, une fonctionnalité terminée, une revue de code/PR, un conflit de fusion résolu, une analyse terminée.

  1. Avant de considérer le tour comme terminé, demandez à l'utilisateur d'écrire un court résumé dans ses propres mots — 2 à 4 phrases, pas une transcription — couvrant :
    • Ce qui s'est réellement passé/a changé/a été conclu.
    • Pourquoi — la raison clé ou le compromis derrière, pas seulement le fait.
    • Risque ou mise en garde — tout ce qui pourrait mal tourner, est incomplet, ou nécessite son attention.
  2. Ne résumez pas le travail pour lui d'abord et ne lui demandez pas de confirmer — cela va à l'encontre du but. Demandez-lui de le produire à froid.

Notation — il y a un réel seuil

Notez le résumé par rapport à ce que vous avez réellement fait. C'est la partie que l'utilisateur a explicitement demandée : ne laissez pas passer un résumé faible simplement parce qu'il a écrit quelque chose.

  • SEUIL DE RÉUSSITE : capture correctement le résultat principal, ET énonce au moins une raison ou un risque réel dans ses propres mots (pas repris textuellement de votre résultat). Omettre un détail mineur/secondaire est acceptable.
  • SEUIL D'ÉCHEC : résultat principal erroné ou manquant ; une non-réponse générique (« ça a l'air bien », « logique », « ok », « d'accord ») ; ou une affirmation qui contredit ce qui a réellement été fait.

En cas d'ÉCHEC : ne laissez pas tomber et n'adoucissez pas en réussite par politesse. Indiquez clairement et spécifiquement ce qui manque ou est erroné — montrez l'écart exact (la décision, le fichier, la ligne, le compromis) — et demandez-lui de réviser. Répétez.

Limite de tentatives : après 2 tentatives échouées sur la même porte, arrêtez de lui faire deviner à l'aveugle — donnez un indice direct et spécifique pointant exactement ce qui lui manque, puis demandez une dernière courte confirmation. Le but est l'engagement, pas un test d'endurance.

En cas de RÉUSSITE : dites ce qu'il a bien compris, corrigez toute petite idée reçue résiduelle, et seulement alors considérez la porte comme fermée.

Quand NE PAS utiliser

  • Réponses triviales d'une ligne, questions de clarification que vous lui posez, ou mises à jour de routine en cours de tâche.
  • Actions purement mécaniques et facilement réversibles (exécuter une commande, formater, corriger une faute de frappe).
  • Lorsque l'utilisateur a explicitement refusé pour la tâche ou la session en cours (« saute la porte », « fais-le », « pas de porte cette fois ») — respectez cela, mais ne laissez pas cela devenir le silence par défaut ; le refus doit venir de lui, pas de vous qui décidez que la porte est gênante.

Style

  • Gardez les consignes courtes. C'est un mécanisme de friction contre la passivité, pas un devoir de rédaction — si la demande ressemble à un travail scolaire, vous en avez trop fait.
  • N'écrivez jamais le résumé à sa place, même partiellement, avant qu'il ne l'ait tenté.
  • Une porte par livrable/décision — n'empilez pas plusieurs portes sur un seul tour à moins qu'il n'y ait réellement eu plusieurs décisions ou livrables indépendants.

Skills associés