Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Hook Scope Decision Guide · athola | DecimalAI

agent toolingby athola

Hook Scope Decision Guide

athola/hook-scope-guide

Source athola/claude-night-market ↗License MIT

Select hook scope (plugin, project, global) by audience.

SkillScore86Maintained

Automatic

AI Engineer pack

Last verified 8/20/2026

What it changes

Passed 19 of 22 test cases with the skill, and 3 of 22 without it.

Without skill14%

With skill86%

Checks it passed that the model alone missed

Specifies the file path .claude/settings.json
Specifies the file path ~/.claude/settings.json
Recommends placing global hooks in ~/.claude/settings.json

and 20 more in the full report

16 fixed3 passed either way3 still failing0 broke

Pass-rate lift: +73 pp
Tokens: +58%
Agent turns: 0%
Response time: -54%

Model gemini-3.6-flashMeasured 8/20/2026v119 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/athola-hook-scope-guide/SKILL.md https://app.decimal.ai/s/athola-hook-scope-guide/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add athola-hook-scope-guide, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/athola-hook-scope-guide/ and pins it in .decimal/skills.lock

decimalai skills add athola-hook-scope-guide

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/athola-hook-scope-guide/SKILL.md https://app.decimal.ai/s/athola-hook-scope-guide/SKILL.md

Raw file: /s/athola-hook-scope-guide/SKILL.md ↗ · machine-readable summary at /s/athola-hook-scope-guide.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 16 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 16

Prompt

If both a global hook in ~/.claude/settings.json and a project hook in .claude/settings.json match the same PreToolUse event, which hook executes first?

What was checked, without and with the skill
Checked	Without skill	With skill
States that all matching hooks execute in parallel rather than sequentially	Missed	Passed

case-16 · gemini-3.6-flash · 8/20/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md282 linessingle file

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)

Important: Auto-Loading Behavior

hooks/hooks.json is automatically loaded by Claude Code when the plugin is enabled. Do NOT add "hooks": "./hooks/hooks.json" to your plugin.json - this causes duplicate load errors. The hooks field in plugin.json is only needed for additional hook files beyond the standard hooks/hooks.json.

The Three Scopes

Scope	Location	Audience	Committed?	Persistence
Plugin	`hooks/hooks.json` in plugin	Plugin users	With plugin	When plugin enabled
Project	`.claude/settings.json`	Team members	Yes (repo)	Per project
Global	`~/.claude/settings.json`	Only you	Never	All sessions

Decision Framework

Question 1: Who needs this hook?

Only plugin users → Plugin hooks

Hook is part of plugin's core functionality
Users expect it when they enable your plugin
Example: A YAML plugin validates YAML syntax on edit

All team members on this project → Project hooks

Codebase-specific rules or protections
Team conventions that should be enforced
Example: Block modifications to /src/production/ configs

Only me, everywhere → Global hooks

Track record

Benchmark

19 / 22

test cases passed, vs 3 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

athola / claude-night-market

plugins/abstract/skills/hook-scope-guide/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Hook Scope Decision Guide

Overview

When NOT To Use

Important: Auto-Loading Behavior

The Three Scopes

Decision Framework

Question 1: Who needs this hook?

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills