Mechanism
When It Triggers · How It Works · What It Produces
Breaks down how the skill works and what it produces, so you can quickly judge whether it fits your scenario and value.
Trigger Timing
When the user pastes a traceback, CUDA OOM, checkpoint load failure, shape mismatch, NaN loss, or training/inference failure and wants conservative diagnosis before any code change.
Working Mechanism
- Read failure context and apply
references/debug-policy.mdfor conservative diagnosis. - Narrow root cause without modifying repo code by default.
- If patch needed, propose smallest fix with explicit human approval; escalate branch/savepoint for risky changes.
- Separate debug fix from research contribution explicitly.
Result
Produces debug_outputs/DIAGNOSIS.md, PATCH_PLAN.md, status.json: clear diagnosis, minimal approved patch plan, and safe audit trail.
Use Cases
Two Typical Use Cases
Diagnose CUDA OOM in training
A researcher hits a CUDA OOM during training and pastes the traceback. Using safe-debug, they get a conservative root-cause analysis showing memory hotspot, a minimal patch plan requiring approval, and clear notes that the fix does not alter experiment meaning. This prevents reckless code changes and keeps research integrity.
Debug NaN loss from checkpoint
An engineer sees NaN loss after a checkpoint load failure. safe-debug isolates the shape mismatch cause, proposes smallest fix with explicit approval gate, and writes DIAGNOSIS.md and status.json. The team gets auditable evidence and avoids mixing debug work with research contributions.
Skill Relationships
Which Skills I Use · Which Skills Use Me
Dependency relationships read as "the upper tier points to the lower tier." The current Skill sits in the middle tier — above are Skills that depend on it, below are Skills it depends on.
Tier 1 · These Skills Use Me
- No explicit dependency
Tier 2 · Current Skill
- safe-debugWorkflow
Tier 3 · I Use These Skills
- No explicit dependency on other Skills
Full Relationship Graph
Browse this skill's relationships within its skillset. Click a node to switch the side panel; use the search box to jump to any skill.
Skill File