skills.rest
jamesaphoenix
jamesaphoenixCOMMUNITY
Explore all skills by this author →
Website𝕏@jamesaphoenix12GitHub

debug-hooks

Analyze Claude Code hook artifacts to diagnose failures and blocked hooks.

6|3|Updated Jan 28, 2026
Search Tags:#debugging#hooks#claude#artifacts#log-analysis#run-traces#artifact-schema
One-click install
npx skills add https://github.com/jamesaphoenix/tx --skill debug-hooks-jamesaphoenix
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug-hooks
Source: https://github.com/jamesaphoenix/tx/tree/main/.claude/skills/debug-hooks
Command: npx skills add https://github.com/jamesaphoenix/tx --skill debug-hooks-jamesaphoenix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze Claude Code hook artifacts to diagnose failures and blocked hooks. This skill centralizes visibility into hook events for debugging and operational assessment.

Core Features & Use Cases

  • Artifact exploration: list, filter, and inspect .tx/hook-artifacts/* for specific runs and hook types.
  • Schema-aware analysis: parse the artifact structure to surface decisions, outcomes, and timing.
  • Run health summaries: generate quick dashboards of success/failure patterns across runs to guide fixes.
  • Reference workflows: map findings to debugging workflows for Claude Code hooks in real projects.

Quick Start

List recent hook artifacts for a given run to begin debugging.

Frequently Asked Questions about debug-hooks

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

FAQPage Schema
How do I debug Claude Code hook failures from run artifacts?▼

You can debug blocked Claude Code hooks by analyzing run artifacts to surface decisions, outcomes, and timing. The skill parses the artifact schema to generate run health summaries and identify success or failure patterns.

What is a Claude Code hook artifact and how does it help with log analysis?▼

Claude Code hook artifacts are structured records of hook events, outcomes, and timing. Analyzing them provides centralized visibility into run histories, allowing you to filter by hook types and trace decisions across multiple executions.

How do I filter hook artifacts by specific hook types for a given run?▼

You can filter hook artifacts by listing and inspecting the .tx/hook-artifacts/ directory for specific runs and hook types. The skill applies schema-aware parsing to surface decisions, outcomes, and timing for targeted debugging.

Can I generate a health summary dashboard for Claude Code hook runs?▼

Yes, you can generate run health summaries that display success and failure patterns across multiple runs. These dashboards map findings to debugging workflows, guiding operational assessments and necessary fixes for Claude Code hooks.

How do I export structured debugging insights from Claude Code hook artifacts?▼

You export structured insights by parsing the artifact schema to summarize hook events and trace decisions. This maps the extracted findings to structured formats, enabling operational assessment and debugging workflows for Claude Code hooks.

Related Skills

Explore More Software Engineering Skills→
jamesaphoenixjamesaphoenix
6

tx-sync-data

Export, import, migrate, hydrate, and compact tx task state across SQLite and JSONL.

Community
Advanced
PayRamPayRam
155

payram-analytics

Query PayRam analytics via MCP tools for payments, user growth, and transaction summaries.

Official
Intermediate
krzemienskikrzemienski
2

observability-report

Analyze Shannon log files for session traces, health checks, and audits.

Community
Advanced
heyAyushhheyAyushh
2

pipeline-debug

Trace webhooks through serve, relay, and smash stages to diagnose delivery failures.

Community
Advanced