hooks-explainer

name	hooks-explainer
description	Documents the hook enforcement system, bypass mechanisms, and common failure patterns to help agents avoid getting stuck on protected path writes
version	1
model	sonnet
invoked_by	both
user_invocable	true
tools	["Read","Write","Bash"]
verified	true
lastVerifiedAt	"2026-04-16T23:40:27.289Z"
agents	["developer"]
category	Specialized Patterns
tags	["hooks","explainer","documents","hook","enforcement","system","bypass","mechanisms"]
best_practices	["Follow existing project patterns","Document all outputs clearly","Handle errors gracefully"]
error_handling	graceful
streaming	supported
source	builtin
trust_score	100
provenance_sha	eaa0ef4d6249ad4e

Hooks Explainer

Hooks Explainer Skill - Documents the hook enforcement system, bypass mechanisms, and common failure patterns to help agents avoid getting stuck on protected path writes - Hooks Explainer primary function - Integration with agent ecosystem - Standardized output generation

Step 1: Gather Context

Read relevant files and understand requirements

Step 2: Execute

Perform the skill's main function using available tools

Step 3: Output

Return results and save artifacts if applicable

</execution_process>

<best_practices>

1. Follow existing project patterns: Follow this practice for best results
2. Document all outputs clearly: Follow this practice for best results
3. Handle errors gracefully: Follow this practice for best results

</best_practices>

**Example Commands**:

# Invoke this skill
/hooks-explainer [arguments]

# Or run the script directly
node .claude/skills/hooks-explainer/scripts/main.cjs --help

</usage_example>

Search Protocol

For code discovery and search tasks, follow this priority order:

1. `pnpm search:code ""` (Primary intent-based search).
2. `ripgrep` (for exact keyword/regex matches).
3. semantic/structural search via code tools if available.

Memory Protocol (MANDATORY)

Before starting: ```bash cat .claude/context/memory/learnings.md cat .claude/context/memory/decisions.md ```

After completing:

• New pattern -> `.claude/context/memory/learnings.md`
• Issue found -> `.claude/context/memory/issues.md`
• Decision made -> `.claude/context/memory/decisions.md`

ASSUME INTERRUPTION: Your context may reset. If it's not in memory, it didn't happen.