Explain

Explica un archivo de Rails o un flujo de usuario completo, comenzando desde el historial de git

Por thoughtbot · thoughtbot/rails-consultant

Funciona con configuración ★ 7.6/10

Explain — Explica un archivo de Rails o un flujo de usuario completo, comenzando desde el historial de git

Qué hace

Explicador de código de dos modos para bases de código Rails: apúntelo a un archivo, clase o método para una lectura detallada, o nombre un flujo de usuario como restablecimiento de contraseña o checkout para un diagrama de flujo de dibujo de cajas más puntos de entrada, lógica de ramificación y efectos secundarios. Se abre con el git log del archivo para que los mensajes de commit proporcionen el 'por qué' que el código no puede. Se invoca manualmente como /explain - establece disable-model-invocation, por lo que nunca se activa desde una conversación normal.

Informe de la prueba

Se apuntó al Clearance's real passwords_controller.rb, 115 lines con eight years of history. Explaining it cold covers the mechanics correctly but has nothing to say about why the reset mail uses deliver_now or why the actions return 202 and 303 instead of 200; la skill's mandatory opening step, git log plus the last diff, surfaced all three answers - 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. That is the difference between a description and a working mental model. El catch es que el frontmatter sets disable-model-invocation: true, so none of the three natural phrasings I tested would load it - you have to type /explain yourself, and the README only documents the plugin and npx install paths, not the plain skills-directory copy that also works.

Probado el: 2026-07-30 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /explainExplica un archivo de Rails o un flujo de usuario completo, comenzando desde el historial de git

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • /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