2
    Env Doctor

    Env Doctor

    by JustHandled Labs

    Fix the 'it works on my machine' problem before you touch the code. Diagnoses local setup failures across Node, Python, Go, and Docker: missing dependencies, broken env vars, port conflicts, stale installs, and 'why won't this run?' sludge, then hands you copy-paste bash fixes.

    Updated Jun 2026
    1 installs

    Free

    Included in download

    • Downloadable skill package
    • Works with Python, Go
    • 2 permissions declared
    • Instant install

    Sample input

    I can't get this project to start. Why won't it run? Check my local environment and find out why the server is failing.

    Sample output

    Env Doctor Findings

    1. [High] Port 3000 already in use Evidence: lsof -i :3000 Fix: kill -9 $(lsof -t -i:3000)

    2. [Medium] Missing .env variables Evidence: DATABASE_URL present in .env.example but missing in .env Fix: Add DATABASE_URL to your .env file.

    About This Skill

    What it does

    Env Doctor is a diagnostic tool designed to solve the "it works on my machine" problem. Before you waste time refactoring application code, this skill treats the project as innocent and puts the local environment on trial. It automatically detects your project type (Node, Python, Go, or Docker) and runs a comprehensive health check on runtimes, dependencies, and system configurations.

    Why use this skill

    Manually debugging environment issues is tedious. This skill automates the boring stuff: scanning for missing node_modules, identifying port conflicts, detecting missing environment variables from .env.example, and verifying if services like Postgres or Redis are actually running. Unlike a generic AI prompt, it follows a rigorous diagnostic workflow and provides prioritized, copy-pasteable bash commands to fix discovered issues instantly.

    Supported Tools

    • Runtimes: Node.js, Python, Go, Docker
    • Databases: Postgres, MySQL, Redis
    • Package Managers: npm, pip, go mod
    • System: Port analysis (lsof/Get-NetTCPConnection), file permissions, and .env validation

    Use Cases

    • Identify port conflicts on 3000/8080 and provide kill commands
    • Detect missing .env variables by comparing against .env.example
    • Verify database service status for Postgres, MySQL, and Redis
    • Fix broken dependencies or missing virtual environments automatically

    Reviews

    No reviews yet - be the first to share your experience.

    Only users who have downloaded or purchased this skill can leave a review.

    Security Scanned

    Passed automated security review

    Permissions

    Terminal / Shell
    Read Files

    File Scopes

    package.json
    requirements.txt
    go.mod
    Dockerfile
    .env
    .env.example
    **/node_modules/**

    Env Doctor needs terminal access to run version checks (`node --version`), port checks (`lsof -i :3000`), and service checks (`pg_isready`). File read access reads manifest files (package.json, requirements.txt) and .env files to validate configuration. No write, browser, network, or env var access required.

    Tags

    debugging
    devops
    node-js
    python
    docker
    environment-setup

    Works with Claude Code and Codex. Supports Node.js, Python, Go, and Docker projects. Requires common CLI tools for detected languages.

    Creator

    JustHandled Labs

    JustHandled Labs builds focused agent skills for the work nobody wants to do by hand. Each one is a single repeatable job done well: catching the security and data mistakes that quietly ship, keeping docs and tests honest, gating the commands an agent is about to run, sharpening writing, and handling the founder chores around launches, outreach, and brand setup. Not generic AI productivity. Specific workflows that are easy to run, review, and repeat. Maintained by H.J. Westerfield, with a background in communications, editing, project coordination, customer support, and practical AI systems. Tools for people who want useful automation without theatrical complexity.

    Frequently Asked Questions

    Learn More About AI Agent Skills

    More Premium Skills

    Multi-Agent Orchestration Master Library

    Transform Claude Code into a coordinated multi-agent system. Battle-tested tmux orchestration patterns, YAML task queues, event-driven communication, and parallel worker management for 8+ agents.

    $357 installs

    diagnosing-rag-failure-modes

    RAG fails quietly. It retrieves documents, returns confident-looking answers, and misses the question entirely — because the question required connecting facts across documents, reasoning about sequence, or tracing causation. This skill gives you a five-question diagnostic checklist that classifies any failing query as either RAG-safe or structurally RAG-incompatible, then maps it to the specific failure pattern and the architectural fix that resolves it.

    $105 installs

    designing-hybrid-context-layers

    Architects the right retrieval strategy for every query — teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.

    $1015 installs

    ai-automation-qa-pack

    Professional QA & UAT documentation generator for AI automation agencies and complex agent deployments.

    $59 installs

    Free