manage-environment

Audit Python and Node.js environments for package conflicts and PATH issues.

4|1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/lushly-dev/afd --skill manage-environment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-environment
Source: https://github.com/lushly-dev/afd/tree/main/.claude/skills/manage-environment
Command: npx skills add https://github.com/lushly-dev/afd --skill manage-environment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill tackles the chaos of development environment entropy, preventing issues like global package pollution, version conflicts, and PATH issues that plague agentic workflows.

Core Features & Use Cases

  • Environment Hygiene: Enforces best practices for Python (venv, uv, pip) and Node.js (version managers, npm, pnpm).
  • Audit & Cleanup: Provides tools to detect and fix environment drift and pollution.
  • Cross-Platform Consistency: Offers guidance for both Windows and macOS.
  • Use Case: When setting up a new project or encountering mysterious import errors, use this Skill to audit your Python and Node.js environments, ensuring they are clean, correctly configured, and free of conflicts.

Quick Start

Run the environment audit checklist to identify any potential issues in your current setup.

Frequently Asked Questions about manage-environment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Python import errors caused by global package pollution?

Fix Python import errors from global package pollution by running an environment audit to detect version drift, then isolating dependencies using venv or uv to restore clean resolution paths.

What is the best way to prevent PATH entropy when managing Node.js and Python tooling?

Prevent PATH entropy by enforcing environment hygiene best practices, utilizing version managers for Node.js and virtual environments for Python to ensure correct executable resolution and eliminate drift.

How do I audit my dev environment for version drift and lockfile conflicts?

Audit your dev environment for version drift and lockfile conflicts by executing the environment audit checklist, which identifies pollution across Python, Node.js, and system tooling to ensure correct configuration.

Can I use this environment cleanup playbook for both Windows and macOS?

Yes, you can use this environment cleanup playbook for both Windows and macOS, as it provides cross-platform patterns to manage installation best practices and resolve system tooling conflicts consistently.

Why does configuring MCP servers cause system tooling conflicts?

Configuring MCP servers causes system tooling conflicts when global package installations pollute your environment, creating PATH entropy and version drift that disrupts agentic workflows and import resolution.