chronicle-bundle-variation

Packages external training code into a zip and registers it as a Chronicle variation code artifact.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires methodic-research.

What problem does it solve? Running third-party or unpackaged training code on Chronicle's managed Menlo Park workers normally requires a durable git ref and credentials Chronicle may not have. This Skill snapshots your local project into a zip bundle, registers it as the variation's code_artifact input, and creates the variation so a managed worker can install and run it. ## Core Features & Use Cases - Code Bundling: Zips the local project root (keeping .git for provenance, excluding build cruft) in the exact layout the worker's extractor expects. - Artifact Registration: Uploads the zip via presigned URLs and links it as a code_artifact input when creating the variation. - Use Case: You cloned a third-party training repo and want a managed Chronicle worker to run it. Point the Skill at the checkout and your experiment YAML; it bundles the code, creates the variation, and you commit to dispatch run 0 to a worker. ## Quick Start Bundle the code in my current directory and create a Chronicle variation for my experiment using configs/experiment.yaml.

Frequently Asked Questions about chronicle-bundle-variation

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

FAQPage Schema
How do I run external training code on a Chronicle managed worker?▼

Bundle the local project into a zip, register it as a code_artifact asset via presigned upload, and create a variation linking that asset as an input. Committing the variation dispatches run 0 to a Menlo Park worker that unzips, pip installs, and trains.

When should I bundle code instead of using a git ref in Chronicle?▼

Bundle when the code lives in a third-party repo whose ref is not durable (it can be deleted or force-pushed) or when Chronicle lacks credentials to clone it. Use chronicle-prep-variation or chronicle-author-variation for Chronicle's managed repo instead.

What layout must the zip archive have for the Chronicle worker?▼

Contents must sit at the archive root with a pyproject.toml or setup.py, because the worker runs unzip with no path stripping then pip install -e code/. Build the zip from the project root and never wrap it in a parent directory.

Why does my bundled variation fail with ModuleNotFoundError?▼

The config's packages: list names a package that is not importable after installing your project. Fix the package name or the project layout so every packages: entry imports after pip install before committing the variation.

Can I switch a bundled variation back to git-managed code?▼

Yes, while the variation is still open, use chronicle-rebind-variation-git to bind a pushed branch and clean up the bundle artifact. This replaces the code_artifact input with a git ref.