CommunityRedacción y edicióngithub.com

Agilefreaks/claude-skills

Un mercado de complementos para claude.ai

¿Qué es claude-skills?

El skill 'Agilefreaks/claude-skills' es un mercado de complementos diseñado para claude.ai, que permite a los desarrolladores y usuarios de Claude integrar funcionalidades modulares y personalizadas en sus proyectos. Este skill facilita la gestión de complementos, desde la instalación inicial hasta la configuración detallada, adaptándose a las herramientas y flujos de trabajo existentes. Está diseñado para ser utilizado con plataformas como Claude Code, Cursor y Codex, y se basa en archivos de reglas (como `.claude/rules/` y `CLAUDE.md`) para garantizar que las configuraciones no se dupliquen. Además, ofrece integración opcional con GitHub Actions para automatizar revisores de código, y prioriza la toma de decisiones del usuario mediante diálogos interactivos que cubren aspectos como la recopilación de contexto, verificación de compilación y formatos de salida, asegurando una experiencia de configuración flexible y controlada.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add Agilefreaks/claude-skills

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Habilidad de Revisión de Código

Metodología de revisión de código externa, basada en riesgos, según Gregory Brown ("Effective Code Reviews", Programming Beyond Practices, 2015).

La integración con la plataforma y las comprobaciones específicas del proyecto se definen por separado en las reglas de tu proyecto.


Configuración

Cuando se te pida configurar, integrar, incorporar o crear un archivo de reglas para esta habilidad:

  1. Lee todas las reglas existentes del proyecto (.claude/rules/, CLAUDE.md) para comprender lo que ya está configurado. No dupliques convenciones, comandos o comprobaciones que ya existan en la configuración del proyecto.
  2. Inspecciona el proyecto para identificar convenciones de enlace de issues/PR, configuración de CI, configuraciones de linter/formateador e indicadores de plataforma de revisión de código.
  3. Presenta al usuario opciones interactivas para cada decisión específica de la habilidad, utilizando un diálogo de opciones para cada una:
    • Recopilación de Contexto — cómo localizar el issue o ticket relevante para un PR (nombrado de ramas, palabras clave en el cuerpo del PR, integración con gestión de tareas)
    • Verificación de Compilación — cómo verificar que la compilación se esté realizando correctamente (comprobaciones de estado de CI, comandos específicos)
    • Convenciones de Codificación — comprobaciones específicas del proyecto más allá de los valores predeterminados de la habilidad (reglas de arquitectura, reglas de estilo ya aplicadas por los linters)
    • Formato de Salida — estructura personalizada para la salida de la revisión, o usar el formato incorporado
    • Mecánica de Publicación — cómo publicar la revisión (comentario en PR de GitHub, comentarios en línea, stdout)
    • Manejo de Hilos de Re-Revisión — en una re-revisión, qué hacer con tus propios hilos de hallazgos anteriores: Responder y resolver (predeterminado — responder en el hilo y resolver los hilos que están corregidos o respondidos), Solo responder (responder en el hilo pero dejar la resolución a los humanos), o Solo resumen (nunca tocar hilos anteriores; informar su estado solo en el resumen)
    • Integración de CI — ofrecer generar un flujo de trabajo de GitHub Actions que ejecute esta revisión automáticamente en cada PR. Pregunta siempre esto, incluso si aún no existe el directorio .github/workflows/ — este podría ser el primer flujo de trabajo del proyecto. Presenta opciones de modelo: Opus (recomendado) / Sonnet / Omitir. Predeterminado: Opus.
  4. Escribe .claude/rules/code-review.md que contenga solo las elecciones del usuario. Omite cualquier decisión donde el usuario acepte el valor predeterminado — el comportamiento integrado de la habilidad maneja esos casos.
  5. Si el usuario optó por la Integración de CI: a. Lee assets/code-review.yml (incluido con esta habilidad) como plantilla del flujo de trabajo. b. Sustituye --model opus con --model <modelo-elegido> si el usuario eligió un modelo diferente. c. Si ya existe .github/workflows/code-review.yml en el proyecto, muestra un diff y pide confirmación antes de sobrescribir. d. Escribe el flujo de trabajo en .github/workflows/code-review.yml (crea .github/workflows/ si no existe). e. Recuerda al usuario que agregue CLAUDE_CODE_OAUTH_TOKEN como secreto del repositorio:
    • Genera el token localmente con: claude setup-token
    • Agrégalo en: Repositorio de GitHub → Configuración → Secretos y variables → Acciones → Nuevo secreto de repositorio

