paper-reading-experiment-design — Claude Code skill for experiment design
The paper-reading-experiment-design skill turns a research method’s claims into an experiment plan, covering evidence, metrics, baselines, and checks. Use it once the method has a clear thesis and target.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill paper-reading-experiment-design -a claude-codeWhat paper-reading-experiment-design does
The skill helps plan experiments around a method’s central claims. It links claims to observable evidence and measurement protocols, then guides choices about tasks, datasets, baselines, and metrics. When the thesis, target failure, or intervention point is still unsettled, it routes the work back to method definition.
The workflow creates an experiment folder under workspace/experiment-designs/ and builds a set of planning artifacts: a claim-evidence map, experiment design, baseline matrix, metric map, and ablation and control plan. Decisions are handled in small steps, with user confirmation before dependent choices proceed. A fully automatic run produces a provisional sketch, not a final plan.
Install it in Claude Code with npx skills add franklee16/academic-research-skills --skill 07-experiment-design -a claude-code. An uncommitted method keeps the resulting design provisional, so it is not ready to present as a finalized experiment plan.
What it helps with
- connect a method’s claims to observable evidence
- choose tasks, datasets, and baselines for an experiment
- map claims to metrics and measurement protocols
- plan ablations, confound checks, and stress tests
- prepare a study plan that addresses likely reviewer objections
Example prompts for the agent
- Design experiments for my committed method, and show me the source decision first.
- Map the method’s main claims to metrics, measurement protocols, and validity risks.
- Draft a provisional experiment sketch and flag decisions that still need review.
How to install paper-reading-experiment-design
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-experiment-design -a claude-code2Manually: put the files in place
~/.claude/skills/07-experiment-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/07-experiment-design/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-experiment-design -a codex2Manually: put the files in place
.agents/skills/07-experiment-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-experiment-design -a cursor2Manually: put the files in place
.cursor/skills/07-experiment-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills lit-review/Paper-Reading-Skills-main/skills/07-experiment-design2Manually: put the files in place
.github/skills/07-experiment-design/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-experiment-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path lit-review/Paper-Reading-Skills-main/skills/07-experiment-designManually: put the files in place
.devin/skills/07-experiment-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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 paper-reading-experiment-design
How do I install paper-reading-experiment-design in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill 07-experiment-design -a claude-code. The skill file is at ~/.claude/skills/07-experiment-design/SKILL.md.
What does paper-reading-experiment-design do?
It guides experiment planning for a research method, including evidence routes, tasks, datasets, baselines, metrics, and ablations. It also helps connect each key claim to a measurement protocol.
Does the skill require a committed method?
A committed method design is the preferred starting point. If the method’s thesis or target intervention is unsettled, the skill recommends returning to method definition; a provisional source leads to a provisional plan.