mcpField
H
hypothesis-and-ablation-planner

hypothesis-and-ablation-planner

github.com/jurgendnData & databases1164 installsUpdated 6w ago
Repository

About hypothesis-and-ablation-planner

A planning skill for researchers designing ablation studies around empirical claims. It links each experiment to a causal hypothesis, controls competing explanations, and prioritizes a compact set of informative tests.

Key features

  1. 01Decompose methods into causal components
  2. 02Define hypothesis-linked ablations
  3. 03Control confounds and competing explanations
  4. 04Prioritize must-have, useful, and optional tests
  5. 05Summarize results in a structured table

Use cases

  1. 01Plan ablations for a research paper
  2. 02Separate competing explanations for an effect
  3. 03Reduce redundant experiments
  4. 04Identify remaining confounds and decisive tests

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jurgendn/agent-skills --skill hypothesis-and-ablation-planner

After installing, type/hypothesis-and-ablation-plannerin Claude Code to confirm it loaded.

Details

From the project README

Hypothesis and Ablation Planner

Ablations should test explanations, not merely remove components.

Procedure

  1. State the main empirical claim.
  2. Decompose the method into causal components.
  3. For each component, define:
    • claimed mechanism
    • minimal ablation
    • expected directional effect
    • competing explanation
  4. Add controls for:
    • parameter count
    • compute budget
    • data leakage/filtering
    • prompt/template effects
    • preprocessing artifacts
    • implementation bias
  5. Minimize the ablation set:
    • remove redundant studies
    • prioritize hypothesis-separating experiments
  6. Label each ablation:
    • must-have
    • useful
    • optional

Rules

  • Every ablation must answer a specific causal question.
  • Avoid ablation explosion.
  • If two explanations remain confounded, state it explicitly.
  • Prefer interpretable ablations over cosmetic variants.
  • “Removing one block” is not sufficient unless tied to a hypothesis.
  • Keep training budget and evaluation protocol controlled whenever possible.

Output Format

HypothesisComponentAblationExpected ResultAlternative Explanation ControlledPriority
...............Must-have / Useful / Optional

Final Checks

After the table, briefly state:

  • which hypotheses are still confounded
  • which ablation is most decisive
  • which ablation is cheapest per unit insight

Comments

Markdown supported