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
- Fix Issue — by metabase - Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing sol 46.5k ★
- Debug — You are tasked with helping debug issues during manual testing or implementation 10k ★
- 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
Systematic Debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes - four-phase frame
St Debug
Hypothesis-driven debugging with observation-only instrumentation and user reproduction; fixes route through t
Logic Locate
Locate the root cause of a confirmed failure — use when you have a stack trace, failing test, or wrong output
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
Diagnose And PR
Reads a firing failure signal (an alert, a failed check, a monitoring finding), diagnoses the root cause again