Which programming languages are supported?

It provides built-in patterns for Node.js (npm) and Python (pip), but the logic can be adapted for any language that uses dependency manifests and version flags.

Can Environment Doctor fix issues automatically?

Yes, it can 'auto-heal' common problems such as missing dependencies by running npm install or pip install, and clearing stale caches like .next or __pycache__.

What is the Environment Doctor skill for Claude Code?

Environment Doctor is a skill that automates the verification and maintenance of your development environment, ensuring tool versions and dependencies match project requirements.

How does this skill prevent environment drift?

It creates a .ralph/environment.lock file that stores hashes of your dependency files and specific runtime versions, checking them before every development iteration.

What happens if a version mismatch is detected?

If the skill cannot fix the mismatch (like an incorrect Node.js version), it logs the issue to progress.txt and marks the task as blocked for human review.

Environment Doctor

Name: Environment Doctor
Author: kimhons

bykimhons

•

Deployment & DevOps

Maintains development environment integrity by automating pre-flight checks and self-healing configuration drift during autonomous coding sessions.

Environment Doctor is a specialized Claude Code skill designed to ensure a consistent and healthy development environment across every iteration of a project. It prevents AI agents from wasting time debugging infrastructure issues by implementing a robust environment lock file system that tracks runtime versions and dependency hashes. By performing automated pre-flight checks and auto-healing common issues like missing build artifacts or stale caches, this skill guarantees that Claude operates within a verified and stable workspace, escalating unfixable mismatches for human intervention only when necessary.

Key Features

011 GitHub stars

02Intelligent blocking and logging for unfixable environment mismatches

03Cross-language support for Node.js and Python ecosystems

04Automated environment pre-flight checks using .ralph/environment.lock

05Dependency drift detection using MD5 hash verification

06Auto-healing for missing dependencies and stale cache directories

Use Cases

01Preventing build failures caused by hidden version mismatches in Node or Python

02Standardizing local environment configurations across distributed development teams

03Automating the 're-install and rebuild' cycle after pulling upstream repository changes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kimhons/ralph-loop-ultra environment-doctor

For use in Claude.ai and ChatGPT

Download Skill