Can I use TypeScript to write hooks?

Yes, the recommended pattern uses a shell wrapper to execute a TypeScript handler via npx tsx, providing full access to the TypeScript ecosystem.

What events can I trigger hooks on?

Available events include PreToolUse, PostToolUse, UserPromptSubmit, PreCompact, SessionStart, and Stop.

What is a Maestro hook?

A Maestro hook is a specialized script that allows you to intercept and modify the behavior of Claude Code during specific events, such as starting a session or using a tool.

Where are these hooks registered?

Hooks are registered in the .maestro/settings.json file, where you can define the event type, optional matchers, and the command to execute.

How do I block an action in Claude Code using a hook?

By implementing a PreToolUse hook and returning a JSON object with the result set to 'block', you can prevent the agent from executing a specific tool.

Maestro Hook Development

Name: Maestro Hook Development
Author: scooter-lacroix

byscooter-lacroix

0•

開発者ツール

Standardizes the creation and management of event-driven lifecycle hooks for the Maestro framework within Claude Code.

This skill provides a structured framework for developing and implementing lifecycle hooks in Maestro, allowing users to intercept and customize Claude's behavior. By utilizing a standardized shell-to-TypeScript pattern, it enables the creation of handlers for critical events like tool execution, session starts, and prompt submissions. This is essential for developers looking to build sophisticated automation, enforce custom security policies, or maintain session continuity within their AI-driven workflows.

主な機能

01Centralized JSON registration for managing multiple hooks and matchers

020 GitHub stars

03Standardized shell-to-TypeScript execution pattern for robust hook logic

04Support for comprehensive event triggers including PreToolUse, PostToolUse, and SessionStart

05Action blocking capabilities to prevent unauthorized or unsafe tool executions

06Manual testing interface for validating hook logic via CLI

ユースケース

01Enforcing security guardrails by blocking specific tool uses based on context

02Logging or auditing agent activities after tool execution for compliance

03Automating project initialization or context loading when a new Claude session starts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add scooter-lacroix/maestro hooks

For use in Claude.ai and ChatGPT

Download Skill