Debugger
Skill Razaib-khan/ForgeWeave/src/forgeweave/templates/claude/.claude/skills/debugger
Behavioral execution framework for AI agents — define deterministic, portable skills & agents across OpenCode, Claude Code, Gemini CLI, and Qwen Code.
npx -y skills add Razaib-khan/ForgeWeave --skill debuggerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Systematic issue diagnosis skill that isolates root causes, tests hypotheses, and produces minimal fix strategies
SKILL.md
2.8 KB, as published. Nobody here has run it
Debugger
Purpose
Apply systematic debugging methodology to identify root causes of software issues. Uses hypothesis-driven investigation, binary search on code paths, and targeted tests to isolate the problem before proposing a fix.
When to Use
- The user reports a bug, error, or unexpected behavior
- A test is failing and the cause is not obvious
- A feature works locally but fails in production
- Performance regression needs investigation
When Not to Use
- The error message is self-explanatory — fix it directly
- The fix is already known and just needs implementation
- The task is refactoring — use
refactor-engine
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
symptom | string | Yes | The observed error or unexpected behavior |
reproduction_steps | string | No | Steps to reproduce the issue |
environment | string | No | Environment details (OS, versions, deployment) |
logs_or_stacktrace | string | No | Error output, logs, or stack trace |
Expected Outputs
| Output | Description |
|---|---|
| Root cause | Identified source of the issue |
| Fix strategy | Minimal change to fix the issue |
| Verification steps | How to confirm the fix works |
| Prevention | How to avoid similar issues |
Exact Workflow Steps
- Understand the symptom and reproduction steps
- Formulate 2-3 hypotheses for root cause
- For each hypothesis, design a diagnostic test
- Narrow down by eliminating hypotheses
- Isolate the exact root cause
- Design minimal fix that doesn't break other functionality
- Verify fix resolves the symptom
- Run existing tests to confirm no regressions
Required Checks
- Root cause is identified before any fix is proposed
- Fix is minimal (no scope creep)
- Existing tests pass after fix
- Prevention strategy is documented
Failure Modes
| Failure Condition | Response |
|---|---|
| Cannot reproduce the issue | Ask for more detailed reproduction steps |
| All hypotheses eliminated | Broaden search to adjacent systems or dependencies |
| Fix breaks other functionality | Revert and explore alternative fix strategy |
Examples
Example: "API returns 500 intermittently"
- Hypotheses: database connection pool exhaustion, unhandled exception, timeout
- Check connection pool metrics → pool is fine
- Add error logging around the failing endpoint → caught unhandled promise rejection
- Fix: wrap async handler in try/catch
References
| Reference | Path |
|---|---|
| Test Generator skill | ../test-generator/SKILL.md |