What is the background subshell pattern for hooks?

It involves wrapping your script commands in '( commands ) &>/dev/null &' and exiting immediately with 'exit 0' so long-running tasks continue in the background without blocking Claude.

Why do I get a 'Hook cancelled' error in Claude Code?

This error occurs when a lifecycle hook execution exceeds the default 60-second timeout limit set by Claude Code.

Does this skill help with Starship prompt warnings?

Yes, it provides specific configurations for starship.toml to increase command_timeout and optimize nodejs detection to prevent terminal lag.

Where are Claude Code hook settings stored?

Hooks are configured in .claude/settings.json, which can be located at the user level (~/.claude/settings.json) or the project root level.

How can I increase the timeout for a specific Claude hook?

You can add a 'timeout' field with a numeric value (in seconds) to your hook configuration object within the .claude/settings.json file.

Claude Code Hooks Configuration

Name: Claude Code Hooks Configuration
Author: laurigates

bylaurigates

•

Developer Tools

Optimizes Claude Code lifecycle hooks with custom timeout settings and background execution patterns to prevent session management errors.

This skill provides comprehensive guidance for configuring Claude Code's lifecycle hooks, including SessionStart, SessionEnd, and Tool hooks. It specifically addresses the common 'Hook cancelled' error by implementing robust timeout management strategies and background subshell patterns, ensuring that long-running tasks like logging, cleanup, and environment setup do not disrupt your development workflow or cause session failures.

Key Features

01Standardized JSON structures for user and project-level settings

023 GitHub stars

03Advanced timeout management to prevent 'Hook cancelled' errors

04Background subshell patterns for non-blocking asynchronous hook execution

05Comprehensive lifecycle hook configuration (SessionStart, SessionEnd, Stop, Tool hooks)

06Starship prompt timeout optimization for improved terminal responsiveness

Use Cases

01Automating session logging and cleanup without blocking the terminal interface

02Fixing shell latency issues by optimizing Starship prompt and node detection timeouts

03Running complex environment checks or dependency updates during session startup

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins claude-hooks-configuration

For use in Claude.ai and ChatGPT

Download Skill