Environment DX Scanner

Runs a single diagnostic script to audit the current environment (container or local) for developer tools, runtimes, connectivity, and write permissions.

Usage

• •/env-dx — full scan (all sections)
• •/env-dx quick — skip network and disk checks (faster)

Workflow

Step 1: Run the scan

bash ~/.claude/skills/env-dx/scripts/scan.sh

For quick mode:

bash ~/.claude/skills/env-dx/scripts/scan.sh --quick

The script is read-only and safe to run. It creates a temp file to test write permissions and a temp uv project to test uv add, both cleaned up immediately.

Step 2: Parse output

Each line uses a status prefix:

• •[OK] — tool found / check passed
• •[MISSING] — tool not found
• •[WARN] — partial issue (old version, limited access)
• •[FAIL] — check failed (no write permission, no network)

Step 3: Present results

Summary table — one row per category (System, Container, Required Tools, Runtimes, Permissions, Network, Resources) with rollup status.

Issues — list every [MISSING], [WARN], [FAIL] item with a concrete fix command adapted to the detected OS:

• •Debian/Ubuntu: apt-get install -y <pkg>
• •Alpine: apk add <pkg>
• •RHEL/Fedora: dnf install <pkg>
• •macOS: brew install <pkg>
• •Python tools: pipx install <pkg> or uv tool install <pkg>
• •Rust tools: cargo install <pkg>
• •Node tools: pnpm add -g <pkg> or npm install -g <pkg>

Recommendations — prioritized by impact (permissions > required tools > optional tools > nice-to-haves).

Step 4: Offer follow-up

Ask if the user wants to:

1. •Install missing tools (generate a single install script for their OS)
2. •Deep-dive a specific area
3. •Save the report to a file