Explain

Verklaart een Rails-bestand of een hele gebruikersstroom, beginnend bij de git-geschiedenis

Door thoughtbot · thoughtbot/rails-consultant

Werkt met setup ★ 7.6/10

Explain — Verklaart een Rails-bestand of een hele gebruikersstroom, beginnend bij de git-geschiedenis

Wat het doet

Twee-modi code-uitlegger voor Rails-codebases: richt het op een bestand, klasse of methode voor een nauwkeurige lezing, of noem een gebruikersstroom zoals wachtwoordherstel of afrekenen voor een stroomdiagram met vakken plus toegangspunten, vertakkingslogica en neveneffecten. Het opent met de git log van het bestand, zodat commit-berichten het 'waarom' leveren dat de code niet kan. Handmatig aangeroepen als /explain - het stelt disable-model-invocation in, zodat het nooit afgaat vanuit een gewoon gesprek.

Testrapport

Richte het op Clearance's echte passwords_controller.rb, 115 regels met acht jaar geschiedenis. Het 'koud' uitleggen ervan dekt de mechanica correct, maar zegt niets over waarom de reset-mail deliver_now gebruikt of waarom de acties 202 en 303 retourneren in plaats van 200; de verplichte openingsstap van de skill, git log plus de laatste diff, bracht alle drie de antwoorden naar boven - PR 882 inlined delivery so integrators need no background worker and so send failures reach the user, and PR 965 changed the status codes because Turbo will not re-render a 200. Dat is het verschil tussen een beschrijving en een werkend mentaal model. Het addertje onder het gras is dat de frontmatter disable-model-invocation: true instelt, dus geen van de drie natuurlijke formuleringen die ik testte, zou het laden - u moet zelf /explain typen, en de README documenteert alleen de plugin- en npx-installatiepaden, niet de eenvoudige skills-directory kopie die ook werkt.

Getest op: 2026-07-30 · Claude Code 2.x (agent harness)

Installatie

git clone https://github.com/thoughtbot/rails-consultant.git
mkdir -p ~/.claude/skills
cd rails-consultant && cp -r skills/explain ~/.claude/skills/explain

Commando's en voorbeeldprompts

  • /explainVerklaart een Rails-bestand of een hele gebruikersstroom, beginnend bij de git-geschiedenis

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • /explain app/controllers/clearance/passwords_controller.rb, why deliver_now?
  • /explain the checkout flow, draw the entry points and side effects
  • /explain how password reset works in this app, starting from git history