Hook de Ativação de Skills

Problema: Uma skill que você pediu ao Claude Code para usar nunca é carregada. Você move a regra para o CLAUDE.md. Mesmo resultado. Você acaba digitando o lembrete na mão para skills que o framework deveria carregar automaticamente.

Solução rápida: Um hook pode interceptar cada prompt e adicionar as recomendações de skill certas no final. O esquecimento some porque o Claude nunca precisou lembrar de nada.

Você envia a mensagem "help me implement a feature" e o que chega de fato na entrada do Claude é isto:

help me implement a feature

SKILL ACTIVATION CHECK

CRITICAL SKILLS (REQUIRED):
  -> session-management

RECOMMENDED SKILLS:
  -> git-commits

ACTION: Use Skill tool BEFORE responding

O Claude vê exatamente as skills que deve carregar, ao lado do seu pedido. Nada a adivinhar. Nada a lembrar.

Como Funciona

UserPromptSubmit é o evento que o hook intercepta. Tudo o que você envia passa por esse fluxo:

1. Você digita uma mensagem - Seu pedido em linguagem natural
2. Hook intercepta - Antes de o Claude ver qualquer coisa
3. Correspondência de padrões - O hook verifica skill-rules.json para correspondências de palavras-chave e intenção
4. Adiciona recomendações - As skills que correspondem são adicionadas à sua mensagem
5. Claude recebe os dois - Seu prompt mais as orientações de skill

Tudo isso termina em milissegundos. Sem nenhum atraso perceptível.

O Sistema de Correspondência

Duas estratégias rodam em paralelo.

Correspondência de palavras-chave é uma verificação literal de string. Mencione "commit" ou "git push" e a skill git-commits é acionada.

Padrões de intenção usam regex para capturar a forma como as pessoas realmente escrevem. O padrão (implement|build).*?feature captura tanto "let's implement this feature" quanto "build a new feature for me".

Configuração: skill-rules.json

Os gatilhos para cada skill ficam em .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"]
      }
    }
  }
}

As sugestões são agrupadas por prioridade:

• Critical - Deve ser carregada antes de qualquer trabalho
• High - Fortemente recomendada
• Medium - Contexto útil
• Low - Melhoria opcional

Personalização para o Seu Vocabulário

O hook se adapta ao seu vocabulário. Se "push my code" é o que sai dos seus dedos em vez de "git push", adicione:

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

Sempre que você criar uma nova skill, edite os gatilhos dela em skill-rules.json. Depois olhe o que você colocou lá e deixe essas frases guiarem como você escreve prompts.

Inteligência de Sessão

O hook lembra o que já sugeriu. Se session-management apareceu antes na mesma conversa, ele fica quieto na segunda vez. Mesma cobertura, menos ruído.

O estado é mantido em recommendation-log.json e se limpa automaticamente após 7 dias.

Configuração no ClaudeFast

O hook vem pré-configurado. Abra .claude/settings.local.json e confirme que um desses dois blocos está lá:

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"
          }
        ]
      }
    ]
  }
}

Problemas Comuns

Nenhuma sugestão aparece - Suas palavras-chave provavelmente não correspondem à forma como você fala. Execute o hook manualmente e observe a saída:

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

Sugestões aparecendo quando não precisa - As palavras-chave são muito amplas. Afine-as, ou mova o gatilho para um padrão de intenção.

Sugestões duplicadas - O hook está configurado em dois lugares ao mesmo tempo. Escolha um arquivo de configurações e remova do outro.

Próximos Passos

1. Verifique se seu skill-rules.json corresponde ao seu vocabulário
2. Adicione palavras-chave para novas skills que você criar
3. Configure o Guia de Hooks principal para cobertura completa de hooks
4. Configure o Stop Hook para impor a conclusão de tarefas
5. Aprenda mais sobre a configuração do CLAUDE.md para complementar o hook
6. Revise o guia de skills se precisar criar novas skills

O Hook de Ativação de Skills tira a memória humana do circuito. Descreva o trabalho em linguagem simples. Escolher as skills certas fica por conta do framework. Esse é o objetivo de ter um.