Skill-Aktivierungs-Hook

Problem: Ein Skill, den du Claude Code benutzen lassen wolltest, wird einfach nicht geladen. Du packst die Regel in CLAUDE.md. Gleiches Ergebnis. Du tippst die Erinnerung wieder von Hand, obwohl das Framework das eigentlich selbst übernehmen sollte.

Quick Win: Ein Hook kann jede Eingabe abfangen und direkt die passenden Skill-Empfehlungen anhängen. Vergessen fällt weg, weil Claude gar nicht erst daran denken muss.

Schickst du die Nachricht "help me implement a feature", landet bei Claude tatsächlich das hier:

help me implement a feature

SKILL ACTIVATION CHECK

CRITICAL SKILLS (REQUIRED):
  -> session-management

RECOMMENDED SKILLS:
  -> git-commits

ACTION: Use Skill tool BEFORE responding

Claude sieht die genauen Skills, die es laden soll, direkt neben deiner Anfrage. Nichts zu erraten. Nichts zu merken.

Wie es funktioniert

UserPromptSubmit ist das Event, in das der Hook einhängt. Alles, was du abschickst, läuft durch diesen Ablauf:

1. Du tippst eine Nachricht - Deine natürlichsprachliche Anfrage
2. Hook greift ein - Bevor Claude irgendetwas sieht
3. Pattern-Matching - Der Hook prüft skill-rules.json auf Keyword- und Intent-Treffer
4. Empfehlungen anhängen - Passende Skills werden an deine Nachricht angehängt
5. Claude bekommt beides - Deinen Prompt plus die Skill-Hinweise

Das Ganze dauert Millisekunden. Keine Verzögerung, die du spüren würdest.

Das Matching-System

Zwei Strategien laufen parallel.

Keyword-Matching ist ein einfacher String-Vergleich. Schreibst du "commit" oder "git push", feuert der Skill git-commits.

Intent Patterns nutzen Regex für die Art, wie Menschen Dinge formulieren. Das Pattern (implement|build).*?feature trifft sowohl "let's implement this feature" als auch "build a new feature for me".

Konfiguration: skill-rules.json

Trigger für jeden Skill stehen in .claude/skills/skill-rules.json:

{
  "skills": {
    "session-management": {
      "enforcement": "suggest",
      "priority": "critical",
      "promptTriggers": {
        "keywords": ["feature", "implement", "build", "refactor"],
        "intentPatterns": ["(implement|build).*?feature"]
      }
    },
    "git-commits": {
      "enforcement": "suggest",
      "priority": "high",
      "promptTriggers": {
        "keywords": ["commit", "git push", "commit changes"],
        "intentPatterns": ["(create|make).*?commit"]
      }
    }
  }
}

Vorschläge werden nach Priorität gruppiert:

• Critical - Muss vor jeder Arbeit geladen werden
• High - Dringend empfohlen
• Medium - Hilfreicher Kontext
• Low - Optionale Ergänzung

Anpassung an deinen Sprachgebrauch

Der Hook passt sich deinem Vokabular an. Wenn du eher "push my code" sagst statt "git push", trag es einfach ein:

"keywords": ["commit", "git push", "push my code", "commit changes"]

Immer wenn du einen neuen Skill baust, bearbeitest du seine Trigger in skill-rules.json. Schau dann, was du eingetragen hast, und lass diese Phrasen auch in deine Prompts einfließen.

Session-Intelligenz

Der Hook merkt sich, was er schon vorgeschlagen hat. Kam session-management früher im selben Gespräch schon vor, bleibt er beim zweiten Mal still. Gleiche Abdeckung, weniger Rauschen.

Der Zustand wird in recommendation-log.json gespeichert und löscht sich nach 7 Tagen selbst.

Einrichtung in ClaudeFast

Der Hook ist fertig vorkonfiguriert. Öffne .claude/settings.local.json und prüf, ob einer dieser beiden Blöcke drin ist:

Windows:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "cmd /c \".claude\\hooks\\SkillActivationHook\\skill-activation-prompt.cmd\""
          }
        ]
      }
    ]
  }
}

Linux/Mac:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/SkillActivationHook/skill-activation-prompt.sh"
          }
        ]
      }
    ]
  }
}

Häufige Probleme

Keine Vorschläge erscheinen - Deine Keywords passen wahrscheinlich nicht zu deiner tatsächlichen Sprache. Starte den Hook manuell und schau dir die Ausgabe an:

echo '{"session_id":"test","prompt":"implement a feature"}' | node .claude/hooks/SkillActivationHook/skill-activation-prompt.mjs

Vorschläge erscheinen, wenn nicht nötig - Keywords sind zu breit. Schärfe sie nach, oder verschiebe den Trigger in ein Intent Pattern.

Doppelte Vorschläge - Der Hook ist in zwei Stellen gleichzeitig eingetragen. Wähl eine Settings-Datei und entferne ihn aus der anderen.

Nächste Schritte

1. Prüf, ob deine skill-rules.json zu deinem Vokabular passt
2. Füge Keywords für neue Skills hinzu, die du erstellst
3. Richte den Hooks-Guide für vollständige Hook-Abdeckung ein
4. Konfiguriere den Stop Hook, um Aufgaben-Abschluss zu erzwingen
5. Lies mehr über CLAUDE.md-Konfiguration als Ergänzung zum Hook
6. Schau in den Skills-Guide, wenn du neue Skills erstellen musst

Der Skill-Aktivierungs-Hook nimmt das menschliche Gedächtnis aus dem Prozess. Beschreib die Arbeit in einfacher Sprache. Die richtige Skill-Auswahl übernimmt das Framework. Das ist der ganze Punkt.