How do I install the Envoic skill?

Run npx skillmds@latest add dvcrn/envoic in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Envoic safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Envoic?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Envoic free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Envoic?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Envoic by dvcrn — Agent Skill

Name: Envoic
Rating: 4.2 (5 reviews)
Author: dvcrn

Envoic

Scan, audit, and clean up Python virtual environments (.venv, conda), node_modules, and development artifacts consuming disk space. Use when the user mentions disk space, environment cleanup, stale venvs, node_modules bloat, project cleanup, broken environments, dangling symlinks, or asks about disk usage from development tools. Also use when encountering ENOSPC errors, slow installs from cache bloat, or when onboarding into a project and needing to verify environment health.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

envoic - Environment Scanner and Cleanup Skill

Use envoic to discover and safely clean Python virtual environments, node_modules, and development artifacts.

Quick Start

uvx envoic scan .
uvx envoic manage . --dry-run
npx envoic scan . --deep

If uvx is unavailable, install Python package with pip install envoic. If npx is unavailable, install JS package with npm install -g envoic.

Primary Workflows

1) Onboarding Health Check

Run uvx envoic info .venv (or npx envoic info node_modules).
If environment is broken or stale, propose delete-and-recreate steps.

2) Disk Space Recovery

Run uvx envoic scan <root> --deep and/or npx envoic scan <root> --deep.
Identify largest stale candidates.
Run manage --dry-run, then actual cleanup only after confirmation.

3) Build/Test Artifact Cleanup

Scan project root.
Prefer deleting SAFE artifacts first.
Warn for CAREFUL artifacts.

Safety Contract

Always scan before delete.
Prefer --dry-run before destructive operations.
Never delete lock files or project manifest files.
Require explicit user confirmation for non-dry-run cleanup.

See full policy in references/safety.md.

Verified Trigger Phrases

"Find and remove stale virtualenvs"
"Clean old node_modules and caches"
"I hit ENOSPC, free up disk from dev artifacts"
"Audit environment sprawl in this workspace"
"Check if this .venv is broken"
"List largest build artifacts"
"Dry-run cleanup plan for Python and JS"
"Find dangling venv symlinks"
"Clean test/build caches safely"
"Generate JSON report for stale environments"

References

Full command catalog: references/commands.md
Safety and risk tiers: references/safety.md
Troubleshooting and fallbacks: references/troubleshooting.md

Tool-Specific Surface Files

Codex: .agents/skills/envoic/SKILL.md (symlink/copy of this skill)
Cursor: .cursorrules (generated adapter)
Copilot: .github/copilot-instructions.md (generated adapter)
Claude: .claude-plugin/plugins.yaml (generated adapter)

---name: envoicdescription: Scan, audit, and clean up Python virtual environments (.venv, conda), node_modules, and development artifacts consuming disk space. Use when the user mentions disk space, environment cleanup, stale venvs, node_modules bloat, project cleanup, broken environments, dangling symlinks, or asks about disk usage from development tools. Also use when encountering ENOSPC errors, slow installs from cache bloat, or when onboarding into a project and needing to verify environment health.---# envoic - Environment Scanner and Cleanup SkillUse envoic to discover and safely clean Python virtual environments, `node_modules`, and development artifacts.## Quick Start```bashuvx envoic scan .uvx envoic manage . --dry-runnpx envoic scan . --deep```If `uvx` is unavailable, install Python package with `pip install envoic`.If `npx` is unavailable, install JS package with `npm install -g envoic`.## Primary Workflows### 1) Onboarding Health Check1. Run `uvx envoic info .venv` (or `npx envoic info node_modules`).2. If environment is broken or stale, propose delete-and-recreate steps.### 2) Disk Space Recovery1. Run `uvx envoic scan <root> --deep` and/or `npx envoic scan <root> --deep`.2. Identify largest stale candidates.3. Run `manage --dry-run`, then actual cleanup only after confirmation.### 3) Build/Test Artifact Cleanup1. Scan project root.2. Prefer deleting SAFE artifacts first.3. Warn for CAREFUL artifacts.## Safety Contract1. Always scan before delete.2. Prefer `--dry-run` before destructive operations.3. Never delete lock files or project manifest files.4. Require explicit user confirmation for non-dry-run cleanup.See full policy in `references/safety.md`.## Verified Trigger Phrases- "Find and remove stale virtualenvs"- "Clean old node_modules and caches"- "I hit ENOSPC, free up disk from dev artifacts"- "Audit environment sprawl in this workspace"- "Check if this .venv is broken"- "List largest build artifacts"- "Dry-run cleanup plan for Python and JS"- "Find dangling venv symlinks"- "Clean test/build caches safely"- "Generate JSON report for stale environments"## References- Full command catalog: `references/commands.md`- Safety and risk tiers: `references/safety.md`- Troubleshooting and fallbacks: `references/troubleshooting.md`## Tool-Specific Surface Files- Codex: `.agents/skills/envoic/SKILL.md` (symlink/copy of this skill)- Cursor: `.cursorrules` (generated adapter)- Copilot: `.github/copilot-instructions.md` (generated adapter)- Claude: `.claude-plugin/plugins.yaml` (generated adapter)

Frequently asked questions