debugging

Diagnose and fix errors in R scripts, Typst compilations, and pipeline executions.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/shusuke-ioku/r2 --skill debugging-shusuke-ioku
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging
Source: https://github.com/shusuke-ioku/r2/tree/main/src/r2/template/.claude/skills/debugging
Command: npx skills add https://github.com/shusuke-ioku/r2 --skill debugging-shusuke-ioku

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when an R script throws an error or warning, a Typst compilation fails, regression outputs look wrong (sign flips, NA coefficients, implausible magnitudes), the pipeline runner exits non-zero, or the user reports that "something broke" or "results look off." Also use when you encounter an error during any other skill's workflow and need a systematic fix.

Core Features & Use Cases

  • Systematic root-cause debugging workflow for data analysis pipelines and document-assembly workflows.
  • Reproduce, isolate, and verify fixes with minimal edits, avoiding shotgun approaches.
  • Real-world scenarios include debugging R scripts, Typst compilation errors, and inconsistent regression outputs.

Quick Start

Describe the error you see, reproduce it locally, then apply a minimal, hypothesis-driven fix and verify results.

Frequently Asked Questions about debugging

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

FAQPage Schema
How do I troubleshoot an R script that throws non-zero exit codes or NA coefficients?

Troubleshoot R script errors by reproducing the failure locally, isolating the root cause through a hypothesis-driven approach, applying minimal edits to fix the issue, and verifying the results for reproducibility.

What is the best way to diagnose Typst compilation errors and pipeline execution failures?

Diagnose Typst compilation errors by systematically reproducing the warning or failure, forming a hypothesis about the root cause, and verifying a minimal fix to ensure the document assembly pipeline executes successfully.

How do I fix inconsistent regression outputs like sign flips and implausible magnitudes in my analysis?

Fix inconsistent regression outputs by systematically debugging the analysis pipeline, isolating the specific data or script section causing the anomaly, and verifying the corrected results with minimal edits.

Can I use a systematic debugging approach for both R scripts and Typst compilations?

Yes, you can use a systematic debugging approach for both R scripts and Typst compilations, applying a structured workflow to reproduce symptoms, isolate root causes, and verify fixes across data and document assembly pipelines.

Why should I use a hypothesis-driven approach instead of making broad changes to fix R errors?

A hypothesis-driven approach avoids shotgun debugging by isolating the exact root cause of R errors, ensuring minimal edits are made to reproduce, diagnose, and verify fixes while maintaining pipeline reproducibility.

What should I do when my data analysis pipeline runner exits non-zero and results look off?

When your data analysis pipeline exits non-zero or results look off, reproduce the error locally, apply a minimal hypothesis-driven fix to diagnose the root cause, and verify the corrected pipeline execution.