Qué diferir a un humano (Integración de CI): El usuario debe agregar el secreto CLAUDE_CODE_OAUTH_TOKEN y verificar que las reglas de protección de ramas permitan que la acción publique comentarios de revisión. La configuración no puede verificar ni configurar esos aspectos.

Si el usuario acepta todos los valores predeterminados y no se tomaron decisiones, confirma que no se necesita un archivo de reglas y detente.


Fase 0: Estado de Revisión Anterior (re-revisiones)

Antes de revisar, averigua lo que ya se ha dicho.

Recopila la conversación de revisión existente sobre este cambio:

  • Todos los hilos de discusión en línea, incluyendo respuestas y su estado resuelto/no resuelto — tanto los tuyos como los de los revisores humanos.
  • Tu propio resumen de revisión anterior, si existe (identificado por su marcador oculto — ver Fase 6).

Si tu proyecto define mecánicas de publicación en la plataforma, úsalas para obtener este estado. Si no hay mecánicas de plataforma configuradas (por ejemplo, la revisión va a stdout), trata esto como una primera revisión y anota en el resumen que no se pudo verificar el estado de revisión anterior.

Si no existe un estado de revisión anterior, esta es una primera revisión — procede a la Fase 1 y omite los pasos de re-revisión en la Fase 6.

Lee cada hilo; actúa solo sobre los tuyos. Los hilos de los revisores humanos informan la revisión — nunca plantees una preocupación que un revisor humano ya haya planteado, haya sido respondida o no. Identifica tus propios hilos por el marcador oculto incrustado en cada hallazgo que publiques (ver Fase 6), nunca por la cuenta de publicación — la cuenta difiere entre ejecuciones de CI y locales.

Para cada uno de tus hallazgos anteriores, clasifícalo y lleva la disposición al resto de la revisión:

  1. Corrección enviada — el autor cambió el código en respuesta. Verifica la corrección en el diff actual durante la revisión. Si está realmente corregida: responde en el hilo confirmándolo (por ejemplo, "Corrección verificada en <revisión>") y resuelve el hilo. Si se afirma pero no está corregida: responde explicando qué falta aún y deja el hilo abierto.
  2. Respondido — el autor explicó o refutó el hallazgo. Su respuesta es autoritaria; no lo vuelvas a plantear. Responde reconociéndolo y resuelve el hilo.
  3. Aún abierto — sin respuesta, sin corrección. No publiques un comentario duplicado. Deja el hilo intacto y enuméralo bajo "Hallazgos anteriores" en el nuevo resumen.

Los hallazgos genuinamente nuevos de esta revisión se publican como de costumbre en la Fase 6.

Si tu proyecto configura un modo de manejo de hilos de re-revisión (ver Configuración), síguelo — algunos equipos reservan la resolución de hilos para los humanos. El valor predeterminado es responder y resolver.

Qué diferir a un humano: Adjudicar disputas — cuando un autor se opone, esta habilidad se retira; si el punto en disputa sigue siendo importante, un revisor humano debe tomar la decisión. Si un revisor automatizado puede resolver hilos en absoluto es una convención del equipo — los humanos lo poseen (configurar a través de Configuración).


Fase 1: Validación del Problema

Comienza aquí — antes de leer una sola línea de código.

Haz dos preguntas:

  1. ¿Este código realmente resuelve el problema que se supone que debe resolver?
  2. ¿Enviar esta mejora aumentará el valor del proyecto en su conjunto?

Si la respuesta a alguna de las dos es no — detente. No revises el código. Ponte en contacto con quien decide qué se construye y discútelo. Revisar código que no sobrevivirá en producción es una pérdida de tiempo.

Para responder a estas preguntas: lee el issue o ticket vinculado, la documentación de apoyo y cualquier discusión relevante. Si tu proyecto define cómo localizar el issue o ticket relevante (integración con gestión de tareas, convenciones de nombrado de ramas), sigue eso. Si no existe ningún issue ni integración configurada, usa el título y la descripción del PR como fuente de verdad. Verifica si el diff aborda plausiblemente lo que se describió.

Qué diferir a un humano: Ejecutar realmente la función y verificar que funcione desde la perspectiva del usuario. Puedes validar la alineación lógica entre el problema declarado y el diff; un humano debe verificar que realmente funcione.


