Skip to main content
skill CX Codex

gjalla-debug — Claude Code skill: what it does, how to install

gjalla-debug — a skill that guides agents to find the root cause of a bug with evidence before proposing a fix. Works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.

no license 357 installs ★ 3 updated 2026-09-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add gjalla/engineering --skill gjalla-debug -a claude-code
Open on GitHub

What gjalla-debug does

gjalla-debug trains the agent to run an investigation: record the exact symptom, reproduce the problem or state why it could not be reproduced, confirm the code is current, pull context from repo rules and change history, locate the root instead of the first observable consequence. After diagnosis, the skill requires counting how many places in the codebase contain the same defect and writing a test that currently fails and will pass after the fix.

The output is a structured report: symptom, mechanism with file and line, why the broken state was reachable, blast radius (list of locations and count), confidence level (what was verified directly, what was inferred), proposed fix with test. If the fix touches system primitives, the skill stops and hands off to gjalla-spec.

The skill forbids forming a theory before gathering data. Without reproduction, it switches to logs, telemetry and database state but marks the diagnosis as less certain.

What it helps with

  • locate the root cause instead of the first visible consequence
  • reproduce the issue or state why reproduction failed
  • count how many locations in the repo contain the same defect
  • write a test that currently fails and passes after the fix
  • pull context from repo rules and change history

Example prompts for the agent

  • Diagnose why the second save in a session returns outdated data
  • Reproduce the error from the ticket and explain the mechanism
  • Count how many places we call this method without the guard that caused the bug

How to install gjalla-debug

1Skills CLI (Vercel)

npx skills add gjalla/engineering --skill gjalla-debug -a claude-code

2Manually: put the files in place

~/.claude/skills/gjalla-debug/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gjalla-debug/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about gjalla-debug

How to install gjalla-debug in Claude Code?

Run npx skills add gjalla/engineering --skill gjalla-debug -a claude-code, then check the file at ~/.claude/skills/gjalla-debug/SKILL.md.

What does gjalla-debug do?

It trains the agent to locate the root cause with evidence: reproduce, gather context, find all similar locations in the code, write a test and a structured report.

Why does gjalla-debug write the test before the fix?

A test that currently fails and passes after the fix proves the real cause was found, not a similar one. If the proposed fix does not change the test result, the cause is wrong.

Similar skills

All skills for Testing and QA →
08-debug AI-Driven Dev 08-debug — a bug-fixing skill with three routes: reproduce a known failure and patch it with a test, chase an unknown cause through hypotheses, or reopen a stalled hunt. CX Codex +1 ★ 571repo stars error-diagnostics-smart-debug sickn33 The error-diagnostics-smart-debug skill investigates failures through reproduction steps, traces, logs, and code, then guides hypothesis testing and scoped fix validation. CX Codex +1 1installs debug-like-expert Lex Christopherson debug-like-expert activates a structured debugging protocol for complex issues when standard troubleshooting fails. Gathers evidence, tests hypotheses, and finds root causes instead of applying quick fixes. CX Codex +1 ★ 1,988repo stars debug-agent parcadei debug-agent — a subagent that investigates root causes by exploring the codebase, analyzing logs, finding patterns, and writing a detailed report with fix recommendations. CX Codex ★ 3,951repo stars systematic-debugging Jesse Vincent systematic-debugging is a Claude Code and Codex skill that blocks fixes until root cause analysis is complete. It activates on test failures, bugs, or unexpected behavior. CX Codex +1 306,118installs agent-browser vercel-labs This Claude Code skill automates browser interaction for tasks like navigating sites, filling forms, and testing web apps. It also supports exploratory QA and Electron app automation. CX Codex +1 1,600,000installs improve-codebase-architecture Matt Pocock The improve-codebase-architecture skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. CX Codex +1 1,163,035installs tdd Matt Pocock Guides the red-green TDD loop: ensures tests are written first, keep them at public interfaces, and avoid coupling to implementation details. CX Codex +1 1,141,062installs

From the same set10

The whole set →
gjalla-test-audit gjalla-test-audit audits test suites to uncover false confidence, over-mocked logic, and assertions that conceal code regressions. Helpful when hardening test suites before major updates. CX Codex +1 888installs gjalla-code-review gjalla-code-review reviews PRs and diffs before merge from the perspective of an architect, security analyst, and QA engineer. Groups findings by severity. CX Codex +1 865installs gjalla-breakdown The gjalla-breakdown skill turns a finished feature spec into dependency-ordered work waves and small tasks. Use it before implementation when progress needs a clear structure. CX Codex +1 863installs gjalla-prepare-and-commit gjalla-prepare-and-commit prepares staged code for clean commits by verifying tests and splitting mixed diffs. It formats change reports for human review. CX Codex +1 863installs gjalla-spec gjalla-spec is a Claude Code skill that makes AI coding agents write technical specifications, threat models, and tests before code for nontrivial changes. CX Codex +1 862installs gjalla-cleanup-audit gjalla-cleanup-audit audits repositories for abandoned code, duplicated routines, and inaccurate docs. It verifies all callers first to keep removals from breaking production. CX Codex +1 358installs gjalla-onboard gjalla-onboard configures Gjalla telemetry, registers agent hooks and MCP, and ties recent coding sessions to git commits. CX Codex +1 107installs gjalla The gjalla MCP server connects Claude Code and other coding agents to shared project memory across sessions. CX Codex +1 ★ 3repo stars

Project sponsors

Companies that keep this analytics open