Skip to main content

Por qué una skill

Puede que tu equipo ya mantenga sus reglas de seguridad como una skill de agente, para los asistentes de código. Un agente personalizado puede seguir la misma skill en el code review: la abre cuando el cambio la necesita, lee sus archivos de referencia y cita la regla que aplica cada hallazgo. Cuando la skill cambia en la rama principal, el agente sigue la nueva versión sin tocar la configuración. El ejemplo es una API de agendamiento multi-tenant en la que toda consulta debe limitarse al workspace de quien llama.

Paso 1 — La skill en el repositorio

.claude/skills/tenant-isolation/SKILL.md
.claude/skills/tenant-isolation/references/tenant-tables.md
El nombre de la carpeta y name deben coincidir, y description es obligatoria.

Paso 2 — Impórtala como agente

1

Abre la configuración del repositorio

Elige el repositorio en el selector de alcance, luego What to review → Custom agents → New agent.
2

Import from repository

La pestaña lista las skills encontradas en la rama por defecto. Haz clic en tenant-isolation.
3

Revisa el resultado

El agente se crea apagado, con el nombre Tenant isolation reviewer, la skill vinculada y estas instrucciones:

Paso 3 — Afina las instrucciones

Mantén la referencia a la skill y agrega qué prueba necesita un hallazgo:
Instructions

Paso 4 — Opcional: un plugin

Si tu gestor de tareas está instalado como plugin, actívalo en Tools → Plugins. Solo se ofrecen herramientas de lectura. Cuando la descripción de un pull request enlaza un ticket, el agente puede leerlo y verificar el cambio contra lo que pide.

Paso 5 — Comentarios

Haz clic en Save.

Paso 6 — Try it

Ejecuta Try it en un pull request que agregue un endpoint. Revisa:
  • Skills opened lista .claude/skills/tenant-isolation, y references/tenant-tables.md cuando el agente lo necesitó.
  • Los hallazgos conservados citan una regla de la skill:
  • Los hallazgos descartados muestran su motivo. Una observación general de seguridad que la skill no cubre se descarta por estar fuera del foco del agente, que es lo que quieres aquí.
Activa el agente. Para pedir una segunda opinión sobre un pull request abierto más adelante, comenta @kody -v tenant-isolation-reviewer.

Checklist

  • SKILL.md tiene name igual a su carpeta y una description
  • Los archivos de referencia están como mucho una carpeta debajo de la skill
  • Las instrucciones dicen qué prueba necesita un hallazgo
  • La severidad mínima corresponde a cuánto debe hablar el agente
  • Probado en un pull request con una brecha conocida
Consulta Skills & docs para la detección y los presupuestos.