startup-hook-skill

You can automate dependency installation by creating a deterministic startup script at .claude/hooks/session-start.sh and registering it under the SessionStart hook in .claude/settings.json. This ensures dependencies are installed reliably every time.

A SessionStart hook is a workflow registered in .claude/settings.json that executes a script when a session launches. It runs deterministic, non-interactive scripts to install dependencies and configure environments before the session begins.

You can prevent race conditions by validating dependency installation and linter readiness in a simulated session. The startup hook generates idempotent scripts and provides validation steps to ensure tests run reliably.

Yes, the startup hook supports remote-friendly configuration using environment variables and standard CLI patterns. It generates deterministic, non-interactive startup workflows that install dependencies without requiring manual input.

Yes, the generated startup script must be idempotent to ensure reliable startup across projects. Running the script multiple times produces the same result without side effects, preventing duplicate installations or broken configurations.

The best way to register a startup hook is to add the hook configuration under the SessionStart workflow in .claude/settings.json, pointing to a deterministic script at .claude/hooks/session-start.sh that handles environment setup.