chronicle-run-variation

Execute a committed Chronicle variation's training run and record its lifecycle status.

1|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/methodic-research/skills --skill chronicle-run-variation-methodic-research
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chronicle-run-variation
Source: https://github.com/methodic-research/skills/tree/main/plugins/chronicle/skills/chronicle-run-variation
Command: npx skills add https://github.com/methodic-research/skills --skill chronicle-run-variation-methodic-research

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires methodic-research, wandb.

What problem does it solve? When you bring your own training code, you still need the experiment platform to know a run started, stayed alive, and reached a terminal state — otherwise runs silently time out as lost and results never get recorded. This skill drives the Chronicle run lifecycle (start, heartbeat, succeed/fail) around your own training code and optionally links a Weights & Biases run so metrics can be distilled later. ## Core Features & Use Cases - Run lifecycle management: Marks a committed variation's run as running, then succeeded or failed, with heartbeats for long training jobs. - W&B run linking: When WANDB_API_KEY is set, starts a W&B run first and records its pointer on the Chronicle run so distillation can fetch real metrics. - Pre-flight operational checks: Queries checks distilled from other agents' past execution failures before training starts, and reports new operational failures back to the catalog. - Use Case: You committed variation 2 of an experiment with chronicle-author-variation and want to train it on your own GPU box — this skill wraps your training loop so Chronicle records the run and links the W&B metrics for the later report. ## Quick Start Ask the agent to run variation 2 of the current experiment with my training script and record the run in Chronicle with W&B linked.

Frequently Asked Questions about chronicle-run-variation

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

FAQPage Schema
How do I run a committed Chronicle variation with my own training code?▼

Resolve the experiment ID and variation index, then call run.start() on the pending run, execute your training inside a try block, and call run.succeed() or run.fail() afterward. The skill is training-agnostic — your code runs unchanged inside the lifecycle wrapper.

How do I link a W&B run to a Chronicle experiment run?▼

Initialize wandb before calling run.start(), then pass wandb_run_id, entity, project, and dashboard URL to run.start(). Chronicle stores the pointer so chronicle-write-report can fetch metrics directly from W&B during distillation.

Can I run a Chronicle variation without Weights & Biases?▼

Yes, W&B is optional. Without WANDB_API_KEY the run is still triggered and marked succeeded or failed, but no metrics pointer is recorded, so distillation has no numbers to pull. Never pass placeholder W&B IDs.

Why does my Chronicle run get marked as lost during long training?▼

Chronicle marks a run lost after the heartbeat timeout expires. Call run.heartbeat() periodically from inside your training loop so long-running jobs stay marked as running until they reach a terminal state.

What happens if I try to start a run on an uncommitted variation?▼

The run start is rejected because runs can only start on committed variations. Commit the variation first with chronicle-author-variation, and use variations.resume to get a fresh run number if run 0 is already terminal.