experiment-tracking

Records training experiment configs into notebooks and an index.

57|6|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/lightning-rod-labs/lightningrod-python-sdk --skill experiment-tracking-lightning-rod-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: experiment-tracking
Source: https://github.com/lightning-rod-labs/lightningrod-python-sdk/tree/main/skills/experiment-tracking
Command: npx skills add https://github.com/lightning-rod-labs/lightningrod-python-sdk --skill experiment-tracking-lightning-rod-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of making training experiments comparable and auditable by ensuring every meaningful training run is recorded consistently.

Core Features & Use Cases

  • One notebook per experiment: Create a self-contained experiment notebook under ./userland/<project>/experiments/ that can be rerun from a clean kernel.
  • Single source-of-truth index: Maintain a project-level experiments.md table at ./userland/<project>/experiments.md with newest results on top.
  • Config-change driven experiment creation: Create a new exp_NNN_<slug>.ipynb only when tracked training knobs differ from the previous experiment (or mark status as running/done/failed as appropriate).

Use cases: when you iterate on base_model_id, labeler confidence thresholds, training steps, learning rate, or dataset regeneration parameters, you want an at-a-glance history of what changed and how calibration and accuracy metrics moved.

Quick Start

Tell the assistant to start a new training run and have it create a new experiment notebook and update experiments.md only if the tracked configuration differs from the last run.

Frequently Asked Questions about experiment-tracking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track model training runs and compare configuration changes?

To track model training runs effectively, record standardized experiment metadata by generating per-run notebooks and a project-level experiments index. This logs configuration diffs against previous runs for regression visibility and comparability.

What is the best way to log experiment metrics like Brier score and ECE for post-hoc analysis?

Logging experiment metrics like Brier score and ECE requires updating a project-level experiments.md table with consistent measurement values. This ensures every training run maintains standardized calibration and accuracy metrics for post-hoc analysis.

How do I create a reproducible experiment notebook for iterative model training?

Creating a reproducible experiment notebook involves generating a self-contained exp_NNN_<slug>.ipynb file under your project's experiments directory. This notebook can be rerun from a clean kernel to validate training configurations.

When should I create a new experiment tracking notebook instead of updating an existing one?

A new experiment tracking notebook should be created only when tracked training knobs differ from the previous experiment. If configurations match, you should instead mark the existing experiment's status as running, done, or failed as appropriate.

Does experiment tracking work without external dependencies for local model training?

Yes, experiment tracking works without external dependencies for local model training. It relies on generating standard notebooks and markdown index files to maintain a single source-of-truth for your training history.

Why does my experiments index show inconsistent metric deltas between training runs?

Inconsistent metric deltas in your experiments index occur when fixed delta sign conventions are not applied. Updating experiments.md with consistent metrics and standardized sign conventions ensures accurate regression visibility across runs.