hook-audit

Analyze Claude Code hook performance metrics and detect silent or over-aggressive hooks.

34|4|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/redpanda-data/ui-harness --skill hook-audit-redpanda-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hook-audit
Source: https://github.com/redpanda-data/ui-harness/tree/main/hook-audit
Command: npx skills add https://github.com/redpanda-data/ui-harness --skill hook-audit-redpanda-data

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users identify and analyze the effectiveness of hooks in Claude Code sessions, ensuring that hooks are neither silent nor over-aggressive, and that the session workflow is efficient and secure.

Core Features & Use Cases

  • Hook Analysis: Evaluate the performance of hooks across all session metrics.
  • Silent Hooks Identification: Detect hooks that never trigger or are not wired to logging.
  • Over-aggressive Hooks Identification: Identify hooks with high block counts that may hinder productivity.
  • Enforcement Gaps Analysis: Cross-reference Claude Code rules with hook activity to identify gaps.
  • Recommendations: Provide actionable recommendations for pruning, softening, hardening, or adding hooks.
  • Retro Analytics: Analyze broader session flow, including PR lag, CI pass rate, phase skipping, review round distribution, and human-review resolution latency.

Quick Start

Run the hook-audit skill to generate a report on the effectiveness of hooks in your Claude Code sessions.

Frequently Asked Questions about hook-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit hook effectiveness in Claude Code sessions?

To audit hook effectiveness in Claude Code sessions, you can run this skill to analyze performance metrics, detect silent or over-aggressive hooks, identify enforcement gaps, and generate actionable tuning recommendations.

Why do some Claude Code hooks never trigger during a session?

Claude Code hooks may never trigger if they are silent or not properly wired to logging. This skill analyzes session data to identify these silent hooks and recommends wiring them correctly to ensure proper workflow enforcement.

What is the best way to identify over-aggressive hooks blocking Claude Code workflows?

The best way to identify over-aggressive hooks is by analyzing session metrics for high block counts. This skill detects hooks that hinder productivity and provides recommendations to soften their enforcement rules.

How do I find enforcement gaps between Claude Code rules and hook activity?

To find enforcement gaps, you cross-reference Claude Code rules with actual hook activity. This skill automates that cross-reference process to identify missing rules and recommends adding or hardening specific hooks.

Can I analyze Claude Code session workflow metrics like CI pass rate and PR lag?

Yes, you can analyze broader Claude Code session workflow metrics including PR lag, CI pass rate, phase skipping, review round distribution, and human-review resolution latency using this skill's retro analytics capabilities.

Do I need specific session data to perform a hook analysis?

Yes, performing a hook analysis requires access to Claude Code session data and hook scripts. This data allows the skill to evaluate performance metrics and generate accurate optimization recommendations.