Hook Scope Decision Guide

Overview

This skill helps you choose the right location for Claude Code hooks based on their purpose, audience, and persistence needs.

When NOT To Use

• Writing the hook itself (use abstract:hook-authoring)
• Scoring an existing hook (use abstract:hooks-eval)

Decision Framework

Three questions pick the scope: who needs this hook, should it be version controlled, and how long should it persist. Plugin hooks (hooks/hooks.json in the plugin) serve plugin users while the plugin is enabled. Project hooks (.claude/settings.json) serve the team and are committed. Global hooks (~/.claude/settings.json) serve only you, in every session, and are never committed.