review

Descripción general del skill review

Qué hace review

review es un skill de self-improving-agent para auditar la memoria automática de Claude Code. Ayuda a un agente a inspeccionar MEMORY.md, encontrar candidatos para promoción, identificar entradas obsoletas o duplicadas y generar recomendaciones de mantenimiento, en lugar de dejar que la memoria del proyecto crezca sin control. Usa el skill review cuando quieras saber qué ha aprendido el agente, qué debería convertirse en guía duradera del proyecto y qué conviene depurar.

Cuándo encaja mejor este skill review

Este skill es especialmente útil para equipos que usan la memoria de Claude Code como parte de un flujo de Context Engineering. Encaja en proyectos donde las lecciones repetidas, las preferencias de herramientas, las decisiones arquitectónicas o los errores recurrentes se capturan automáticamente, pero necesitan una revisión editorial periódica. Es menos útil si tu proyecto no usa la memoria de Claude Code, no tiene un directorio de memoria de proyecto .claude o solo necesita un resumen puntual de un archivo fuente.

Qué lo diferencia de un prompt genérico

Un prompt genérico del tipo “resume mi memoria” suele pasar por alto comprobaciones operativas. El skill review le da al agente una ruta de auditoría concreta: localizar el directorio de memoria específico del proyecto, leer MEMORY.md, comprobar la presión del recuento de líneas frente al límite de arranque de 200 líneas, detectar recurrencias, verificar referencias obsoletas a archivos y separar candidatos para promoción de entradas de bajo valor. Esa estructura hace que el resultado sea más accionable para mantener contexto de agente en proyectos de larga duración.

Cómo usar el skill review

Instalación de review y primeros archivos que conviene inspeccionar

Instala el skill desde el repositorio de GitHub con:

npx skills add alirezarezvani/claude-skills --skill review

Después de instalarlo, lee primero SKILL.md. Esta ruta del repositorio contiene el flujo completo en un solo archivo, sin rules/, resources/, references/ ni scripts adicionales que revisar. Las secciones fuente más importantes son Usage, What It Does, Step 1: Locate memory directory y Step 2: Read and analyze MEMORY.md.

Comandos básicos para usar review

El skill upstream está diseñado alrededor de invocaciones de estilo /si:review:

• /si:review para una auditoría completa de la memoria
• /si:review --quick para recuentos y principales candidatos
• /si:review --stale para centrarse en entradas desactualizadas
• /si:review --candidates para mostrar solo promociones probables

En la práctica, llama al skill review desde la raíz del proyecto que quieras auditar. El skill espera tener acceso a la memoria de proyecto de Claude Code, normalmente en una ruta derivada del directorio de trabajo actual dentro de ~/.claude/projects/.../memory.

Entradas que mejoran el resultado de review

Un prompt débil sería: “Review memory.”

Un prompt más sólido sería:

“Run the review skill for this repository. Check the project auto-memory, count MEMORY.md lines against the startup limit, identify recurring lessons that should be promoted into durable instructions, flag stale entries that reference deleted files or old tools, and group recommendations by promote, consolidate, prune, and keep.”

Funciona mejor porque nombra los criterios de auditoría y los grupos de decisión. Si conoces cambios recientes del proyecto, inclúyelos: directorios renombrados, herramientas eliminadas, nuevos estándares de código o cambios de política. Esos detalles ayudan al agente a juzgar si una entrada de memoria está obsoleta o todavía aporta valor.

Flujo de trabajo recomendado para review

Empieza con /si:review --quick si el archivo de memoria es grande o si solo necesitas hacer una clasificación inicial. Ejecuta la revisión completa cuando estés preparando una renovación de contexto, incorporando una nueva configuración de agente o limpiando memoria acumulada antes de un ciclo importante de desarrollo. Usa --stale después de grandes refactors, cambios de dependencias o movimientos de archivos. Usa --candidates cuando tu objetivo sea Context Engineering: promover lecciones repetidas a CLAUDE.md, documentación del proyecto o reglas del equipo.

Preguntas frecuentes sobre el skill review

¿review es solo para la memoria de Claude Code?

Sí. El skill está diseñado específicamente en torno a las convenciones de memoria automática de Claude Code, especialmente la memoria de proyecto en ~/.claude/projects/.../memory y MEMORY.md. Puedes adaptar la guía de review a otros archivos de memoria, pero su mayor valor aparece cuando el agente puede seguir la estructura de memoria esperada de Claude Code.

¿Qué ocurre si no existe un directorio de memoria?

El skill debería informar que la memoria automática puede estar desactivada o no estar disponible, y luego sugerir revisar la configuración de memoria, por ejemplo usando /memory. Este es un punto útil antes de instalarlo: si tu equipo no ha habilitado ni acumulado memoria de Claude Code, review tendrá poco que analizar hasta que exista memoria.

¿Cuándo no debería usar review?

No uses review como sustituto de una revisión de código, una revisión de seguridad o una revisión de calidad de documentación. Audita la calidad de la memoria del agente, no la corrección del código fuente. Tampoco encaja bien en proyectos recién creados sin patrones recurrentes, en equipos que evitan deliberadamente la memoria persistente del agente o en casos donde solo necesitas un resumen simple de un único documento.

¿Cómo ayuda review en Context Engineering?

Para Context Engineering, review convierte la memoria en bruto en una cola de mantenimiento. Ayuda a decidir qué observaciones repetidas deberían pasar a ser contexto estable, qué entradas son duplicadas y qué notas desactualizadas deberían eliminarse antes de que confundan a futuros agentes. El resultado es más valioso cuando lo tratas como una pasada editorial sobre el contexto operativo de tu agente.

Cómo mejorar el skill review

Dale evidencia a review, no solo un comando

El skill review funciona mejor cuando el agente puede inspeccionar los archivos de memoria reales y el repositorio actual. Asegúrate de que pueda verificar las rutas referenciadas con comprobaciones del sistema de archivos, en lugar de depender solo del texto de la memoria. Si sospechas que una guía está obsoleta, explica por qué: “we migrated from Jest to Vitest,” “the api/legacy folder was removed,” o “the deployment process changed last week.”

Pide categorías listas para tomar decisiones

Solicita categorías que se correspondan con acciones concretas. Algunos buenos grupos son:

• Promote to durable project instruction
• Consolidate with similar entries
• Prune because stale or low-value
• Keep as temporary memory
• Investigate because evidence is unclear

Esto evita que el resultado de review se convierta en un resumen impreciso y facilita actualizar CLAUDE.md, la documentación del equipo o los archivos de memoria después de la auditoría.

Fallos comunes que conviene vigilar en review

El fallo más común es promover en exceso observaciones puntuales. Normalmente, un elemento de memoria solo debería promocionarse si es recurrente, se parece a una política o resulta ampliamente útil en sesiones futuras. Otro fallo es depurar entradas solo porque son antiguas; la antigüedad por sí sola no implica obsolescencia. Mejores señales de obsolescencia son archivos que ya no existen, herramientas reemplazadas, convenciones contradichas o referencias a trabajo temporal ya completado.

Itera después de la primera revisión

Después de la primera revisión, pide al agente que convierta las recomendaciones en un plan mínimo de cambios: qué añadir, fusionar, eliminar y volver a comprobar. Luego ejecuta review otra vez en modo rápido para verificar que la memoria es más breve, tiene menos duplicados y está mejor alineada con el comportamiento actual del proyecto. Así, review se convierte en un ciclo continuo de mantenimiento, no en un informe aislado.