safe-debug

Diagnose deep-learning errors from tracebacks and symptoms into structured diagnostic files.

515|11|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/lllllllama/ai-research-workflow-skills --skill safe-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: safe-debug
Source: https://github.com/lllllllama/ai-research-workflow-skills/tree/main/skills/safe-debug
Command: npx skills add https://github.com/lllllllama/ai-research-workflow-skills --skill safe-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a safe, conservative debugging workflow for deep learning experiments, diagnosing errors and symptoms before any code patching to protect experimental integrity.

Core Features & Use Cases

  • Structured diagnostic outputs (DIAGNOSIS.md, PATCH_PLAN.md, status.json) after analyzing errors.
  • Policy-driven guidance that escalates for risky changes and requires explicit approval for patches.
  • Reproducible workflow across training and inference failures with clear savepoints and rollbacks.

Quick Start

Provide the error text or traceback to generate a conservative diagnostic package.

Frequently Asked Questions about safe-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose deep learning training failures from a traceback?

Diagnose deep learning training failures by providing the error traceback to generate a conservative diagnostic package. The system analyzes symptoms to identify root causes, outputting structured files like DIAGNOSIS.md before any code changes are applied.

Can I fix CUDA out of memory errors without automatically modifying my code?

Yes, you can resolve CUDA memory errors without automatic code modification. The debugging workflow requires no code changes by default, enforcing a patch workflow with explicit approvals and savepoints to protect experimental integrity.

What is the safest way to create a patch plan for shape mismatches in PyTorch?

The safest way to address shape mismatches is using a policy-driven patch plan that requires explicit approval before applying minimal fixes. It generates a PATCH_PLAN.md and status.json to ensure structured, reproducible rollbacks.

How do I troubleshoot checkpoint loading problems during model evaluation?

Troubleshoot checkpoint loading problems by analyzing the error traceback through a conservative diagnostic workflow. The system identifies root causes and guides minimal fixes using policy-based decisions and structured savepoints.

When should I use a conservative debug workflow for deep learning experiments?

Use a conservative debug workflow when reproducibility is critical and risky changes must be avoided. It escalates risky modifications, requires explicit patch approvals, and maintains savepoints for safe rollbacks during training or inference failures.