Skills

Einen Skill hinzufügen

1. Lege einen Ordner in .agents/skills/ an. Der Ordnername ist der Name des Skills, etwa api-auth.
2. Füge dem Ordner eine SKILL.md hinzu. Wie es das Format Agent Skills verlangt, beginnt sie mit Frontmatter, das den name wiederholt und unter description beschreibt, wann der Skill verwendet werden soll.
3. Schreibe das Vorgehen unter das Frontmatter.
4. Führe den Skill unter skills in jeder Repository-Prüfung auf, die ihn braucht.

.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.

• Skill-Namen bestehen aus Kleinbuchstaben, Ziffern und einzelnen Bindestrichen, bis zu 64 Zeichen.
• Jeder Skill ist ein Ordner mit einer SKILL.md. HeyDeer lädt den gesamten Ordner so, wie es das Format Agent Skills beschreibt, einschließlich der Dateien, auf die SKILL.md verweist.
• HeyDeer liest Skills aus dem Pull Request, sodass ein Pull Request die Skills hinzufügen oder ändern kann, die seine eigene Prüfung verwendet. Siehe Was ein Pull Request ändern kann.

Skills in einer Repository-Prüfung aufführen

Füge die Skill-Namen unter skills im Frontmatter der Repository-Prüfung hinzu, als einzelnen Namen oder als Liste:

.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.

• Skills sind Hilfestellungen. Fehlt ein aufgeführter Skill, führt HeyDeer die Repository-Prüfung trotzdem anhand ihrer Anweisungen aus.
• Eine passende Repository-Prüfung mit einem ungültigen Skill-Namen ist ungültig. HeyDeer überspringt sie, meldet sie unter Hinweise zur Prüfung und setzt die Prüfung fort.

Verwendest du bereits .claude/skills?

Füge einen Symlink hinzu, damit dieselben Skills auch in .agents/skills liegen. Du musst sie nicht verschieben:

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