experiment-graphlisted
Install: claude install-skill samuhs/mad-science
# Experiment Graph
## Overview
Derive (read-only) an interactive graph of the experiments from a pipeline doc. The doc `docs/experiments-pipeline/<name>.md` is the **single source of truth**. The graph reflects **exactly what is written** in the doc — never what you think should be written.
This skill only *renders a view*. It never edits the doc or the experiments.
## When to Use
- The user wants a visual overview of the experiments (status, dependencies, critical path).
- After updating a pipeline doc, to review the resulting graph.
- To see at a glance: what is done, what is running, what is runnable now, what is blocked.
Do **NOT** use to modify the pipeline doc or experiment statuses — that is `experiment-pipeline`'s job.
## Source of Truth Contract
- Parse **only** from `docs/experiments-pipeline/<name>.md`.
- Status values are literal: `not-implemented`, `waiting-to-run`, `running`, `completed`.
- **NEVER "fix" an outdated status** (e.g. a doc that still says `not-implemented` for an experiment that clearly ran). Reflect it and flag it (see `references/layout.md`).
- An unrecognized status value → treat as `not-implemented` and flag it.
- The doc's own summary table and stated critical path are **claims to check**, not facts to trust. When they disagree with the edges, say so in the output.
## How to Run
`<skill-dir>` is the directory containing this `SKILL.md` (it differs per agent and install method).
```bash
python3 <skill-dir>/scripts/render.py docs/expe