Tooluck logoTooluck
SKILL.md

env-management

Agent skill fromaipoch/open-science

Use when a notebook run fails on a missing package (ImportError, ModuleNotFoundError, "there is no package called"), when you need to inspect an installed package version, or when you need to install, add, or manage Python or R packages for the notebook runtime. Covers inspect_packages, routing Python vs R through manage_packages, why in-cell %pip/!pip/install.packages() and OS installers are forbidden, restarting the kernel after an install, and when to stop and ask the user.

How to install env-management

install env-management
# install the open-science pack with the skills CLI
npx skills add aipoch/open-science

# or add only this skill to Claude Code: copy the folder

resources/skills/env-management/

# into

~/.claude/skills/env-management/ (all projects)

.claude/skills/env-management/ (one project)

resources/skills/env-management/SKILL.md

Apache-2.0Full file
1# Environment and package management
2
3The notebook runs against the session's **bound runtime**: the app-managed default (`default-python` / `default-r`) unless you bind another one with `notebook_bind_runtime` — a named environment you created, or one of the user's own detected interpreters. You never activate environments by hand, and you never install packages from inside a cell. Installs happen in the trusted main process through a single tool, `manage_packages`, and always land in the currently bound runtime. This page is the workflow for getting a package installed and for knowing when a package is not something you can install yourself.
4
5## When a package is missing
6
7A run that fails with `ImportError` / `ModuleNotFoundError` (Python) or `Error in library(x): there is no package called 'x'` (R) means the package is not in the environment yet. The fix is one `manage_packages` call, not a code change. Do not rewrite the cell to use a different library that "does roughly the same thing" — install the package the task actually needs. Do not fall back to reading data or computing results a worse way to dodge the missing import.
8
9## Check an installed version
10…

Excerpt shown under the repository's Apache-2.0 license.

More skills in open-science

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates