How do I persist environment variables across a session?

You can use the SessionStart hook to append export commands to the $CLAUDE_ENV_FILE, which ensures those variables remain available throughout the entire session.

How do I ensure my hook scripts are portable?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable in your hook commands to reference scripts or assets located within your plugin directory.

What are prompt-based hooks in Claude Code?

Prompt-based hooks use LLM-driven reasoning to evaluate actions like tool use or stopping, allowing for flexible, natural language decisions instead of static bash scripts.

What is the difference between the Stop and SubagentStop hooks?

The Stop hook triggers when the main agent intends to finish its task, while the SubagentStop hook applies specifically to the lifecycle of sub-agents created by Claude.

Can I run multiple hooks for the same event?

Yes, Claude Code runs all matching hooks in parallel. They execute independently, meaning they do not see each other's output and have non-deterministic ordering.

Hook Development for Claude Code

Name: Hook Development for Claude Code
Author: C0ntr0lledCha0s

byC0ntr0lledCha0s

•

개발자 도구

Implements event-driven automations and tool validation hooks to customize and secure AI development workflows.

This skill provides comprehensive guidance and implementation patterns for Claude Code plugin hooks, enabling developers to build sophisticated, event-driven automations. It covers both prompt-based hooks for context-aware reasoning and command hooks for deterministic bash-scripting checks. By leveraging events like PreToolUse and SessionStart, users can enforce security policies, validate tool outputs, automate project context loading, and create a safer, more efficient development environment tailored to specific project needs.

주요 기능

01Regex-Based Tool Matching for granular control over hook execution

022 GitHub stars

03Environment Variable Persistence via $CLAUDE_ENV_FILE for session management

04Advanced Prompt-Based Hooks for context-aware reasoning and validation

05Deterministic Command Hooks for high-performance bash-driven checks

06Comprehensive Event Support including PreToolUse, PostToolUse, and SessionStart

사용 사례

01Preventing dangerous shell commands or sensitive file access using PreToolUse validation

02Automatically loading project-specific environment variables and context at SessionStart

03Ensuring task completeness and code quality by blocking Stop events until tests pass

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add c0ntr0lledcha0s/claude-code-plugin-automations hook-development

For use in Claude.ai and ChatGPT

Download Skill