probabl-ai/skore-skills

setup-git

Initialize safe version control, including an optional commit of the tree before setup changes it.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/probabl-ai/skore-skills --skill setup-git

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

Set Up Git

Pre-change snapshot

Run this section only when setup-ml-project loaded this skill for the pre-change snapshot. Do not run Lookup. Do not scaffold. Do not ask whether later stages commit. Then return to setup-ml-project.

  1. Run python -m skore_skills git snapshot.
  2. action skip and reason already: return. Do not persist

again.

  1. action skip and reason clean or nothing_to_commit:

persist python -m skore_skills policy set git.snapshot skipped, then return. Do not ask. Do not git commit.

  1. action ask: AskUserQuestion. Recommend committing. In

2–4 lines, say this commit records the workspace as it is now, so the user can return to it before setup changes anything. It does not change whether later stages commit. A file link is an addition, never the context.

  • No: persist python -m skore_skills policy set git.snapshot declined.

Do not git init, git add, or git commit. Return.

  • Yes: continue. Persist

python -m skore_skills policy set git.snapshot committed after the commit exits 0.

  1. On yes, if repo is false, run git init -b main before

adding files. The initial branch is main. Do not git config. Do not name that branch master.

  1. If ambiguous_dotfiles or review_paths is non-empty, ask

once which of those paths to keep tracked. List every hidden path and each review path with its kind. Say that paths they do not keep are ignored. Do not ask a second question for the other list. Copy paths from the JSON. Then:

  • ambiguous_dotfiles was non-empty →

python -m skore_skills git ignore-merge --decide plus --keep <path> for each chosen hidden path (no --keep if they keep none).

  • review_paths was non-empty →

python -m skore_skills git review-decide with --keep <path> for each chosen path and --ignore <path> for every other path in that list (no --keep if they keep none). Pass a folder path through with its trailing slash.

Empty lists: do not ask, and do not run git ignore-merge. Never --keep .env or .skore. Exit code 2 from those commands is structured JSON, not a command failure.

  1. git status. git add -- <paths> only staged paths that

are not still listed in review_paths, plus hidden paths the user kept. Never stage .env, .skore, .venv, .pixi, or another must-ignore tool directory. Never stage a review path that was not kept.

  1. git commit -m "<one-line subject>". The subject states that

this is the workspace before setup changes it. Only this section uses that subject.

Lookup

Run status first. Take the first row that matches, then run its steps from the Sequence below. Do not stop after reading the table.

policy.git.autocommitSituationStepsAskCommit
on or off, user asks to change itHEAD exists, or the new value is off1, 9the autocommit question onlyno
on or off, user asks to change itnew value on, no HEAD1, 7, 8, 9autocommit, then one keep question if review_paths is non-emptyyes
nullany2, 3, 4, then only the Ask and Commit of the row for the persisted answer. Do not run steps 2 or 3 againautocommit onceper that row
offany2, 3, 5, 9nothingno
onpolicy.git.snapshot is committed and git status is dirty2, 3, 7, 8, 9one keep question only if ambiguous_dotfiles or review_paths is non-emptyyes, the setup changes only
onHEAD exists2, 3, 6, 9nothingno
onno HEAD2, 3, 7, 8, 9one keep question only if ambiguous_dotfiles or review_paths is non-emptyyes

The keep question is one question. After step 3 it lists every hidden path and every review path with its kind. The change-to-on row did not run ignore-merge: list only review_paths. Exit code 2 from git ignore-merge, git review, or git review-decide is structured JSON, not a command failure.

Sequence

  1. Run python -m skore_skills status. If the user asked to

change the commit choice and policy.git.autocommit is already on or off, re-ask that question and persist on or off. Do not git init. Do not git ignore-merge. If the new value is on and the repo has no HEAD yet, continue at the first-commit review (step 7). If the new value is off, or on and HEAD exists, stop this sequence: use the return rule in step 9 and do not continue at step 2. Do not invent another commit. Later stages follow the new value. Otherwise, if autocommit is already on or off, do not ask that question again.

  1. If there is no .git directory, run git init -b main. The

initial branch is main. Do not run git config. Do not name that branch master. Do not rename a branch that already exists.

  1. Run python -m skore_skills git ignore-merge. Keep the JSON

ambiguous_dotfiles list. Exit code 2 is that structured list, not a command failure. Do not ask yet.

  1. If policy.git.autocommit is null, ask once: should later

stages persist with git commit (on) or never (off)? State in 2–4 lines what the answer authorizes — commits at the end of later stages, starting with the first commit this turn — and which paths stay ignored; a file link is an addition, never the context. Persist with python -m skore_skills policy set git.autocommit on or off. That answer is also consent for the first commit. It does not authorize tracking ambiguous_dotfiles or review_paths. When setup-ml-project already persisted on or off this turn, do not ask again.

  1. If autocommit is off, stop. Do not ask which files to keep.

