Hook

Hook Creation Skill

Creates Claude Code hook scaffolds following a standardized pattern. Run hook in any directory to generate a complete hook project.

Quick Start

# Install globally
bun add -g git+ssh://git@github.com/example/hook.git

# Create a hook (interactive)
hook

# Or with a name directly
hook my-hook

What Gets Created

Running hook creates:

hook-/
├── src/
│   ├── index.ts              # CLI entry point
│   ├── commands/
│   │   ├── run.ts            # Main hook logic
│   │   ├── setup.ts          # Setup command
│   │   ├── test.ts           # Manual testing
│   │   └── config.ts         # Configuration management
│   ├── core/
│   │   └── .ts         # Hook-specific logic (implement here)
│   └── utils/
│       ├── logger.ts         # Configurable logging
│       └── claude.ts         # Claude config helpers
├── hook.config.json          # Self-describing metadata
├── package.json
├── tsconfig.json
├── bunfig.toml
├── README.md
└── HOOK.md

Usage

hook [name] [options]

Options:
  --event      PreToolUse, PostToolUse, or Stop (default: PreToolUse)
  --matcher    Tool matcher: Bash, Write, Edit, * (default: *)
  --output       Output directory (default: current)
  --help              Show help

Hook Events

| Event | When | Can Block | |-------|------|-----------| | PreToolUse | Before tool executes | Yes | | PostToolUse | After tool executes | No | | Stop | When agent stops | No |

After Creating

1. cd hook-
2. bun install
3. Edit src/core/.ts - implement your logic
4. Test: bun run src/index.ts test
5. Push to GitHub
6. Install: bun add -g git+ssh://git@github.com/example/hook-.git
7. Setup: hook- setup

Hook Output Format

{ "decision": "allow" }                           // Allow operation
{ "decision": "block", "reason": "Why blocked" }  // Block (PreToolUse only)
{ "decision": "error", "message": "Error msg" }   // Error occurred

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hasna
• Source: hasna/skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.