heydeer
Empieza gratis
Enseña tu código a HeyDeer

Skills

Una skill contiene un procedimiento reutilizable, por ejemplo, cómo verificar el control de acceso de una ruta, en el formato abierto Agent Skills. Una comprobación del repositorio indica las skills que necesita, y HeyDeer las sigue mientras realiza esa comprobación.

Añadir una skill

  1. Crea una carpeta en .agents/skills/. El nombre de la carpeta es el nombre de la skill, como api-auth.
  2. Añade un SKILL.md a la carpeta. Como exige el formato Agent Skills, empieza con un frontmatter que repite el name y da una description de cuándo usar la skill.
  3. Escribe el procedimiento debajo del frontmatter.
  4. Añade la skill en skills en cada comprobación que la necesite.

.agents/skills/api-auth/SKILL.md

---
name: api-auth
description: How route handlers authenticate and authorize requests.
  Use when checking a route's access control.
---
# Checking a route's access control

1. Find the handler in src/routes/ and the middleware its router
   applies.
2. requireAuth() from src/auth/middleware.ts must run before the
   handler reads the request.
3. Routes under /admin also need requireRole('admin').
4. A handler that takes an :orgId parameter calls
   assertMember(user, orgId) before its first query.

Routes listed in src/routes/public.ts are public by design.
  • Los nombres de skill usan letras minúsculas, dígitos y guiones simples, hasta 64 caracteres.
  • Cada skill es una carpeta con un SKILL.md. HeyDeer carga la carpeta completa como describe el formato Agent Skills, incluidos los archivos a los que hace referencia SKILL.md.
  • HeyDeer lee las skills del pull request, así que un pull request puede añadir o cambiar las skills que usa su propia revisión. Consulta Qué puede cambiar un pull request.

Enumerar skills en una comprobación

Añade los nombres de las skills en skills en el frontmatter de la comprobación, como un solo nombre o una lista:

.agents/checks/route-auth.md

---
files: "src/routes/**"
skills: [api-auth]
---
Every new or changed route handler checks authentication and
authorization before it reads the request.
  • Las skills son orientativas. Si falta una skill de la lista, HeyDeer sigue realizando la comprobación a partir de sus instrucciones.
  • Una comprobación aplicable que incluye un nombre de habilidad no válido es no válida. HeyDeer la omite, la indica en Notas de la revisión y continúa la revisión.

¿Ya usas .claude/skills?

Añade un enlace simbólico para que las mismas skills estén también en .agents/skills. No hace falta moverlas:

mkdir -p .agents
ln -s ../.claude/skills .agents/skills
git add .agents/skills