Fase 2: Compilación y Ejecutabilidad

  • ¿Está pasando la compilación? Si no, pausa la revisión. Una compilación rota no es de fiar. Incluso si el nuevo cambio funciona correctamente, otras cosas podrían estar rotas. No asumas que un fallo de compilación es inocuo.
  • ¿Se está ejecutando el código en algún lugar que no sea la máquina del autor? Un entorno de producción es ideal; un entorno de pruebas o la máquina de otro desarrollador es una prueba de humo aceptable.
  • ¿Obtener el código en funcionamiento requirió pedir ayuda a alguien? Si es así, falta documentación o la configuración necesita automatizarse — o ambas.

Si tu proyecto define cómo verificar el estado de la compilación (sistema de CI, comprobaciones de estado), úsalo. De lo contrario, verifica cualquier indicador de compilación disponible en el contexto del cambio.

Qué diferir a un humano: Ejecutar el código localmente o en un entorno de pruebas, probar la función desde la perspectiva de las personas que la usarán y plantear cualquier preocupación sobre usabilidad, manejo de errores o comportamiento sorprendente.


Fase 3: Auditoría de Pruebas

Las pruebas modificadas o eliminadas son una bandera roja — investiga antes que cualquier otra cosa.

Cuando veas cambios en pruebas existentes, reduce la velocidad. Pregunta: ¿por qué fueron modificadas? Comprende la razón antes de formarte cualquier opinión.

Muchas modificaciones son relativamente inocentes — eliminar una prueba para un comportamiento que era incorrecto, cambiar la granularidad de la prueba o reemplazar algo que este PR supera. Nada de eso es inherentemente peligroso, pero requiere reflexión. La pregunta clave es: ¿esta modificación cambia un contrato del que dependen otras partes del código base?

  • Cambios a pruebas para código aislado y autocontenido = relativamente seguro
  • Cambios a pruebas para código compartido o reutilizado = mayor riesgo; necesita justificación explícita

Si no puedes responder a la pregunta solo con el diff, pausa y pregúntale al autor. Estas conversaciones construyen entendimiento compartido y sacan a la superficie suposiciones equivocadas antes de que causen daños reales.


Fase 4: Evaluación de Cobertura

Categoriza el cambio, luego aplica expectativas apropiadas al riesgo. Un conjunto de pruebas que pasa solo es tan bueno como los comportamientos que describe — no puedes automatizar el proceso de revisar pruebas.

Corrección de Errores

Toda corrección de errores debe ir acompañada de pruebas de regresión. Como mínimo, una prueba de aceptación de alto nivel que siga el mismo camino descrito en el informe de error — mapeando acciones que un usuario real podría tomar, no solo un desencadenante directo del fallo interno.

Las pruebas unitarias deben complementar las pruebas de aceptación para cualquier cosa compleja o grave, para proporcionar retroalimentación más detallada cuando algo se rompa en el futuro.

También busca el patrón de canario en la mina: ¿Es este error verdaderamente único, o es una señal de un problema más profundo y extendido? Verifica si existen patrones similares en otras partes del código base. Si los hay, crea tickets — no necesitas arreglarlos todos ahora, pero sacarlos a la luz es una contribución importante.

Nueva Funcionalidad

Aplica el experimento mental de cero pruebas: si se cumplen todas las siguientes condiciones, una cobertura de pruebas mínima es aceptable:

  1. El cambio consiste casi por completo en código nuevo, que depende solo de infraestructura, framework, bibliotecas y objetos genéricos de acceso a datos
  2. La nueva funcionalidad está aislada en su propia área (su propia página, espacio de nombres o endpoint)
  3. No introduce nuevos efectos secundarios a nivel de sistema (sin cambios en dependencias, configuraciones o carga en recursos compartidos)
  4. No está planeado que se use como bloque de construcción para otras funcionalidades en la hoja de ruta
  5. No es un paso intermedio en una cadena de flujo de trabajo que une otras características
  6. Los fallos no pueden escapar hacia afuera y causar inestabilidad en otros lugares
  7. Cualquier fallo concebible sería aceptable para las partes interesadas y no causaría un daño significativo
  8. Las pruebas podrían escribirse más tarde sin costo o retraso inaceptables

