experiment-plan

Creates machine learning experiment plans through structured interviews and saves them to .mjun/experiments/.

1|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/mjun0812/skills --skill experiment-plan-mjun0812
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: experiment-plan
Source: https://github.com/mjun0812/skills/tree/main/skills/planning/experiment-plan
Command: npx skills add https://github.com/mjun0812/skills --skill experiment-plan-mjun0812

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Machine learning experiments often start without clear hypotheses or success criteria, making results hard to interpret. This Skill guides you through a structured interview to define purpose, verifiable hypotheses, and evaluation criteria before running an experiment, then saves the plan as a Markdown document. ## Core Features & Use Cases - Guided Interview: Asks one question at a time with recommended options and reasons, covering purpose, hypotheses, experiment design, implementation, and scope. - Standardized Plan Documents: Generates experiment plans from a template with metadata tables, hypothesis sections, and placeholders for post-experiment results, saved to .mjun/experiments/ with date-based filenames. - Verifiable Hypotheses: Ensures each hypothesis can later be judged as supported, partially supported, refuted, or unverifiable against agreed numeric criteria. - Use Case: Before training a new model variant, ask the Skill to draft an experiment plan; it interviews you about baselines and metrics, then produces a plan document you can link from Issues and PRs. ## Quick Start Ask the assistant to create a machine learning experiment plan for your next training or evaluation run.

Frequently Asked Questions about experiment-plan

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

FAQPage Schema
How do I create a machine learning experiment plan document?

Ask the assistant to create an ML experiment plan, and it will interview you one question at a time about purpose, hypotheses, design, and scope. After your approval, it saves a templated Markdown plan to .mjun/experiments/ with a date-based filename.

What makes a good hypothesis for an ML experiment?

A good hypothesis is verifiable: it must be judgeable as supported, partially supported, refuted, or unverifiable after the experiment. The Skill enforces this by requiring agreed numeric criteria and comparison targets during the interview.

Where are experiment plan files saved?

Plans are saved in the .mjun/experiments/ directory at the repository root, created if missing. Filenames follow the YYYYMMDD_<slug>.md format using the creation date.

Can I use this for general project planning or design documents?

No, this Skill is scoped to machine learning training and evaluation experiments only. Its description explicitly excludes general planning, design documents, plan completion processing, and result recording.

Does the experiment plan include implementation details and commands?

No, the plan lists only required implementation items as brief bullet points. Detailed procedures, commands, and code snippets belong in linked Issues and PRs, which are referenced from the metadata table and implementation section.