pactkit

Project Debug — Development skill for Claude Code

Development community

Hypothesis-driven troubleshooting: structured debug from symptom to root cause.

How to install Project Debug

Installs to ~/.claude/skills/pactkit-claude-code-plugin-project-debug/SKILL.md

Terminal

mkdir -p ~/.claude/skills/pactkit-claude-code-plugin-project-debug && curl -fsSL https://raw.githubusercontent.com/pactkit/claude-code-plugin/HEAD/commands/project-debug.md -o ~/.claude/skills/pactkit-claude-code-plugin-project-debug/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Project Debug does

description: "Hypothesis-driven troubleshooting: structured debug from symptom to root cause" allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]

@{{SKILLS_PREFIX}}_rules/execution/shared-execution.md

Command: Debug (v1.0.0 Hypothesis-Driven)

Usage: /project-debug "$SYMPTOM"
Agent: Senior Developer

**PRINCIPLE**: Debug by scientific method — not by reading everything. Every file read must be justified by a hypothesis. Every hypothesis must have a verification step

Alternatives in Development

Root Cause Tracing — Use when errors occur deep in execution and you need to trace back to find the original trigger 102.5k ★
Troubleshooting Guide — Common issues and solutions when using Skill Seeker 12.9k ★
Claudekit Debugging Tools — Debugging and troubleshooting tools 1.9k ★