| name | labnb-promote |
|---|---|
| description | Promote a labnb idea into a concrete experiment with explicit budgets, source links, and provenance. |
This is a flat, standalone labnb-promote skill so every AI coding agent can discover it directly. It is a focused companion to the broader labnb skill.
Helper scripts referenced as skills/labnb/scripts/... ship with the installed labnb skill; resolve them relative to that skill's directory (for example ~/.claude/skills/labnb/scripts/ or ~/.agents/skills/labnb/scripts/), not the repository layout.
Use this skill when an existing idea is ready to become a real experiment run.
- Review the notebook index and the idea entry before promotion.
- Require explicit experiment budgets at promotion time.
- Preserve the original idea as notebook history; do not delete it.
- Record the promoted experiment as stemming from the idea through source links and provenance.
- Carry forward the idea's local rules and durable memory into the new experiment before further work begins.
- Identify the idea entry id.
- Choose the experiment slug and required budgets.
- Promote it:
python skills/labnb/scripts/promote_idea.py \
--lab-root "$LAB_ROOT" \
--idea-id "$IDEA_ID" \
--project-root "$PROJECT_ROOT" \
--experiment-slug "$EXPERIMENT_SLUG" \
--metric-name "$METRIC_NAME" \
--direction "$DIRECTION" \
--verify-command "$VERIFY_COMMAND" \
--overall-budget "$OVERALL_BUDGET" \
--loop-budget "$LOOP_BUDGET"- Repeat
--source-idif the new experiment should also stem from other prior entries. - Continue the run with
labnb-run.