# Caveman Review

> Comentarios de revisión de código ultra-comprimidos: recorta ruido del feedback de PR preservando la señal accionable. Cada comentario es una línea: ubicación, problema, fix.

Fuente: https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-review
Markdown: https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-review.md

Repositorio: https://github.com/JuliusBrussee/caveman
Autor: JuliusBrussee
Licencia: MIT
Actualizado: hace 4 meses
Coste de contexto: 78 tok instalada, 685 tok al activarse, 987 tok con todos los archivos del bundle
Bundle: 2 archivos, 4 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add JuliusBrussee/caveman --skill caveman-review --agent claude-code
# Cursor
npx -y skills add JuliusBrussee/caveman --skill caveman-review --agent cursor
# Codex
npx -y skills add JuliusBrussee/caveman --skill caveman-review --agent codex
# Gemini CLI
npx -y skills add JuliusBrussee/caveman --skill caveman-review --agent gemini
# Windsurf
npx -y skills add JuliusBrussee/caveman --skill caveman-review --agent windsurf
# Cline
npx -y skills add JuliusBrussee/caveman --skill caveman-review --agent cline
```

## Qué hace

- Genera comentarios de revisión de código tersos y accionables: una línea por hallazgo con ubicación, problema y fix concreto, formato `L<línea>: <problema>. <fix>.`
- Usa prefijos de severidad opcionales (🔴 bug, 🟡 risk, 🔵 nit, ❓ q) cuando hay hallazgos mixtos.
- Elimina frases de relleno ("I noticed that...", "you might want to consider...") y hedging; con duda real usa el prefijo `q:` en vez de suavizar.
- Para hallazgos de seguridad clase CVE, desacuerdos de arquitectura, u onboarding de autores nuevos, escribe un párrafo normal con contexto completo en vez de comprimir a una línea.

## Cuándo usarla

- El usuario dice "review this PR", "code review", "/review" o invoca /caveman-review.
- Al revisar pull requests (auto-trigger según el archivo).

## Qué la activa

- "/caveman-review"
- "revisa este PR"
- "dame comentarios de review para este diff"

## Antes de instalar

- Ninguno: solo revisa, el archivo dice explícitamente que no escribe el fix, no aprueba/rechaza el PR ni corre linters.

## Archivos

- README.md — 1 KB
- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde JuliusBrussee/caveman bajo MIT. Esta sección es el documento original y está en inglés.

Write code review comments terse and actionable. One line per finding. Location, problem, fix. No throat-clearing.

## Rules

**Format:** `L<line>: <problem>. <fix>.` — or `<file>:L<line>: ...` when reviewing multi-file diffs.

**Severity prefix (optional, when mixed):**
- `🔴 bug:` — broken behavior, will cause incident
- `🟡 risk:` — works but fragile (race, missing null check, swallowed error)
- `🔵 nit:` — style, naming, micro-optim. Author can ignore
- `❓ q:` — genuine question, not a suggestion

**Drop:**
- "I noticed that...", "It seems like...", "You might want to consider..."
- "This is just a suggestion but..." — use `nit:` instead
- "Great work!", "Looks good overall but..." — say it once at the top, not per comment
- Restating what the line does — the reviewer can read the diff
- Hedging ("perhaps", "maybe", "I think") — if unsure use `q:`

**Keep:**
- Exact line numbers
- Exact symbol/function/variable names in backticks
- Concrete fix, not "consider refactoring this"
- The *why* if the fix isn't obvious from the problem statement

## Examples

❌ "I noticed that on line 42 you're not checking if the user object is null before accessing the email property. This could potentially cause a crash if the user is not found in the database. You might want to add a null check here."

✅ `L42: 🔴 bug: user can be null after .find(). Add guard before .email.`

❌ "It looks like this function is doing a lot of things and might benefit from being broken up into smaller functions for readability."

✅ `L88-140: 🔵 nit: 50-line fn does 4 things. Extract validate/normalize/persist.`

❌ "Have you considered what happens if the API returns a 429? I think we should probably handle that case."

✅ `L23: 🟡 risk: no retry on 429. Wrap in withBackoff(3).`

## Auto-Clarity

Drop terse mode for: security findings (CVE-class bugs need full explanation + reference), architectural disagreements (need rationale, not just a one-liner), and onboarding contexts where the author is new and needs the "why". In those cases write a normal paragraph, then resume terse for the rest.

## Boundaries

Reviews only — does not write the code fix, does not approve/request-changes, does not run linters. Output the comment(s) ready to paste into the PR. "stop caveman-review" or "normal mode": revert to verbose review style.

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [JuliusBrussee](https://skillsagentes.com/creators/juliusbrussee.md) — 7 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Caveman](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman.md): Modo de comunicación ultra-comprimido: corta ~65% de los tokens de salida (medido) manteniendo toda la precisión técnica. Soporta niveles lite, full (por defecto), ultra y variantes wenyan.
- [Caveman Compress](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-compress.md): Comprime archivos de lenguaje natural (CLAUDE.md, todos, preferencias) a formato caveman para ahorrar tokens de entrada. Preserva todo el contenido técnico, código, URLs y estructura.
- [Caveman Help](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-help.md): Tarjeta de referencia rápida con todos los modos, skills y comandos de caveman. Despliegue de una sola vez, no es un modo persistente.
- [Caveman Stats](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-stats.md): Muestra el uso real de tokens y el ahorro estimado de la sesión actual, leído directamente del log de sesión de Claude Code, sin estimación del modelo.
- [Cavecrew](https://skillsagentes.com/skills/juliusbrussee/caveman/cavecrew.md): Guía de decisión para delegar a subagentes estilo caveman: cuándo lanzar cavecrew-investigator, cavecrew-builder o cavecrew-reviewer en vez de hacerlo inline. Su salida viene comprimida, así el contexto principal dura más.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)