gh-henkisdabro-wookstar-claude-code-plugins-claudecode-toolkit/hooks/skill-activation-prompt

skill-activation-prompt Hook

Purpose: Automatically suggests relevant skills based on user prompts and file context

How It Works

1. Reads skill-rules.json to understand skill trigger patterns
2. Matches user prompts against configured patterns
3. Checks which files the user is working with
4. Injects skill suggestions into Claude's context automatically

Why This Hook Is Essential

This hook makes skill auto-activation work seamlessly. Instead of manually invoking skills, Claude automatically recognizes when a skill would be relevant and suggests it to you.

Installation

Step 1: Copy Hook Files

Copy both the shell script and TypeScript implementation to your project's hooks directory:

# Copy both files from the claudecode-toolkit hooks folder
cp skill-activation-prompt.sh your-project/.claude/hooks/
cp skill-activation-prompt.ts your-project/.claude/hooks/

# Make the shell script executable
chmod +x your-project/.claude/hooks/skill-activation-prompt.sh

Step 2: Install Dependencies

Navigate to your hooks directory and install dependencies:

cd your-project/.claude/hooks
npm install

Step 3: Configure Claude Code

Add the hook to your .claude/settings.json:

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

Configuration

The hook looks for a skill-rules.json file in your .claude/hooks directory to understand which skills to suggest. This file defines patterns that trigger skill suggestions.

Example skill-rules.json:

{
  "rules": [
    {
      "patterns": ["spreadsheet", "excel", "csv", "xlsx"],
      "skills": ["xlsx"],
      "filePatterns": ["**/*.xlsx", "**/*.csv"]
    },
    {
      "patterns": ["pdf", "document", "ocr"],
      "skills": ["pdf-processing-pro"],
      "filePatterns": ["**/*.pdf"]
    }
  ]
}

How the Hook Triggers

The hook activates on the UserPromptSubmit event, which occurs every time you submit a prompt to Claude. It:

1. Analyzes your prompt text for relevant keywords
2. Checks your current project files for context
3. Matches against configured rules
4. Suggests applicable skills before Claude processes your request

Troubleshooting

Hook not triggering:

• Verify the shell script is executable: chmod +x skill-activation-prompt.sh
• Check settings.json is properly formatted
• Ensure skill-rules.json exists in .claude/hooks/

npm install fails:

• Make sure you're in the .claude/hooks/ directory
• Verify Node.js is installed: node --version
• Try clearing npm cache: npm cache clean --force

Skills not being suggested:

• Review skill-rules.json patterns
• Check that skill names match installed skills
• Verify file patterns match your project structure