Add Python Package

The only skill that knows python -m skore_skills env add. Callers must not splice manager commands themselves.

Human-facing prose

Details: setup-workspace references/human_facing_prose.md. Run python -m skore_skills … yourself. In questions and replies, show the manager command from print-only stdout (pixi add …, uv add …, pip install …) or a plain-language intent. Never paste python -m skore_skills, env add, env add-skore, or --feature / --group as something the user should run or choose. Never paste env graphviz either; quote that command's instructions or printed manager line.

Pre-flight

Tick, then immediately run the matching sequence step. Do not stop after listing the boxes.

- [ ] status + env detect
- [ ] env.managed: null → stop | false → ask, no --execute | true → continue
- [ ] classify: editable | add-skore | env route then env add
- [ ] skrub → env graphviz (execute conda/`dot -c` when allowed)

Sequence

1. python -m skore_skills status and env detect.

2. If policy.env.managed is null: env is unresolved. Say so and stop. Do not bootstrap here. Do not load setup-python-env by catalog id unless the user asked for env setup.

3. Classify this turn before adding anything:

   • Editable only if the user asked to install the workspace package, or setup-ml-project selected that box. has_src true is not enough.
   • Skore if the package is Skore.
   • Named package otherwise (skrub, pandas, …). Never --editable for a named dependency.

4. If managed is false: do not --execute. Run print-only env add (or env add --editable, or env add-skore --mode <mode>) to obtain the manager line. Every ask in this skill carries its context inline: name the package(s), the manager and env the command would touch, and what each option does. Do not name the calling skill. A file link is an addition, never the context. Ask with two options:

   1. I will handle it (default) — name the package(s) and show that stdout (e.g. pixi add pandas). Do not wait; return.
   2. Please install this now — show the same manager line, wait until the user confirms it is done, then return.

   Show exactly one manager command. Do not list agent extras, optional extras, ask, or refuse unless env route JSON this turn returned that scope. If print-only did not run, name the package and the manager in words. Do not invent a wrapper command.

5. If this turn is editable and has_src is true:

   python -m skore_skills env add --editable --execute
   

   Never pip install -e . in a pixi project. If has_src is false, stop. Name setup-workspace only if it is installed.

6. If the package is Skore, read the persisted policy.skore_mode and run:

   python -m skore_skills env add-skore --mode <mode> --execute
   

   If the mode is unset, return to evaluate-ml-pipeline. Do not spell skore[...] or pick conda vs PyPI yourself. See add-python-package/references/skore_variant.md.

7. Else python -m skore_skills env route <pkg>. Use only the scope returned this turn. Do not list other branches. Do not guess default.

   • No JSON this turn → name env route <pkg> and stop. Do not env add --execute.
   • refuse → stop. Quote message. Do not install.
   • default → env add --execute <pkg>
   • agent → env add --feature agent --execute <pkg>
   • ask → G-ENV-SCOPE: ask project runtime vs a named optional extra / agent tools. Map the answer to --feature / --group privately, then env add with that flag.

   When managed is true and scope is not refuse, pass --execute on that one command. Never paste pixi add / uv add / pip install from memory.

8. If this turn is skrub, Graphviz is required for DataOp HTML graphs. After the add, run python -m skore_skills env graphviz. Then:

   • dot is set, or action is conda and managed → python -m skore_skills env graphviz --execute (installs conda Graphviz when needed, then always dot -c in the composed env).
   • action is system and dot is null → AskUserQuestion with two options, quoting JSON instructions only:
     1. I will install Graphviz (default) — do not wait; return.
     2. Please wait until I confirm — wait, then re-run env graphviz --execute so dot -c still runs.
   • Unmanaged → do not --execute. Show command (conda) or instructions (system) from print-only JSON.

   Never invent brew / apt / winget / dot -c from memory. Do not pip-install Graphviz or add it as a Python package on uv / poetry / hatch / pip-venv. Refuse that in prose; do not paste env add graphviz or uv add graphviz as a command fence.

Return when the import is available, when the user confirmed they installed it, or when they chose to handle it themselves.

References

• references/skore_variant.md