Claude Hooks & Commands

A personal collection of Claude Code hooks and slash commands.

Quick install via Claude Code

You can ask Claude Code to read this repo, explain what's available, and let you pick what to install. Just open Claude Code and say:

"Read https://github.com/RobinHamers/claude_hooks, explain what hooks, skills, and commands are available and what each one does, then ask me which ones I want to install before doing anything."

Claude will summarize everything in plain language, ask for your confirmation on each item (or as a whole), then clone the repo, symlink commands, register selected hooks in settings.json, and install any skill dependencies — only for what you chose.

Setup (single machine)

Everything lives in this repo. ~/.claude/ just links/references here — no duplication.

git clone git@github.com:RobinHamers/claude_hooks.git ~/claude_hooks

# Symlink commands directory
rm -rf ~/.claude/commands
ln -s ~/claude_hooks/Commands ~/.claude/commands

# Make hooks executable
chmod +x ~/claude_hooks/.claude/hooks/*.sh

Then update ~/.claude/settings.json to reference the hooks (see settings template below).

Hooks

Hook scripts live in .claude/hooks/. They are registered in ~/.claude/settings.json using absolute paths to this repo.

`check-claudeignore` — Block file access via `.claudeignore`

Event: PreToolUse — Read | Edit | Grep

Prevents Claude from reading, editing, or searching files that match patterns in a .claudeignore file at your project root. Syntax is similar to .gitignore.

# .claudeignore example
.env
secrets.json
*.pem
private/*

Example error:

Blocked: '/project/.env' matches '*.env' in .claudeignore

`block-force-push` — Block `git push --force`

Event: PreToolUse — Bash

Intercepts any bash command containing git push --force or git push -f and blocks it. Claude must be explicitly told to force push for it to proceed.

Example error:

Blocked: 'git push --force' detected. Confirm explicitly if you want to force push.

`notify-on-stop` — Desktop notification when Claude finishes

Event: Stop

Sends a desktop notification via notify-send when Claude finishes a task. Useful when running long operations in the background. Also includes a one-line buddy status if a companion is active (see below).

Requires notify-send (pre-installed on most Linux desktops). Silent no-op if not available.

`buddy-track` — Feed your companion on every tool call

Event: PostToolUse (all tools, async)

Silently updates your companion's bite count after every tool call. Runs in the background — never blocks Claude. Each tool type is worth a different number of bites:

Tool	Bites
Agent	4
Edit / Write	3
Bash	2
Read / Grep / Glob / other	1

State is persisted to ~/.claude/buddy_state.json.

Commands

Command files live in Commands/ as .md files. ~/.claude/commands/ is a symlink to this directory, so all commands are available immediately after cloning.

Invoke any command with /command-name in Claude Code.

`/pull-all`

Scans all git repos under ~/ (up to 2 levels deep), pulls the latest changes on each, and reports what updated, what was already up to date, and what failed (e.g. local conflicts).

`/commit-all`

Scans all git repos under ~/ for uncommitted changes, shows a diff summary for each, and asks interactively whether to commit and push. Never commits without your confirmation.

`/review-changes`

Read-only version of commit-all. Shows a human-readable diff summary across all repos — useful for a daily review of what changed. No staging or committing.

`/gcp-status`

Shows the current GCP/Vertex AI status for your active project: running/pending custom jobs, recent batch prediction jobs, and billing account. Tries europe-west1 first, falls back to us-central1.

Requires gcloud authenticated (gcloud auth login).

`/explore-dataset`

Given a file path, runs a quick EDA and prints a structured summary. Supports:

Format	Library
`.csv`, `.parquet`	pandas
`.geojson`, `.gpkg`	geopandas
`.tif`, `.tiff`	rasterio

Reports shape, dtypes, nulls, value ranges, CRS (for geo files), and flags anomalies like high null rates or suspicious ranges.

`/lint-fix`

Runs linting and auto-formatting on Python files in the current repo. Targets only files changed since last commit (or all .py files if nothing is staged). Prefers ruff; falls back to black + isort.

Install ruff if missing: pip install ruff

`/requirements-audit`

Scans all requirements*.txt files under ~/ and reports:

Unpinned packages (no ==)
Loosely pinned packages (>=, ~=)
Imports in Python files with no matching requirement

Focuses on common ML/geo packages: torch, numpy, pandas, geopandas, rasterio, transformers.

`/buddy` — Your Claude Code companion

Displays your companion: ASCII art, evolution stage, mood, lifetime bites, and session stats.

╔══════════════════════════════════════════╗
║  ✨ SHINY ✨                              ║
║  Tofu the Hamster                        ║
╠══════════════════════════════════════════╣
║                                          ║
║    🐹  (◕ᴗ◕)   ← Hamster                 ║
║                                          ║
╠══════════════════════════════════════════╣
║  Mood    Excited  (ﾉ◕ヮ◕)ﾉ                ║
║  Bites   14,203 / 100,000                ║
║  [████████░░░░░░░░░░] 14%                ║
║  Session 47 bites · 23 tool calls        ║
║  Born    2026-04-09                      ║
╚══════════════════════════════════════════╝

Your companion is randomly hatched — name, animal, and rarity are all determined at birth. You don't choose.

Rarity	Chance	Visual
Common	60%	Plain ASCII
Uncommon	25%	Cyan tint
Rare	10%	Bold yellow + ★ badge
Shiny	4%	Gold color + ✨ badge
Ultra Rare	1%	Rainbow colors + 💎 badge

Animals: cat, dog, dragon, frog, bird, bunny, hamster, fox, axolotl, capybara (random at birth)

Evolution — 5 stages based on lifetime bites:

Stage	Bites needed
Egg	0
Stage 2 (hatchling/pup/whelp/...)	1,000
Stage 3 (kitten/doggo/drake/...)	10,000
Stage 4 (adult)	100,000
Stage 5 (legend)	1,000,000

Moods — change automatically based on session activity:

Mood	Trigger
Happy	Default
Excited	Bash/Edit-heavy session
Focused	Read/Grep-heavy session
Hungry	No tool calls for 15+ min
Tired	Session running 2+ hours
Alert	A hook blocked something

Extra commands:

/buddy reset — hatch a new companion (the old one is gone forever — good luck with rarity)
The companion also shows compactly in the Claude Code statusline and in Stop notifications

Engine: Scripts/buddy.py — all state in ~/.claude/buddy_state.json

Skills

Skill files live in Skills/ as .skill files (ZIP archives containing SKILL.md and optional scripts). Install via the Claude Code plugin system.

`morning-email-briefing`

Fetches all new emails from the last 24 hours via Microsoft 365 (Outlook), summarizes each one, drafts a copy-paste-ready reply in a formal-yet-friendly style, and saves everything as a structured Notion page.

Trigger phrases: "morning briefing", "check my emails", "email summary", "daily email digest", "what's in my inbox?"

Output: A Notion page titled 📬 Email Briefing — [Date] with urgent/normal sections, 2-line summaries, and draft replies per email. Confirms in chat with a stat line.

Requires: Microsoft 365 (Outlook) and Notion connectors enabled in Claude.ai.

`extent-to-polygon`

Converts a bounding box extent (xmin, ymin, xmax, ymax) with a source EPSG code into a WKT POLYGON((...)) string, with optional reprojection to another CRS.

Trigger phrases: "extent to polygon", "bbox to WKT", "convert extent", "reproject bounding box", any 4 coordinates + EPSG + polygon/WKT request.

Usage:

python Skills/extent-to-polygon/scripts/extent_to_polygon.py \
  --extent <xmin> <ymin> <xmax> <ymax> \
  --source-epsg <code> \
  [--target-epsg <code>] \
  [--output <filepath>]

Requires: pip install pyproj

`context-hub`

Fetches curated, versioned API documentation via the chub CLI before writing code against any external library or SDK. Prevents hallucinated method names and stale API assumptions.

Trigger phrases: "use context-hub", "check the docs for", "fetch docs", any request to write code using an external library/API, or any time API correctness is uncertain.

Workflow:

# 1. Search for the doc
chub search <library>

# 2. Fetch it
chub get <id> --lang py   # or --lang js

# 3. Annotate gaps found
chub annotate <id> "<note>"

# 4. Rate quality
chub feedback <id> up|down

Requires: npm install -g @aisuite/chub (or npm install -g @aisuite/chub --prefix ~/.npm-global if no global npm write access)

`trigger-dag`

Triggers a DAG run on a Google Cloud Composer Airflow instance via the Airflow REST API. Auth is handled via gcloud auth print-access-token — no extra credentials needed beyond an active gcloud session.

Trigger phrases: "trigger dag", "run dag", "start dag", "fire dag", "kick off <dag-name>", "run this dag with this config", or any message providing a DAG name + JSON configuration.

Setup: Copy .env.example to .env inside the skill directory and set AIRFLOW_URI to your Composer instance URL.

Usage:

python Skills/trigger-dag/scripts/trigger_dag.py \
  --dag-id <dag-name> \
  --conf '{"key": "value"}'

# or pass a JSON file
python Skills/trigger-dag/scripts/trigger_dag.py \
  --dag-id <dag-name> \
  --conf-file /path/to/config.json

Requires: pip install requests python-dotenv, gcloud authenticated.

`caveman`

Switches Claude to terse, no-filler communication mode for the session. Eliminates preamble, postamble, meta-commentary, and tool-call announcements. Useful when you want fast, signal-only responses.

Trigger phrases: "caveman mode", "be concise", "stop being verbose", "less filler", "terse mode".

Settings template

~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Read|Edit|Grep",
        "hooks": [
          {
            "type": "command",
            "command": "/home/YOUR_USERNAME/claude_hooks/.claude/hooks/check-claudeignore.sh"
          }
        ]
      },
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "/home/YOUR_USERNAME/claude_hooks/.claude/hooks/block-force-push.sh"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/home/YOUR_USERNAME/claude_hooks/.claude/hooks/buddy-track.sh",
            "async": true
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/home/YOUR_USERNAME/claude_hooks/.claude/hooks/notify-on-stop.sh"
          }
        ]
      }
    ]
  },
  "statusLine": {
    "type": "command",
    "command": "python3 /home/YOUR_USERNAME/claude_hooks/Scripts/buddy.py status",
    "refreshInterval": 30
  },
  "permissions": {
    "allow": [
      "Bash(python3 /home/YOUR_USERNAME/claude_hooks/Scripts/buddy.py:*)"
    ]
  }
}

Requirements

Claude Code
bash
python3 (used in hook scripts for JSON parsing, and for /buddy)
git
gcloud — for /gcp-status
ruff or black — for /lint-fix
pandas, geopandas, rasterio — for /explore-dataset
notify-send — for notify-on-stop hook (optional)
npm + @aisuite/chub — for context-hub skill (npm install -g @aisuite/chub)
requests, python-dotenv — for trigger-dag skill (pip install requests python-dotenv)

Name		Name	Last commit message	Last commit date
Latest commit History 12 Commits
.claude		.claude
Commands		Commands
Scripts		Scripts
Skills		Skills
.claudeignore.example		.claudeignore.example
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Claude Hooks & Commands

Quick install via Claude Code

Setup (single machine)

Hooks

`check-claudeignore` — Block file access via `.claudeignore`

`block-force-push` — Block `git push --force`

`notify-on-stop` — Desktop notification when Claude finishes

`buddy-track` — Feed your companion on every tool call

Commands

`/pull-all`

`/commit-all`

`/review-changes`

`/gcp-status`

`/explore-dataset`

`/lint-fix`

`/requirements-audit`

`/buddy` — Your Claude Code companion

Skills

`morning-email-briefing`

`extent-to-polygon`

`context-hub`

`trigger-dag`

`caveman`

Settings template

Requirements

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Claude Hooks & Commands

Quick install via Claude Code

Setup (single machine)

Hooks

check-claudeignore — Block file access via .claudeignore

block-force-push — Block git push --force

notify-on-stop — Desktop notification when Claude finishes

buddy-track — Feed your companion on every tool call

Commands

/pull-all

/commit-all

/review-changes

/gcp-status

/explore-dataset

/lint-fix

/requirements-audit

/buddy — Your Claude Code companion

Skills

morning-email-briefing

extent-to-polygon

context-hub

trigger-dag

caveman

Settings template

Requirements

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`check-claudeignore` — Block file access via `.claudeignore`

`block-force-push` — Block `git push --force`

`notify-on-stop` — Desktop notification when Claude finishes

`buddy-track` — Feed your companion on every tool call

`/pull-all`

`/commit-all`

`/review-changes`

`/gcp-status`

`/explore-dataset`

`/lint-fix`

`/requirements-audit`

`/buddy` — Your Claude Code companion

`morning-email-briefing`

`extent-to-polygon`

`context-hub`

`trigger-dag`

`caveman`

Packages