experiment-design — Claude Code skill: experiment planning
Turn a research idea into staged experiments with baselines, datasets, metrics, and ablations. Useful when shaping an experimental plan for a paper.
npx skills add lingzhi227/agent-research-skills --skill experiment-design -a claude-codeWhat experiment-design does
Give the skill a research idea, an existing plan, or a method description. It lays out four stages: get an implementation working, tune baselines, explore research improvements, then run ablation studies. Each stage builds on the strongest result from the one before it.
The design_experiments.py script prepares baseline comparisons, an ablation matrix, a hyperparameter grid, and metric choices. It can produce JSON or Markdown output. Python is required to run the script, which relies on the standard library only.
The plan includes datasets and completion criteria for each stage. During baseline tuning, the model architecture stays fixed and tests cover at least two datasets; the creative-research stage uses at least three. The skill also calls for multiple seeds and recording each run in notes.txt, so those steps belong in the experimental workflow.
What it helps with
- break a research idea into staged experiments
- list baseline methods for comparison
- choose datasets and evaluation metrics
- map out a hyperparameter grid
- plan component-by-component ablations
Example prompts for the agent
- Turn this research idea into a staged experiment plan.
- Plan baseline tests and metrics for this classification method.
- Draft ablation studies for the model described here.
How to install experiment-design
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill experiment-design -a claude-code2Manually: put the files in place
~/.claude/skills/experiment-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/experiment-design/
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill experiment-design -a codex2Manually: put the files in place
.agents/skills/experiment-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill experiment-design -a cursor2Manually: put the files in place
.cursor/skills/experiment-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install lingzhi227/agent-research-skills experiment-design2Manually: put the files in place
.github/skills/experiment-design/SKILL.md1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill experiment-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/lingzhi227/agent-research-skills --path skills/experiment-designManually: put the files in place
.devin/skills/experiment-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill experiment-design -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about experiment-design
How do I install experiment-design in Claude Code?
Run npx skills add lingzhi227/agent-research-skills --skill experiment-design -a claude-code. The skill file is at ~/.claude/skills/experiment-design/SKILL.md.
What does experiment-design do?
It turns a research idea or method description into a staged experiment plan covering baselines, datasets, metrics, hyperparameters, and ablations.
Does experiment-design need Python?
Python is needed to run design_experiments.py. The script uses only the standard library.