agentkitco/agentkit-dev-skills

Construye un mapa de incorporación de un repositorio desconocido que cubra su propósito, puntos de entrada, cómo ejecutarlo, módulos principales, flujo de datos y áreas riesgosas, con referencias a archivos. Úsalo cuando te pidan explicar, mapear o incorporarte a una base de código.

¿Qué es agentkit-dev-skills?

Esta skill permite a un agente de IA generar un mapa detallado y confiable de un repositorio de código desconocido, dirigido a desarrolladores que se incorporan a un proyecto. Su utilidad principal es proporcionar una visión estructurada que incluye el propósito del proyecto, cómo ejecutarlo, la estructura del árbol, puntos de entrada, flujos de datos, esquemas, servicios externos y señales de calidad. La skill guía al agente a explorar el repositorio en un orden específico: desde leer el README y archivos de configuración, ejecutar pruebas y lint, hasta trazar un flujo real de extremo a extremo. Finalmente, produce un resumen en un formato de mapa de una página, citando siempre las líneas de código relevantes y evitando información no verificada o secretos. Está diseñada para agentes como Claude Code, Cursor o Codex, y su efectividad radica en la verificación de cada afirmación con archivos leídos, sin adivinar contexto de negocio.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/agentkitco/agentkit-dev-skills/tree/HEAD/skills/explain-codebase

Documentación

Explicar una base de código desconocida

Objetivo: proporcionar a un recién llegado un mapa confiable, con referencias a archivos, en unas pocas páginas. Cada afirmación debe apuntar a un archivo que hayas leído.

Explorar en este orden

Propósito y usuarios: README, descripción del paquete, índice de documentación. ¿Qué problema resuelve y para quién?
Ejecutarlo: comandos de instalación, ejecución y prueba desde manifiestos, Makefile y configuración de CI. Ejecuta los baratos (pruebas, lint) para confirmar que funcionan; indica cuáles no ejecutaste.
Estructura: árbol de directorios hasta dos niveles de profundidad (ignora node_modules, salida de compilación, .git). Anota el/los lenguaje(s), frameworks, diseño de monorepo.
Puntos de entrada: main, archivo de inicio del servidor, entrada CLI, definiciones de rutas, trabajos programados, manejadores de eventos, entradas bin y scripts.
Trazar un flujo real de extremo a extremo: elige la solicitud, comando o evento más central y síguelo desde la entrada hasta el almacenamiento o salida, listando cada archivo y función en orden.
Datos: esquemas, modelos, migraciones, archivos de configuración, variables de entorno que el código lee (solo nombres, nunca valores).
Puntos de contacto externos: bases de datos, colas, APIs de terceros, proveedores de autenticación.
Señales de calidad: dónde viven las pruebas y qué cubren, comprobaciones de CI, reglas de lint, áreas con TODOs, archivos muy grandes, cambios recientes (git log --since="3 months ago" --name-only --pretty=format: | sort | uniq -c | sort -rn | head).

Salida

# <repo> en una página
Propósito: ...
Cómo ejecutar: <comandos, verificados o no>
Mapa: <directorio -> responsabilidad, una línea cada uno>
Un flujo, paso a paso: <archivo:función ...>
Datos y configuración: ...
Servicios externos: ...
Por dónde empezar a leer: <3 archivos en orden, con motivo>
Áreas riesgosas o confusas: <archivo, motivo>
Preguntas abiertas: <lo que no pudiste determinar>

Reglas

Cita ruta:línea o al menos ruta para cada afirmación. Si inferiste algo, márcalo como "inferido".
No describas código que no hayas abierto. No adivines el contexto de negocio; colócalo en preguntas abiertas.
Nunca imprimas valores secretos de archivos .env o configuración; solo lista nombres de variables.
Sé breve: un mapa, no un recorrido por cada archivo.