Debug

SkillAI & models

Once added, your AI can work through bugs methodically instead of guessing at fixes. It reproduces the bug with a failing test, analyzes the code to find the root cause, and applies a minimal fix.

Available today. Use it from your connected AI after setup.

Add the skill and describe the bug you want fixed. Your AI will start by writing a failing test that reproduces the problem, then diagnose the cause and apply a minimal fix.

Then ask your AI: use the Debug skill

What your AI can do with it

  • Reproduce a reported bug with a failing test
  • Analyze the code to pinpoint the root cause
  • Implement a minimal fix once the cause is known
  • Follow the same reproduce, diagnose, fix workflow from start to finish

What this skill tells your AI

The instructions your AI receives, as published by cyrusagents/cyrus in skills/debug/SKILL.md and read by ahel’s review.

Debug a reported issue using a structured reproduction-then-fix approach.

Phase 1: Reproduction & Root Cause Analysis

  1. Investigate — Analyze the bug report for key symptoms and error messages
  2. Trace — Search the codebase for error occurrence patterns, trace from symptom to source
  3. Root cause — Identify the root cause through data flow analysis and edge case checking
  4. Reproduce — Create a minimal failing test case that reproduces the exact error
  5. Document — Clearly document the root cause and reproduction steps

Phase 2: Fix Implementation

  1. Plan — Analyze the optimal fix approach based on root cause, check for similar fixes in the codebase
  2. Implement — Make the minimal, targeted fix that addresses the root cause
  3. Verify — Run the failing test to confirm it passes, then run the full test suite to check for regressions

Principles

  • Minimal changes — Fix the bug, nothing more
  • Targeted — Only touch affected code paths
  • Tested — The fix must make the failing test pass and not break existing tests
  • No unrelated improvements — Stay focused on the specific bug

Signals

GitHub stars
807
Forks
165
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
debug-cyrusagents
Source
github.com/cyrusagents/cyrus