Para cada condición que no se cumpla, espera pruebas que aborden específicamente ese riesgo. Una funcionalidad a la que se permite fallar, completamente aislada y fácil de probar más tarde, no es un riesgo importante. Una funcionalidad que se integra en flujos de trabajo existentes, puede causar fallos en otros lugares o se construirá sobre ella — sí lo es.

Mejora: Complemento

Código nuevo que coexiste junto a una funcionalidad existente. Aplica los criterios de nueva funcionalidad anteriores, luego ve más allá: porque vive junto a funcionalidad existente, el aislamiento de fallos es la principal preocupación.

¿Puede un fallo en el complemento derribar la funcionalidad existente? Piensa en los peores escenarios de fallo. ¿Están cubiertos los casos límite y las condiciones de contorno?

Mejora: Extensión

Se basa en el comportamiento existente reutilizando componentes existentes. Antes de evaluar el nuevo código, realiza una mini-auditoría de lo que se está reutilizando:

  • ¿Tienen pruebas los componentes reutilizados?
  • ¿Están documentados a nivel empresarial y/o de código?
  • ¿Fueron diseñados pensando en la reutilización, o se están estirando más allá de su propósito original?
  • ¿Han aparecido en informes de error recientes o no resueltos?
  • ¿Qué probabilidad hay de que cambien? Si cambian, ¿romperá esta extensión?

No necesitas dedicar más de unos minutos a esto — es un experimento mental, no una investigación profunda. Pero los riesgos conocidos y calculados siempre son mejores que las sorpresas. Crea tickets para cualquier cosa que valga la pena rastrear.

Mejora: Refinamiento

Modifica el comportamiento existente del sistema. Categoría de riesgo más alta. Comienza aplicando todo lo de la revisión de extensión anterior. Luego ve más allá.

Encuentra cada pieza de funcionalidad que depende del código que se está modificando. Cada dependiente está potencialmente afectado. Idealmente, ejecutarías cada uno a través del proceso de revisión completo, pero en la práctica eso rara vez es factible. Como mínimo: identifica los dependientes, verifica si sus pruebas aún se mantienen y marca la lista completa para que el revisor humano la pruebe manualmente.


Fase 5: Comprobaciones Específicas del Proyecto

Si tu proyecto define convenciones de codificación, patrones de arquitectura o reglas de estilo, aplícalas al diff y verifica si hay infracciones.

Si no se definen convenciones del proyecto, verifica: nomenclatura inconsistente dentro del diff, código muerto introducido por el cambio, duplicación obvia, manejo de errores faltante en los límites del sistema y preocupaciones de seguridad (entrada no saneada, secretos codificados, permisos excesivamente amplios).

Si tu proyecto ha definido mecánicas de publicación específicas de la plataforma (cómo publicar una revisión, formato para comentarios en línea, etc.), síguelas en la siguiente fase.


Fase 6: Evaluación de Riesgos y Salida

Asigna un nivel de riesgo:

  • Bajo — cambio aislado, no se toca código compartido, las pruebas están limpias y son apropiadas para el tipo de cambio
  • Medio — toca comportamiento existente o código compartido, pero bien probado y las dependencias se entienden
  • Alto — modifica componentes compartidos con dependientes, pruebas cambiadas o faltantes para el tipo de cambio, involucra seguridad o autenticación

Produce un resumen de revisión que incluya:

  • Contexto: qué hace el PR, qué problema resuelve
  • Qué se ve bien
  • Preocupaciones encontradas (tanto generales como a nivel de línea, cuando corresponda)
  • En una re-revisión: una sección de Hallazgos anteriores que enumere cada uno de tus hallazgos anteriores con su estado — resuelto (verificado corregido), respondido (respuesta del autor aceptada) o aún abierto — antes de las nuevas preocupaciones. Las revisiones por primera vez omiten esta sección.
  • Nivel de riesgo y razonamiento

Produce un resumen de revisión que incluya:

  • Contexto: qué hace el PR, qué problema resuelve
  • Qué se ve bien
  • Preocupaciones encontradas (tanto generales como a nivel de línea, cuando corresponda)
  • En una re-revisión: una sección de Hallazgos anteriores que enumere cada uno de tus hallazgos anteriores con su estado — resuelto (verificado corregido), respondido (respuesta del autor aceptada) o aún abierto — antes de las nuevas preocupaciones. Las revisiones por primera vez omiten esta sección.
  • Nivel de riesgo y razonamiento

Skills relacionados