Set Up ML Project
Ordering only. Never run a skipped skill's steps from memory.
Human-facing prose
Details: setup-workspace references/human_facing_prose.md.
Questions use data-science labels only (Python environment,
workspace layout, editable install, Git, environment manager,
whether we manage the Python environment, Python import name,
automatic commits). Do not put skill ids, G-* names, or the
wrapper CLI in the question.
Lookup
Run status and env detect first. Take the first row that
matches. Do not stop after reading the table.
setup.pending | Then |
|---|---|
| empty | step 9. Do not ask. |
| every pending piece's skill id is false | name the missing skills in one line, then step 9 |
| non-empty | step 3 multi-select, then step 4, then the stop row, then the choice table |
Stop row: editable is selected, has_src is false, and workspace
is not selected → one-line stop. Do not ask the remaining choices.
Do not scaffold from this skill.
Choice table. Apply every row that matches. Skip a row whose piece was not selected, was not on the board, or whose value is already recorded. Ask and persist before any write.
| Selected piece | Recorded state | Action |
|---|---|---|
| Python environment | detected manager is not "none", not ambiguous, not a mismatch, and policy.env_manager is unset | persist that manager. Do not ask. |
| Python environment | env_manager is "none" and policy.env_manager is unset, or ambiguous, or mismatch | ask, then policy set env_manager |
| Python environment | policy.env.managed is null | ask whether we manage the env (default yes), then persist |
| Workspace layout | fresh or manager-only, policy.package unset, src/<pkg>/ does not name it | ask the import name (folder name is the default), then policy set package |
| Git | policy.git.autocommit is null | ask on or off once, then persist |
Then step 7 when Git is selected, then step 8 in order env, workspace, editable, git, then step 9.
Sequence
-
Run
python -m skore_skills statusandpython -m skore_skills env detect.status.skillsis a per-id dict, never a boolean. Readstatus.setup. Each piece isdone,declined, ormissing.setup.pendingis the ordered list ofmissingpieces. Do notenv init,scaffold, install a package, orgit initin this opening phase. -
If
setup.pendingis empty, ask nothing. Go to step 9.doneanddeclinedpieces are already answered. Do not offer them. Do not ask their environment manager, whether we manage the env, import name, or automatic commits again. -
AskUserQuestion with
allow_multipleforsetup.pendingonly. Start by saying that before any modeling, the workspace should be set up. Then thestatusfacts each box rests on — detected manager,has_src, git presence, and which pieces are already recorded. Stay within 2–4 lines. Do not say the order the selected pieces will run. A file link is an addition, never the context. Include a box only when that id is true and the piece ismissing. Option labels (user-visible, no ids):- Python environment —
setup.pendingcontainsenvandstatus.skills.setup-python-envis true - Workspace layout —
setup.pendingcontainsworkspaceandstatus.skills.setup-workspaceis true - Editable install —
status.skills.add-python-packageis true,status.setup.editableismissing, and (has_srcis true or workspace is on this board) - Git —
setup.pendingcontainsgitandstatus.skills.setup-gitis true
Map selected labels to
setup-python-env,setup-workspace,add-python-package,setup-gitwhen loading.The question's last line is exactly: Select each one you want. Write nothing after that line. Do not add a
doneordeclinedpiece because the layout already looks unfinished. If every pending piece's skill id is false, skip the ask, name the missing skills in one line, and go to step 9. - Python environment —
-
After the answer, and not in the question, persist each piece the user does not select:
python -m skore_skills policy set setup.<piece> declined(env,workspace,editable, orgit). Do not persistdeclinedfor a box that was not on the board. -
Editable selected,
has_srcfalse, and workspace not selected → one-line stop. Do not ask the remaining choices. Do not scaffold from this meta. -
Ask the remaining choices now, before any write. Skip a question when the user does not select its piece, it was not on the board, or the value is already recorded. Each ask states in 2–4 lines what the answer authorizes. Order:
- Environment manager — the user selects Python
environment. If
env_manageris not"none",ambiguousis false,mismatchis false, andpolicy.env_manageris unset, persist that detected manager. Do not ask. Otherwise ask when (env_manageris"none"andpolicy.env_manageris unset, orambiguousis true, ormismatchis true). Ask withAskUserQuestion, usingrecommendedorder. PATH is not permission. Do notcurl | sh. Persistpython -m skore_skills policy set env_manager <manager>. - Whether we manage the env — the user selects Python
environment and
policy.env.managedis null. Default yes. Persistpolicy set env.managed trueorfalse. - Python import name — the user selects workspace, the
layout is fresh or manager-only (no
src/and nojournal/),policy.packageis unset, andsrc/<pkg>/does not already name it. Folder name is the default option. “You pick” / “go fast” does not resolve it. Persistpolicy set package <pkg>. - Automatic commits — the user selects Git and
policy.git.autocommitis null. Ask once: should later stages persist withgit commit(on) or never (off)? That answer consents to the first commit. It does not authorize tracking unknown hidden files or review paths. Persistpolicy set git.autocommit onoroff. That answer does not decide the pre-change snapshot.
Do not ask notebooks, the documentation site, tabular library, or where reports go.
- Environment manager — the user selects Python
environment. If
-
Pre-change snapshot, before any setup write. Run this only when Git was selected,
status.skills.setup-gitis true, andpolicy.git.snapshotis null. Loadsetup-gitand do only its pre-change snapshot section, then return here. Do notenv init,scaffold, orgit ignore-mergein this step. Do not ask the snapshot question in this skill. The loaded section asks only whengit snapshotreturnsask.cleanandnothing_to_commit, including an empty folder, persistskippedand do not ask. If Git was not selected,git.snapshotis already set, orsetup-gitis not installed, skip this step. A missingsetup-gitis one line, then continue. When the check returnsask, the commit is still offered if autocommit isoff. -
Load selected skills only, in this order: env → workspace → editable (
has_src) → git. Load<id>only ifstatus.skills.<id>is true; else one-line skip. Do not invent that skill's steps. The loaded skills must not ask again for a choice persisted in step 6. After each loaded skill returns, persistpython -m skore_skills policy set setup.<piece> done. For editable, do that only whenenv add --editable --executeexits 0. A non-zero exit leavessetup.editablemissing. Do not mark a skipped piece, or a piece the user does not select,done. -
Return to the skill that dispatched this turn (a lifecycle stage, or triage waiting on a lifecycle request). Do not open the entry board and do not start exploratory data analysis or a pipeline from here. When the user asked only to set up or bootstrap,
statusagain and loadtriage-ml-taskonly ifstatus.skills.triage-ml-taskis true; else stop. That handoff may ask what to do next; it is not a setup question.
Stop conditions
- Do not
env init,scaffold, or install a package before step 8. Do notgit initbefore step 7. - Do not offer a
doneordeclinedpiece again. - Do not ask tabular library, skore mode, notebooks, or site.
- Do not ask which hidden files or review paths to keep;
setup-gitasks that once, before the first commit. - Do not install sklearn, skrub, or pandas. The selected
setup-python-envskill installs plainskoreduring bootstrap; do not install or configure Skore directly from this coordinator. - Do not write experiment or pipeline bodies.
- Do not commit except by loading
setup-git. - Do not abort setup because one skill is missing.
- Do not invent a missing skill's procedure.
- Do not
pixi add/uv addfrom this coordinator;add-python-packageowns install.


