Przejdź do treści
Biblioteka skilli
Programowanie · Nauka i wyjaśnianie

explain-the-diff

/explain-the-diff

Wyjaśnia kod, który agent właśnie napisał lub zmienił: dlaczego taki projekt, co odrzucono, co może zawieść na produkcji, i zadaje jedno pytanie predykcyjne.

Repozytorium
senior-mentor ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wyjaśnia kod, który agent właśnie napisał lub zmienił: dlaczego taki projekt, co odrzucono, co może zawieść na produkcji, i zadaje jedno pytanie predykcyjne.

Wyzwalacze z opisu

I donexplain this change/codewhy did you do it that waywalk me through this diff
Oryginalny opis (EN)

Explain code the agent just wrote or changed — why this design, what was rejected, what fails in production, the fundamental underneath — then one prediction question. Use when the user says "I don't understand what you just did", "explain this change/code", "why did you do it that way", "walk me through this diff", or runs /mentor explain or /mentor shadow on|off.

Jak działa

  1. What to explain
  2. Shape (normal)
  3. Shadow mode (/mentor shadow on|off)
  4. Sprint
  5. Level lens
Sekcje z nagłówków SKILL.md, w oryginale · 43 linii, 470 słów
Podgląd SKILL.md
---
name: explain-the-diff
description: Explain code the agent just wrote or changed — why this design, what was rejected, what fails in production, the fundamental underneath — then one prediction question. Use when the user says "I don't understand what you just did", "explain this change/code", "why did you do it that way", "walk me through this diff", or runs /mentor explain or /mentor shadow on|off.
---

# Explain the diff: never let generated code go un-understood

Method: [../../library/pedagogy.md](../../library/pedagogy.md) · production lens: [../../library/production-lens.md](../../library/production-lens.md) · state: [../../library/formats.md](../../library/formats.md)

The anti-dependency skill. Agent-written code the user can't explain is a liability they now own.

## What to explain

The last substantial change: `git diff`, or the edits made in this session. The user can instead point at specific files or lines. Read the topic's progress file for the user's level and depth. If there isn't one, pitch at L3 and D2, and offer placement at the end.

## Shape (normal)

1. **What changed, in 3 sentences.** The behaviour, not a file list. Name the problem it solves the way the industry does ([pedagogy.md § Name the problem](../../library/pedagogy.md#name-the-problem)), in one line.
2. **The map.** A small diagram when the change spans components or has an order of operations ([diagrams.md](../../library/diagrams.md)).
3. **The load-bearing lines.** Walk the 2–5 lines that matter most. For each one:
   - what it does;
   - why it's this way;
   - the obvious alternative, and why it lost.
4. **Decisions made silently.** Every choice the agent made without asking: a library, a data shape, sync vs async, an error strategy, a default value. For each one: what it trades away, and whether it's a one-way door. **This is the core of the skill.** Buried decisions are what LLM output hides.
5. **Production lens, at their level.** What breaks under concurrency, load or failure, with a severity (ship-blocker / fix soon / worth knowing). Be honest about your own code's weaknesses.
6. **The fundamental** it rests on, in one line.
7. **Question window, then one prediction question** ([pedagogy.md](../../library/pedagogy.md#question-window-before-any-check)) via AskUserQuestion, e.g. "if two requests hit this at once, what happens?". A wrong answer → name the misconception in two sentences and mark it `shaky`. It's a teaching moment, not a gate.
8. Log the concepts touched into the graph (`src: shadow (<context>)`).

## Shadow mode (`/mentor shadow on|off`)

When shadow is on for a topic (the progress file's `shadow_cadence` is not `quiet`), during normal work:

- Before applying a **substantial** change, show the map ([pedagogy.md § Map before code](../../library/pedagogy.md#map-before-code)): what you're about to do, how the pieces connect, and why, at their level. Then ask one prediction question. Trivial edits (renames, imports, formatting) pass silently.
- Checks land only at natural checkpoints: before a commit, after a feature works, at a design decision. Never mid-flow.
- "Quiz me less" / "more" adjusts `shadow_cadence` permanently.

## Sprint

2–3 sentences on what changed and why, the one trap, and no question. Add `explain <change>` to `## Learn later`.

## Level lens

- **L1–L2:** trace execution line by line for the load-bearing part, and define every term.
- **L3–L4:** focus on step 4 (silent decisions) and step 5 (production lens).
- **L5+:** the system impact: coupling introduced, ownership, what this makes harder later.

Wersje

W bazie nie ma innych skilli o nazwie explain-the-diff.

Migawka bazy z 13.11.2026 · wersja paczki dffe57de9123 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90rpi-explain
    Przechodzi przez ostatnią zmianę w diffie i wyjaśnia, co się zmieniło i dlaczego, z naciskiem na nieoczywiste decyzje.
  • 90rpi-explain
    Przechodzi przez ostatnią zmianę w diffie i wyjaśnia, co się zmieniło i dlaczego, z naciskiem na nieoczywiste decyzje.
  • 100teach-me
    Tłumaczy kod, który asystent AI właśnie napisał, prostym językiem, z jednym pojęciem do nauki i pytaniem sprawdzającym.
  • 100explain
    Wyjaśnia kod, pojęcie, zmianę lub działanie agenta warstwami, zaczynając od jednego prostego zdania i małego diagramu.
  • 95memstack-development-mentor
    Wyjaśnia na bieżąco decyzje i kompromisy podczas budowania, prostym językiem dla osoby uczącej się.
  • 90explain-pr
    Wyjaśnia użytkownikowi, co zmieniono na jego gałęzi, i wskazuje zmiany, których nie da się uzasadnić, zanim kod zostanie wysłany.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.