Al Debug — Testing skill for Claude Code
Root-cause a bug/test failure/race condition before fixing; checks and maintains a project-local known-issues log.
How to install Al Debug
Installs to ~/.claude/skills/al-af-al-skills-al-debug/SKILL.md
mkdir -p ~/.claude/skills/al-af-al-skills-al-debug && curl -fsSL https://raw.githubusercontent.com/al-af/al-skills/HEAD/commands/al-debug.md -o ~/.claude/skills/al-af-al-skills-al-debug/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Al Debug does
description: Root-cause a bug/test failure/race condition before fixing; checks and maintains a project-local known-issues log
Before investigating, read (or create) `docs/known-issues.md` in the project root and check for a matching prior case — cite and use it as a first hypothesis if found (verify it still applies), otherwise proceed fresh. Root-cause via four phases, narrating hypothesis and evidence at each step: (1) read the full error, reproduce reliably, check recent changes, tr
Alternatives in Testing
- Debug — You are tasked with helping debug issues during manual testing or implementation 10k ★
- L Debug Trace — Analytically debug issues by tracing data flow through code - no logs, no test-and-see 3k ★
- Skill Debug — Debug issues methodically — use when stuck on errors, test failures, or unexpected behavior 2.8k ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Hatch3r Bug Pipeline
Run a known-cause bug fix through a 3-phase test-first pipeline -- reproduce + root-cause, regression-test + f
J Debug
Systematic bug investigation — root cause analysis, not random fixes. Use when a test fails, a bug appears, or
Debugging
Debug a bug, crash, failing test, or broken build to root cause
Quick Debug
Structured bug investigation — reproduce, root-cause, fix, regression-test. Uses the debugger subagent for iso
Systematic Debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes - four-phase frame
Bughunt Skill
Agent skill that plays your app or game like real users (seeded personas), checks invariants every step, and t
Related Agents
Debug Detective
Root-cause analysis of a specific failure, crash, stack trace or wrong output. Use when diagnosing a bug.
Alfresco Debugger Agent
Given an Alfresco stack trace or log snippet, searches documentation and known issues to diagnose the root cau
Quick Debugger
Finds and fixes a localized bug with a clear symptom — locates the root cause, applies a minimal fix, runs the