mcpField
E
explain-your-changes

explain-your-changes

github.com/aymericderboisDevelopment45 installs
Repository

About explain-your-changes

explain-your-changes is a skill for coding agents that presents each changed file’s diff and explains the change, adding rationale only when needed. It can use report-render to format the explanation as an HTML report when requested.

Key features

  1. 01Show each modified file’s diff
  2. 02Explain changes with necessary rationale
  3. 03Cover every changed file
  4. 04Format explanations as HTML on request

Use cases

  1. 01Review a coding agent’s session changes
  2. 02Explain non-obvious implementation decisions
  3. 03Prepare an HTML change report

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aymericderbois/skills --skill explain-your-changes

After installing, type/explain-your-changesin Claude Code to confirm it loaded.

Details

From the project README

Pour chaque fichier modifié dans la session, montre le diff puis explique le changement, et si nécessaire pourquoi. N'ajoute le pourquoi que lorsqu'il ne se déduit pas du diff — pas de justification pour un import ou un renommage évident.

Couvre tous les fichiers modifiés : aucun changement ne reste sans explication.

**`blog/constants.py:5`** ```diff +WORDS_PER_MINUTE = 200 ```

Vitesse de lecture moyenne servant à estimer le temps de lecture. Évite la valeur magique dans le calcul.

blog/models.py:24

+    def reading_time(self) -> int:
+        return max(1, round(len(self.body.split()) / WORDS_PER_MINUTE))

Nouvelle méthode sur le modèle. Estime le temps de lecture en minutes à partir du nombre de mots, avec un plancher à 1 minute pour les articles très courts.

templates/blog/detail.html:8

 <link rel="stylesheet" href="/static/css/article.css">
+<link rel="stylesheet" href="/static/css/meta.css">

Charge la feuille de style de la ligne de métadonnées (auteur, date, temps de lecture).

templates/blog/detail.html:21

-    <div class="meta">{{ post.published_at|date:"d/m/Y" }}</div>
+    <div class="meta">
+      {{ post.published_at|date:"d/m/Y" }} · {{ post.reading_time }} min de lecture
+    </div>

Ajoute le temps de lecture à côté de la date de publication. La valeur vient de la méthode reading_time du modèle.

Si l'utilisateur demande un rapport HTML des changements (« fais-moi un rapport HTML »), le skill report-render met en forme cette explication (diffs + commentaires) dans .reports/<slug>.report.html.

Comments

Markdown supported