Agent-Skills.md

Agent Skills: Environment DX Scanner

Scan the current environment for developer experience readiness — tools, runtimes, permissions, network, and container config. Use when entering a container, checking what's installed, auditing dev tools, or diagnosing missing dependencies.

UncategorizedID: htlin222/dotfiles/env-dx

Repository

htlin222/dotfiles
htlin222License: MIT
764

Install this agent skill to your local

pnpm dlx add-skill https://github.com/htlin222/dotfiles/tree/HEAD/claude.symlink/skills/env-dx

Skill Files

Browse the full folder contents for env-dx.

Download Skill

Loading file tree…

claude.symlink/skills/env-dx/SKILL.md

Skill Metadata

Name
env-dx
Description
Scan the current environment for developer experience readiness — tools, runtimes, permissions, network, and container config. Use when entering a container, checking what's installed, auditing dev tools, or diagnosing missing dependencies.

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
Environment DX Scanner Skill | Agent Skills