One-click install
npx skills add https://github.com/goodfire-ai/causalab --skill plan-experiment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-experiment
Source: https://github.com/goodfire-ai/causalab/tree/main/.claude/skills/plan-experiment
Command: npx skills add https://github.com/goodfire-ai/causalab --skill plan-experiment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts a fuzzy research goal into a complete experiment plan, defining the causal task setup and the full analysis dependency DAG so downstream execution and interpretation can run reliably.

Core Features & Use Cases

  • Objective crystallization: Produces a structured RESEARCH_OBJECTIVE.md with an evidence-oriented objective, optional hypotheses, and success criteria.
  • Dependency-DAG planning: Builds PLAN.md with the analysis chain (baseline → locate → subspace → activation/manifold geometry checks, etc.), including per-node I/O contracts and measurable pre-flight gates.
  • Runner configuration strategy: Specifies how to materialize runner configs for /run-experiment, including sweep and cache-reuse considerations to reduce redundant compute.

Quick Start

Start a new research investigation by running plan-experiment to generate the session plan artifacts that you will execute next with /run-experiment.

Frequently Asked Questions about plan-experiment

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

FAQPage Schema
How do I turn a mechanistic interpretability research idea into a structured experiment plan?

To turn a mechanistic interpretability research idea into a structured experiment plan, you crystallize the objective into a RESEARCH_OBJECTIVE.md and build a PLAN.md defining the analysis dependency DAG. This establishes pre-flight gates and per-node I/O contracts for downstream execution.

What is an experiment DAG and how does it structure causal abstraction research?

An experiment DAG structures causal abstraction research by mapping the analysis chain from baseline to locate, subspace, and activation geometry checks. It defines explicit dependencies between nodes, measurable pre-flight gates, and I/O contracts to ensure downstream runners execute reliably.

How do I plan experiment sweeps and cache reuse for a mechanistic interpretability session?

You plan experiment sweeps and cache reuse by defining runner configuration strategies within the session plan. This approach materializes configs for downstream execution while reducing redundant compute by explicitly mapping cache reuse dependencies across the analysis DAG.

Do I need an active session to generate a research objective and dependency DAG?

Yes, you need an active session to generate a research objective and dependency DAG. The process reads and writes session plan artifacts in the plan/ directory, resolving the active session to produce RESEARCH_OBJECTIVE.md and PLAN.md without overwriting existing plans.

What is the best way to avoid overwriting existing session plans when adding a new experiment?

The best way to avoid overwriting existing session plans is to resolve the active session before generating new artifacts. The planning process specifically targets the plan/ directory and avoids overwriting existing RESEARCH_OBJECTIVE.md and PLAN.md files within that session.