# Hooks Automation

> Configure Claude Code hooks for automated coordination and learning

- Skill: `ruvnet/hooks-automation-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add ruvnet/hooks-automation-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ruvnet/hooks-automation-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ruvnet (https://skillmd.com/u/ruvnet)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/ruvnet/hooks-automation-2

---


# Hooks Automation Skill

Configure intelligent hooks for automated coordination, formatting, and learning.

## Available Hooks

### PreToolUse Hooks
Triggered before Claude Code tools execute.

```json
{
  "PreToolUse": [
    {
      "matcher": "Edit|Write|MultiEdit",
      "hooks": [{
        "type": "command",
        "command": "npx agentic-flow@alpha hooks pre-edit \"$TOOL_INPUT_file_path\""
      }]
    },
    {
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "npx agentic-flow@alpha hooks pre-command \"$TOOL_INPUT_command\""
      }]
    }
  ]
}
```

### PostToolUse Hooks
Triggered after successful tool execution.

```json
{
  "PostToolUse": [
    {
      "matcher": "Edit|Write|MultiEdit",
      "hooks": [{
        "type": "command",
        "command": "npx agentic-flow@alpha hooks post-edit \"$TOOL_INPUT_file_path\" --success"
      }]
    }
  ]
}
```

### Session Hooks
Triggered at session start/end.

```json
{
  "SessionStart": [{
    "hooks": [{
      "type": "command",
      "command": "npx agentic-flow@alpha hooks intelligence stats --json"
    }]
  }],
  "SessionEnd": [{
    "hooks": [{
      "type": "command",
      "command": "npx agentic-flow@alpha hooks metrics --session --json"
    }]
  }]
}
```

## Hook Commands

```bash
# Pre-edit: Check for patterns, validate
npx agentic-flow@alpha hooks pre-edit "src/api.ts"

# Post-edit: Format, learn pattern
npx agentic-flow@alpha hooks post-edit "src/api.ts" --success

# Pre-command: Validate safety
npx agentic-flow@alpha hooks pre-command "npm install"

# Post-command: Track result
npx agentic-flow@alpha hooks post-command "npm install"

# Intelligence routing
npx agentic-flow@alpha hooks route "implement OAuth"

# Session metrics
npx agentic-flow@alpha hooks metrics --session
```

## Automation Features

### Auto-Agent Assignment
Hooks automatically assign specialized agents based on file type:
- `.ts`, `.tsx` → TypeScript agent
- `.py` → Python agent
- `.md` → Documentation agent
- `test.*` → Testing agent

### Command Validation
Pre-command hooks validate for:
- Dangerous patterns (rm -rf, force push)
- Permission requirements
- Resource limits

### Pattern Learning
Post-edit hooks learn:
- Code patterns
- Successful solutions
- Error recovery strategies

### Metrics Tracking
Session hooks track:
- Token usage
- Tool invocations
- Success rates
- Performance metrics

## Configuration

Full hook configuration in `.claude/settings.json`:

```json
{
  "hooks": {
    "PreToolUse": [...],
    "PostToolUse": [...],
    "PostToolUseFailure": [...],
    "SessionStart": [...],
    "SessionEnd": [...],
    "UserPromptSubmit": [...],
    "Stop": [...]
  }
}
```

## Best Practices

1. **Keep hooks fast**: <100ms for interactive experience
2. **Use timeout**: Prevent hanging hooks
3. **Handle failures gracefully**: Use `|| true` for optional hooks
4. **Log metrics**: Track for optimization
5. **Test hooks**: Verify before deployment

