chronicle-prep-variation

Creates a new Chronicle experiment variation with a cloned repo, agent branch, and config scaffold.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires methodic-research.

What problem does it solve? Starting a new experimental variation normally requires manually cloning the experiment repository, creating a branch, copying the parent configuration, and registering the variation in Chronicle. This Skill automates that entire setup so researchers can go from intent to an editable, registered variation in one step. ## Core Features & Use Cases - Automated repo preparation: Mints a scoped git token, shallow-clones the experiment repo, and creates an agent-format branch. - Config scaffolding: Copies the parent variation's config.yaml as a starting point for the new variation. - Variation registration: Registers the branch as an open variation in Chronicle with a description, optional name, hypothesis, and expected outcome. - Use Case: A researcher says "start a fresh variation off variation 1 with doubled width" and receives a local clone on a new branch with the config ready to edit and the variation tracked in Chronicle. ## Quick Start Ask the agent to create a new variation of your current Chronicle experiment with a short description and hypothesis, for example: start a new variation off v1 testing whether widening attention improves eval coherence.

Frequently Asked Questions about chronicle-prep-variation

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

FAQPage Schema
How do I create a new variation in a Chronicle experiment?▼

Provide the experiment ID, a description, and a hypothesis; the skill clones the experiment repo, creates an agent branch, copies the parent variation's config, and registers the branch as an open variation in Chronicle.

What is the difference between prep-variation and fork-variation in Chronicle?▼

Prep-variation starts a fresh variation derived from a parent variation's config, while fork-variation forks an existing committed variation. Use prep-variation for new tweaks and fork-variation when branching off committed work.

Does creating a Chronicle variation require a hypothesis?▼

A hypothesis is strongly recommended as the variation's pre-registration. A variation without one can only be committed via the explicit commit_without_hypothesis override, though it can be added later while the variation is still open.

Why does variation prep fail with repo not ready?▼

The experiment's git repository is still being created server-side, shown by a git_status state of pending. Wait about ten seconds and re-run the skill once the state becomes ready.

What permissions are needed to mint a git token for a Chronicle experiment?▼

You need Write access on the experiment; otherwise token minting returns a 403 error. Authenticate with a Chronicle API key via environment variable or methodic auth login before running the skill.