chronicle-propose-experiment

Creates a Chronicle experiment from a hypothesis with report, prompt, and optional commit.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a research hypothesis discussed with an agent into a tracked, first-class experiment on the Chronicle platform requires several coordinated steps — drafting the hypothesis document, creating the experiment, attaching pre-registration, and linking a research prompt. This Skill automates that entire flow through the bundled MCP tools. ## Core Features & Use Cases - Experiment creation: Calls chronicle.create_experiment with a distilled title, hypothesis summary, and seed config YAML, producing an experiment in open state. - Pre-registration: Attaches the full hypothesis as a frozen hypothesis_report asset and links a primary research prompt as the experiment's anchor. - Lineage and citations: Registers parent experiments (handling tentative links that block commit) and cites publications via DOI or arXiv. - Optional commit: Locks the experiment specification when the user asks, resolving tentative lineage links via promote/drop dispositions. - Use Case: After surveying prior art, tell the agent to propose an experiment testing your hypothesis; it drafts the hypothesis document, creates the experiment, attaches the report, and reports the new experiment ID. ## Quick Start Ask the agent to propose an experiment for the hypothesis we just discussed and commit it once the hypothesis report is attached.

Frequently Asked Questions about chronicle-propose-experiment

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

FAQPage Schema
How do I create an experiment from a hypothesis in Chronicle?▼

Ask the agent to propose an experiment for your hypothesis. The skill calls chronicle.create_experiment with a title, hypothesis summary, and seed config YAML, then attaches the full hypothesis as a hypothesis_report and links a primary research prompt.

Do I need to install the Python SDK to propose a Chronicle experiment?▼

No SDK installation is required. The skill uses the bundled MCP tools directly (create_experiment, write_report, create_research_prompt, commit_experiment), with credentials resolved from ~/.methodic or the CHRONICLE_API_KEY environment variable.

Why does committing a Chronicle experiment fail with tentative lineage links?▼

Commit is refused when the experiment has parents that are still open, creating tentative links. Re-call commit_experiment with a tentative_links map that promotes parents which have since committed or drops the rest.

Can I attach a hypothesis report after the experiment is committed?▼

No. The hypothesis_report is pre-registration and freezes at commit, so it must be written before committing. If commit already happened without it, a fresh uncommitted experiment is needed to carry a different hypothesis.

When should I use propose-experiment instead of prep-variation?▼

Use propose-experiment to create a brand-new experiment from a hypothesis. Use chronicle-prep-variation when adding a variation to an experiment that already exists, and chronicle-research-survey when you need to survey prior art first.