Communitygithub.com

Lev-it/lev-skills

Revisa los cambios desde un punto fijo (commit, rama, etiqueta o merge-base) en dos ejes: Estándares (¿el código sigue los estándares de codificación documentados?) y Especificación (¿el código coincide con lo solicitado en el issue o PRD original?). Ejecuta ambas revisiones en subagentes paralelos y las presenta una al lado de la otra. Úsalo cuando quieras revisar una rama, un PR, cambios en progreso, o pidas 'revisar desde X'.

¿Qué es lev-skills?

Esta habilidad permite revisar el código modificado en un Pull Request o rama desde dos perspectivas independientes y paralelas: cumplimiento de estándares de codificación y fidelidad a la especificación original. El usuario proporciona un punto fijo (commit, rama, etiqueta, etc.) y la habilidad calcula el diff con `git diff <punto-fijo>...HEAD`, verifica que sea válido y no vacío, y luego lanza dos subagentes paralelos para analizarlo. El primer subagente revisa si el código viola estándares documentados (por ejemplo, `CODING_STANDARDS.md` o `CONTRIBUTING.md`), citando la regla exacta. El segundo subagente compara el código contra la especificación fuente (obtenida de issues, PRDs, o archivos en `docs/`, `specs/`, etc.) e identifica funcionalidad faltante, incorrecta o no solicitada (scope creep). Los resultados se presentan separados en dos secciones, evitando que un eje opaque al otro. Es compatible con cualquier repositorio Git y funciona en agentes como Claude Code, Cursor, Codex, o cualquier herramienta que soporte la ejecución de subagentes con herramientas de shell y lectura de archivos. Al separar las revisiones, se asegura que cambios que cumplen estándares pero implementan lo incorrecto, o que implementan lo correcto pero rompen convenciones, sean detectados sin sesgos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/review

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Revisión en dos ejes del diff entre HEAD y un punto figo proporcionado por el usuario:

  • Estándares — ¿el código cumple con los estándares de codificación documentados en este repositorio?
  • Especificación — ¿el código implementa fielmente el issue / PRD / especificación original?

Ambos ejes se ejecutan como subagentes paralelos para no contaminar el contexto del otro, luego esta habilidad agrega sus hallazgos.

El rastreador de issues debería haberte sido proporcionado — ejecuta /setup-matt-pocock-skills si falta docs/agents/issue-tracker.md.

Proceso

1. Fijar el punto de referencia

Cualquier punto que el usuario haya indicado como referencia — un SHA de commit, nombre de rama, etiqueta, main, HEAD~5, etc. Si no especificó uno, pídelo.

Captura el comando diff una vez: git diff <punto-de-referencia>...HEAD (tres puntos, para que la comparación sea contra la merge-base). También anota la lista de commits mediante git log <punto-de-referencia>..HEAD --oneline.

Antes de continuar, confirma que el punto de referencia se resuelve (git rev-parse <punto-de-referencia>) y que el diff no está vacío. Una referencia incorrecta o un diff vacío deben fallar aquí, no dentro de los dos subagentes paralelos.

2. Identificar la fuente de la especificación

Busca la especificación original, en este orden:

  1. Referencias a issues en los mensajes de commit (#123, Closes #45, GitLab !67, etc.) — obténlos mediante el flujo de trabajo en docs/agents/issue-tracker.md.
  2. Una ruta que el usuario haya pasado como argumento.
  3. Un archivo PRD/especificación bajo docs/, specs/, o .scratch/ que coincida con el nombre de la rama o funcionalidad.
  4. Si no se encuentra nada, pregunta al usuario dónde está la especificación. Si dice que no hay, el subagente de Especificación se omitirá e informará "no hay especificación disponible".

3. Identificar las fuentes de estándares

Todo lo que haya en el repositorio que documente cómo debe escribirse el código, como CODING_STANDARDS.md o CONTRIBUTING.md.

4. Lanzar ambos subagentes en paralelo

Envía un único mensaje con dos llamadas a la herramienta Agent. Usa el subagente general-purpose para ambos.

Indicación para el subagente de Estándares — incluye:

  • El comando diff completo y la lista de commits.
  • La lista de archivos fuente de estándares que encontraste en el paso 3.
  • La consigna: "Informe — por archivo/hunk donde sea relevante — cada lugar donde el diff viole un estándar documentado. Cita el estándar (archivo + regla). Distingue infracciones graves de juicios subjetivos. Omite cualquier cosa que las herramientas automatizadas ya verifiquen. Menos de 400 palabras."

Indicación para el subagente de Especificación — incluye:

  • El comando diff y la lista de commits.
  • La ruta o contenido obtenido de la especificación.
  • La consigna: "Informe: (a) requisitos que la especificación pedía y que faltan o están incompletos; (b) comportamiento en el diff que no fue solicitado (scope creep); (c) requisitos que parecen implementados pero cuya implementación parece incorrecta. Cita la línea de la especificación para cada hallazgo. Menos de 400 palabras."

Si la especificación no está disponible, omite el subagente de Especificación y señálalo en el informe final.

5. Agregar

Presenta los dos informes bajo los encabezados ## Estándares y ## Especificación, textualmente o ligeramente limpiados. No combines ni reordenes los hallazgos — los dos ejes están deliberadamente separados (ver Por qué dos ejes).

Termina con un resumen de una línea: total de hallazgos por eje, y el peor problema dentro de cada eje (si lo hay). No elijas un único ganador entre ejes — esa es la reordenación que la separación busca evitar.

Por qué dos ejes

Un cambio puede aprobar un eje y fallar el otro:

  • Código que sigue todos los estándares pero implementa lo incorrecto → Estándares aprueba, Especificación falla.
  • Código que hace exactamente lo que pedía el issue pero rompe las convenciones del proyecto → Especificación aprueba, Estándares falla.

Informarlos por separado evita que un eje opaque al otro.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

Skills relacionados