From mechanist
Provides macro-level strategic directions for investigating the internal mechanism behind a model behavior, organized around six research directions (Location, Causal Intervention, Tuning & Editing, Formation Tracing, Unit Interpretation, Decision Auditing). Use once a phenomenon is observed to choose how to investigate its cause.
How this skill is triggered — by the user, by Claude, or both
Slash command
/mechanist:mechanism-exploreThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
The explanation half of the loop. Given a validated phenomenon, this skill is the **macro-level plan** for finding the mechanism behind it. It decides **which strategic directions to pursue, and in what order** — the families in **`/mechanism-skills`** execute the chosen directions.
The explanation half of the loop. Given a validated phenomenon, this skill is the macro-level plan for finding the mechanism behind it. It decides which strategic directions to pursue, and in what order — the families in /mechanism-skills execute the chosen directions.
A mechanism claim is causal: "component X is responsible for behavior B" means intervening on X changes B in the predicted, specific way. Locating X is necessary but not sufficient — only intervention earns the word "mechanism."
A phenomenon is in hand — whether already established/known or handed off from /mechanism-behavior-discovery — and the question is now where it is computed, whether that component causes it, whether it can be tuned for use, how it formed, what it means, or whether the model's decision is trustworthy. Do not use this skill to find a phenomenon (that is /mechanism-behavior-discovery), nor as a substitute for the chosen family's method file in /mechanism-skills.
Six parallel directions for explaining a model. They are coordinate — each answers a different question and stands on its own — and they also chain into strategies (see below). Location is typically the natural entry point for the others, since most directions act on a component you have first located.
At inference time, find which internal function component for the behavior: a layer, a neuron (or head), a circuit, or a featur/activation direction. Use cheap correlational/attribution methods (probing, vocabulary projection, magnitude, attribution, circuit discovery, dictionary learning). Output: a ranked shortlist of candidates. This is correlational — a located component is a hypothesis, not yet the cause.
Intervene on the located component and check the target behavior moves as predicted (amplify → behavior strengthens, ablate → behavior gone). Tools: ablation, activation patching (sufficiency / localization), steering (dose-response on a represented quantity). Always report sign, magnitude / dose-response, and specificity (a matched control component does nothing; off-target behavior intact). This is what promotes located to mechanism.
Directly tune or edit the located component to raise downstream task ability (steering vectors, parameter-space task vectors / weight editing, targeted fine-tuning). Distinct from direction 2: intervention is diagnostic (does X cause B?), tuning is applied (use X to make B better). Judged by downstream gains, not a causal verdict.
Move from inference-time to training-time: (a) how the component forms over training (when it emerges, how it sharpens across checkpoints); (b) which training data is critical to it (influence functions / data attribution, data-ablation re-training). Explains the component's origin. The most expensive direction — use only when genesis is part of the claim.
Reference: Mechanistic Data Attribution: Tracing the Training Origins of Interpretable LLM Units.
Decode the human-understandable concept carried by an internal unit (neuron / feature / direction) — turning an opaque activation into a named meaning.
References: Mechanistic understanding and validation of large AI models with SemanticLens (vision); language-model-explains-language-model auto-interpretation work; InterPLM: discovering interpretable features in protein language models.
Trace the evidence a model relies on for a specific decision, then judge that evidence against domain knowledge. Two complementary uses:
Reference: Using Interpretability to Identify a Novel Class of Alzheimer's Biomarkers.
Any of the six directions can stand alone, and they also chain. Pick the shortest combination that answers your question.
| Strategy | Mechanism Directions | Specific Case |
|---|---|---|
| Mechanistic evidence | Location → Causal Intervention | "X causally drives B." |
| Capability / editing | Location → Tuning & Editing | "Tuning X improves downstream task T." |
| Complete account | Location → Causal Intervention → Formation Tracing | "X drives B, and forms at stage S from data D." |
| Explaining a model | Unit Interpretation | "Unit X encodes concept C." |
| Decision reliability | Unit Interpretation → Decision Auditing | "Decision D relies on C — valid (or spurious / novel)." |
There is no default — choose the strategy (or a few candidate strategies) from the user's intent, and let that choice define the claim you are trying to land. Each row is self-contained: e.g. Location + Causal Intervention locates the head / feature carrying the behavior, then ablates or steers it to confirm it causally drives the behavior — a complete finding on its own, so do not bolt on a direction the user's question does not need. If a strategy is already specified by the task or plan, follow that requirement.
Based on the user's intent, design a few suitable mechanism-research strategies and directions for them. The common ones are the five strategies in the table above: Mechanistic evidence (Location + Causal Intervention), Capability / editing (Location + Tuning), Complete account (Location + Causal Intervention + Formation Tracing), Explaining a model (Unit Interpretation), and Decision reliability (Decision Auditing).
Keep the mechanism claim at the right altitude — hypothesize the kind of component, not its exact identity. The claim should assert that some internal component (a layer / neuron / head / circuit / feature direction) carries or causes the target behavior — not pin down which specific layer or which exact feature. Those concrete identities are precisely what the experiment stage is meant to discover (the Location + Causal Intervention work); fixing them at claim time pre-empts the experiments and risks committing to a specific the runs may not bear out.
If a record of mechanism directions already investigated for this same phenomenon (with their outcomes) is provided, propose a direction from the candidate set = untried directions ∪ directions left inconclusive. Do not re-propose a direction already shown to hold (confirmed) or already refuted — those are settled. A direction left inconclusive is not settled (the test failed to decide); it is a legitimate retry candidate, ideally with a stronger test. Build on what the prior outcomes established.
An explicit user/plan-specified direction overrides this avoidance. Per the "If a strategy is already specified by the task or plan, follow that requirement" rule above: when the task pins a direction, use it directly rather than picking a complementary untried one. Deciding whether to honor a pin that collides with an already-confirmed/refuted direction is the caller's responsibility, not this skill's — act on whatever honor-or-replace decision the caller hands you, and do not raise that confirmation yourself.
npx claudepluginhub zjunlp/mechanist --plugin mechanistGuides open-ended discovery of new behavioral phenomena in neural-network models (LLMs, multimodal). Use when the goal is to surface a candidate behavior worth explaining, not to investigate an already-named mechanism.
Decomposes ML constructs (attention, norm, convolution, etc.) into linear-algebra primitives and explains why they work. Includes ablation thought experiments.
Enforces scientific method—observation, falsifiable hypotheses, predictions, experiments, conclusions—for debugging unclear causes, intermittent issues, failed attempts, or uncertain architecture decisions.