Skill explaining-codebases
✓ VerificadoGenera explicaciones interactivas de bases de código, incluyendo mapas de arquitectura, diagramas de flujo de datos y recorridos de código anotados.
- Estrellas en GitHub
- 22
- Archivos
- 4
- Último commit
- 26 oct 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill explaining-codebases?
Genera explicaciones interactivas de bases de código, incluyendo mapas de arquitectura, diagramas de flujo de datos y recorridos de código anotados.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill explaining-codebases
Los desarrolladores que necesiten integrar a nuevos colaboradores o entender repositorios complejos pueden usar esta SKILL para generar documentación interactiva. Transforma archivos fuente, servicios o repositorios reales en explicaciones interactivas autónomas que incluyen mapas de arquitectura, diagramas de flujo de datos y recorridos de código anotados. Un agente debe cargar esta SKILL cuando un usuario pida visualizar una arquitectura o entender cómo funciona un mecanismo específico dentro de una base de código.
El proceso se basa en navegar por código real para identificar puntos de entrada, estructuras de módulos y el concepto de columna vertebral de una funcionalidad. Produce resultados de alta fidelidad, como rastreadores de trazas de ejecución y diagramas de secuencia que muestran cómo se mueven los elementos a través de diferentes etapas. Para garantizar la precisión, la SKILL requiere ejecutar fact-checking-explainers para verificar que cada fragmento citado y cada afirmación funcional coincidan con la implementación en una ruta y línea específicas. Trabaja en conjunto con creating-explainers para gestionar las plantillas HTML finales, la prosa y el pulido del contenido.
Lo que un agente puede hacer con ella
- 1Onboarding de nuevos miembros del equipoCrea una visión general de la arquitectura que muestre cómo encajan los módulos y las abstracciones clave en un nuevo proyecto.
- 2Análisis profundo de algoritmos específicosGenera un rastreador de trazas de ejecución para recorrer un único algoritmo con estados y líneas resaltadas.
- 3Visualización del movimiento de datosProduce un diagrama de secuencia para ilustrar cómo una solicitud o mensaje se desplaza a través de las diversas etapas de un sistema.
- 4Verificación de la precisión de la documentación del códigoAsegura que todos los fragmentos de código y las afirmaciones funcionales en una explicación coincidan con la implementación actual.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill explaining-codebases
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill explaining-codebases en Plugin
/plugin marketplace add analyticalmonk/explain-this /plugin install explain-this@explain-this
Instalar la skill explaining-codebases en Claude Code
~/.claude/skills/explaining-codebases/SKILL.md
$ npx degit analyticalmonk/explain-this/skills/explaining-codebases ~/.claude/skills/explaining-codebasesInstalar la skill explaining-codebases en Claude Code (project)
.claude/skills/explaining-codebases/SKILL.md
$ npx degit analyticalmonk/explain-this/skills/explaining-codebases .claude/skills/explaining-codebasesInstalar la skill explaining-codebases en Codex
~/.agents/skills/explaining-codebases/SKILL.md
$ npx degit analyticalmonk/explain-this/skills/explaining-codebases ~/.agents/skills/explaining-codebasesInstalar la skill explaining-codebases en Gemini CLI
~/.gemini/skills/explaining-codebases/SKILL.md
$ npx degit analyticalmonk/explain-this/skills/explaining-codebases ~/.gemini/skills/explaining-codebasesInstalar la skill explaining-codebases en Claude.ai
npx degit analyticalmonk/explain-this/skills/explaining-codebases explaining-codebases && zip -r explaining-codebases.zip explaining-codebases # claude.ai → Customize → Skills → + → Create skill → Upload a skill → explaining-codebases.zip
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Superó nuestras comprobaciones automáticas. No es una auditoría de seguridad: lee los scripts antes de dejar que un agente los ejecute. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleanalyticalmonk/explain-this/skills/explaining-codebases is public and reachablegithub.com/analyticalmonk/explain-this/tree/HEAD/skills/expl ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit 2026-10-26github.com/analyticalmonk/explain-this/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/analyticalmonk/explain-this/blob/HEAD/skills/expl ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/analyticalmonk/explain-this/blob/HEAD/skills/expl ↗Aprobado
- SKILL.md sigue el formato de Agent SkillsValid name and description; says when to use it; 69 linesgithub.com/analyticalmonk/explain-this/blob/HEAD/skills/expl ↗Aprobado
SKILL.md
Ver en GitHubExplaining Codebases
Overview
This skill explains code as it actually exists - a repository, a service, or a set of source files. The output is the same distill-style, single self-contained interactive explainer that creating-explainers produces. What differs is the intake (navigating real code instead of reading a paper) and the figure types (architecture diagrams, data-flow, execution traces, annotated code walkthroughs). It handles both onboarding overviews of a whole codebase and deep-dives on one mechanism.
Required Background
REQUIRED: Use creating-explainers for everything about the output - the HTML template, voice and style, base figure archetypes, color palettes, the outline/scaffold/prose/polish workflow, and the quality checklist. This skill only adds what is specific to code. Do not duplicate that material here.
When to Use
Use when the subject is code:
- Architecture / onboarding overview - how a project is structured: its modules, how data flows between them, the key abstractions, how the pieces fit. For a new contributor who needs the map.
- Single-mechanism deep-dive - how one algorithm, feature, or subsystem works, traced through the real implementation.
The skill picks the angle from the request and confirms it with the user during intake (overview and deep-dive want different figures and different depth).
When NOT to use: a paper, a topic, or any non-code source. Use creating-explainers instead.
Code Intake
See references/code-intake.md. In short: pick the angle, navigate the repository to find entry points and module structure, identify the spine concept (the one path or idea the article tracks), map the architecture, and pull real code snippets anchored to path:line. Quote actual code; never paraphrase code as if quoting it.
Code-Specific Figures
See references/code-figure-archetypes.md for the patterns:
- Architecture / module diagram - modules as boxes, dependencies as arrows
- Data-flow / sequence diagram - an item (request, message, token) moving through stages
- Execution-trace stepper - step through an algorithm with state and the current line highlighted
- Annotated code walkthrough - a code block whose lines reveal annotations as you step or hover
The mechanics (DPR-aware initCanvas, the IIFE pattern, animation loops) come from the base figure-archetypes.md in creating-explainers. The code-figure reference only covers how to apply them to code.
The Fact-Check Gate for Code
REQUIRED before delivery: run fact-checking-explainers. For a codebase explainer the source of truth is the code itself. Every claim about what the code does, and every quoted snippet, is checked against the actual implementation at a specific path and line. Code drifts; a snippet that was accurate yesterday may be wrong today. The interactive explainer is not done until it passes.
Workflow
Same staged workflow as creating-explainers, with code intake in place of the text intakes:
1. Code intake -> navigate, pick angle, find the spine, map architecture, pull real snippets
2. Outline -> propose sections + figure list, get user approval
3. Scaffold -> copy the article template, fill metadata
4. Prose pass -> write all sections with figure placeholders
5. Figures pass -> implement each interactive figure
6. Post-draft fact-check -> verify every claim and snippet against the real code (REQUIRED, blocking)
7. Polish -> run the creating-explainers Quality Checklist to completion
Pause for user approval after the outline. Everything about scaffolding, prose, figures, polish, and the delivery checklist follows creating-explainers.
Common Mistakes
| Mistake | Fix |
|---|---|
| Explaining code that does not exist, or that you imagined | Open the files. Every claim traces to real code at a real path. |
| Snippets drift from the real source | Quote exactly, with path:line. Never tidy code into something the repo does not contain. |
| Architecture diagram does not match the real module structure | Build the diagram from the actual imports and call sites, not a guess. |
| Scope too broad (a whole framework in one article) | Pick one subsystem or one mechanism. Breadth dilutes; depth teaches. |
| Pasting a huge file as a "figure" | Figures illustrate a point the prose just set up. Trim to the lines that matter. |
Archivos de esta skill
4Preguntas sobre la skill explaining-codebases
¿Cómo instalo la skill explaining-codebases en Claude Code?
Ejecuta npx degit analyticalmonk/explain-this/skills/explaining-codebases ~/.claude/skills/explaining-codebases. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill explaining-codebases?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Cómo garantiza esta SKILL que las explicaciones del código sean precisas?
La SKILL requiere un paso obligatorio de verificación de hechos donde cada afirmación y fragmento de código se valida contra la implementación real en una ruta y línea específicas.
¿Cuándo no debería usar esta SKILL?
No uses esta SKILL para artículos, temas generales o cualquier fuente que no sea código; utiliza la SKILL creating-explainers en su lugar.