debugging-r-environment-and-dependencies

What This Skill Does

The debugging-r-environment-and-dependencies skill is designed to act as an expert DevOps engineer for your R workspace. Instead of focusing on the statistical or analytical content of your R scripts, this skill dives deep into the underlying machine environment to ensure your code has a stable foundation. It automatically audits your R version, installed packages, and system-level dependencies. Whether you are dealing with broken renv lockfiles, incompatible Bioconductor versions, or cryptic C++ compilation errors caused by missing OS-level headers, this skill identifies the culprit and provides actionable commands or automated fixes. It handles the nuances of package resolution, ensuring that binary and source installations align with your specific operating system (Windows, macOS, or Linux). By resolving shared object errors and library path issues, it restores your ability to execute complex workflows without environment friction.

Installation

You can install this skill directly via the OpenClaw CLI using the following command: clawhub install openclaw/skills/skills/jackkuo666/debugging-r-environment-and-dependencies

Use Cases

• Project Portability: When cloning a repository and finding that renv::restore() fails due to version mismatches or missing cache files.
• Bioinformatics Workflows: When Bioconductor versioning conflicts with your current R instance, preventing the loading of essential packages like GenomicRanges or DESeq2.
• Compilation Failures: When installing packages that require system-level development libraries (e.g., libxml2, gdal, or proj) that are not present in the system PATH.
• Corrupted Environments: When local package directories become corrupted or permissions errors prevent R from reading its own library files.

Example Prompts

1. "I am getting a 'shared object cannot be loaded' error when I try to load the tidyverse library. Can you fix my environment?"
2. "My project uses renv, but the restore command is failing because of a version conflict between my Bioconductor packages and R 4.3. Please help me align them."
3. "I'm trying to install sf, but it keeps failing with a compilation error regarding missing GEOS libraries. How do I resolve this on my Ubuntu machine?"

Tips & Limitations

• Non-Destructive: This skill prioritizes existing script integrity; it will not alter your analysis code or overwrite your data files.
• Stability First: Always ensure your project utilizes renv to prevent the recurrence of these issues; this skill is optimized to help you set up or repair renv configurations.
• System Access: On some operating systems, the skill may suggest running terminal-level installation commands (like apt-get or brew) if it lacks the administrative permissions to install system packages directly.
• Environment Scope: It is intended for R-specific environments; while it manages system-level dependencies, it does not manage unrelated environment variables outside of the context of R or its build tools.