Do not git commit. Use the return rule in step 9.

  1. If autocommit is on and HEAD exists, stop after ignore-merge.

Do not use this step when policy.git.snapshot is committed and git status is dirty; that row commits the setup changes. Do not ask which files to keep. Do not invent another commit. Later stages use python -m skore_skills git end-turn --stage <stage> then persist-ml-git, where <stage> is setup, data_analysis, implement, evaluate, or backlog. When that skill is not installed, those stages report the pending paths instead of committing.

  1. If autocommit is on and (this repo has no HEAD yet, or

policy.git.snapshot is committed and git status is dirty), run python -m skore_skills git review. When git.snapshot is committed, the step 8 commit is only the changes since that snapshot. Do not ask to snapshot again. When this step is reached from step 1, ignore-merge did not run: use only review_paths. If ambiguous_dotfiles and review_paths are both empty, do not ask. If either list is non-empty, ask once which of those paths to keep tracked. List every hidden path and each review path with its kind. Say that paths they do not keep are ignored. Do not ask a second question for the other list. Copy paths from the JSON; do not reclassify them. Do not ask about file size, artifacts, or datasets when review_paths is empty, and do not ask about hidden files when ambiguous_dotfiles is empty. Then:

  • ambiguous_dotfiles was non-empty → re-run

python -m skore_skills git ignore-merge --decide plus --keep <path> for each chosen hidden path (no --keep if they keep none).

  • review_paths was non-empty →

python -m skore_skills git review-decide with --keep <path> for each chosen path and --ignore <path> for every other path in that list (no --keep if they keep none). Pass a folder path through with its trailing slash so the ignore line is that folder. Exit code 2 from git review or git review-decide is the structured review outcome, not a generic command failure: read its JSON. The question in this step is that decision; do not ask again. If review-decide still lists paths, rerun it with the same choices.

Run only the command for a list that was non-empty. Do not re-ask paths gone from the next JSON. Never --keep .env or .skore.

  1. Then git status. git add -- <paths> only paths that are

not still listed in review_paths, and git commit -m "<one-line subject>" from this setup turn. The subject describes the files committed now. It does not say this commit is the state before setup changes. Do not ask a second time about autocommit. Never stage .env or .skore.

  1. When setup-ml-project dispatched this turn and is in this

session, return control to it. Otherwise load triage-ml-task if status.skills reports it installed, else stop.

Stop conditions

  • Never overwrite .gitignore; git ignore-merge unions packaged

rules.

  • Never stage .env, .skore, or a review path that was not

kept.

  • Never split hidden files and review paths into two questions

before the first commit.

  • Never push, create a remote, amend, rebase, or set git identity.
  • The initial branch is main. Do not name it master. Do not

rename a branch that already exists.

  • Do not call python -m skore_skills git end-turn --stage … to

create the first commit.

  • The pre-change snapshot does not scaffold. It does not run

git ignore-merge unless ambiguous_dotfiles was non-empty.

  • Lookup does not use the pre-change snapshot commit subject.
du même dépôt

Autres Skills

Tous les Skills
probabl-ai
Communauté

plot-ml-figure

Pick pandas, seaborn, plotly, or matplotlib before writing figure code. Trigger when explore-ml-data, evaluate-ml-pipeline, or audit-ml-pipeline is about to save or display a chart, or when the user asks for a plot. Not a session owner. Not for skore/sklearn Display plots that already exist on a report. HOW TO USE: first match on the tree (owned plot, interactive iframe HTML, seaborn statistical, pandas chart, else matplotlib). In a notebook: save PNG (or HTML) then leave the figure as the cell

Installations / 1h
1
GitHub Stars
145
Mis à jour
9 nov.
probabl-ai
Communauté

shape-user-idea

Shape a user idea or a named artifact into one idea file and one Ideas row after they confirm. A topic with no artifact belongs to search-ml-literature. Do not write History, Backlog, or a design note. Do not pick a backlog row.

Installations / 1h
1
GitHub Stars
145
Mis à jour
9 nov.
probabl-ai
Communauté

audit-ml-pipeline

Audit a persisted skore report read-only and produce a reusable digest. Do not execute it. Run materialize.py once. Never call skore.evaluate or project.put. TRIGGER when a completed run needs an audit, the user asks to audit, show, or re-audit an experiment, a re-run overwrote the same put() key, or they want a narrative of a past experiment without journal/ideas/ files. STOP when status.setup.pending is non-empty (load setup-ml-project), or when there is no approved design, no report, or no ag

Installations / 1h
1
GitHub Stars
142
Mis à jour
20 oct.
probabl-ai
Communauté

choose-python-library

Resolve a library choice and add the selected dependency. Trigger for competing-library questions or an optional package not already fixed by the project stack — at first use (tabular exploration, pipeline, or eval extras), never during workspace setup.

Installations / 1h
1
GitHub Stars
142
Mis à jour
20 oct.