| name | mechanism-skills |
| description | Routing entry point for eleven families of mechanistic-interpretability methods that localize *which* internal object (layer, attention head, neuron, SAE feature, weight, or input feature) drives a model's behavior, *how influential* it is, and *what changes* when it is intervened on. Use this skill whenever the question is about a model's internal mechanism rather than its external metrics — for example, claims that a specific component is responsible for a behavior, mechanistic-evidence requests, circuit-discovery tasks, feature-attribution work (SHAP), or concept-level explanations of vision/VL models. The file lays out each family's premise, signal, cost, advantages, limitations, and how to compose them into a cheap-screen → causal-verify pipeline. Loading is hierarchical and mandatory: after picking a family from this routing file you MUST load that family's `SKILL.md`, and after picking a submethod you MUST load that submethod's `SKILL.md` — never act on the previews in this file alone. |
Mechanism Skills
A curated set of eleven method families for analyzing the internal mechanisms of neural networks. Use this document as the routing entry point: read it first, pick the family that matches the question, then follow the link into the sub-skill for submethod detail, demos, and reference implementations.
When to Use
Consult these skills whenever the research question is about how the model computes internally, not just how it performs externally. Typical triggers:
- A reviewer asks for mechanistic evidence behind a claim
- A claim attributes a behavior to a specific component (layer, head, neuron, feature, weight)
- An experiment needs to isolate which internal object drives a behavior
- A method swap is under consideration and the candidate pool should include mechanism-level tools (e.g., swapping a magnitude-based screen for a causal-intervention method)
- A vision or vision-language model needs concept-level explanations rather than raw saliency
If the research question is purely behavioral (accuracy, robustness, calibration) and does not depend on internal structure, these skills are not the right tool — continue with the standard experiment skills.
Loading Protocol (Mandatory)
Skills cascade strictly top-down: this routing file → family SKILL.md → submethod SKILL.md. Each level adds detail the level above only sketches. Never act on a summary from a higher level alone.
Hard requirements — these are not suggestions:
- Pick a family based on the research question (use the Selecting a Method table). The summaries below are previews only — they are intentionally insufficient to plan or run work.
- Once a family is selected, you MUST load
<family>/SKILL.md in full before any further reasoning, recommendation, or code in that family. Assumed objects, exact signal definitions, scope conditions, composition rules across submethods, and known failure modes live in the family file, not here.
- Once a submethod is selected, you MUST load
<family>/<submethod>/SKILL.md in full before running, citing, choosing hyperparameters for, or recommending that submethod. Runnable scripts, API conventions, defaults, and submethod-specific gotchas live there.
- Do not skip levels. Going from this file directly to a submethod without reading the family SKILL.md is forbidden, because cross-submethod composition (screen-then-verify pairings, shared metrics, layer/position conventions) is defined at the family level.
- Re-load on switch. If the analysis pivots to a different family or submethod, repeat the cascade for the new branch — do not carry assumptions across families.
The cascade exists so that the small, focused submethod files can stay the single source of truth for execution detail. If something feels unfamiliar at any level, re-read the corresponding SKILL.md rather than guessing.
Method Families
The eleven families are organized by what signal they use to localize internal objects. Each family has its own parent SKILL.md with full submethod detail, runnable demo scripts, and paper references — see Directory Layout for the exact file shape. The bullets below are routing previews; per the Loading Protocol, you must open the family's SKILL.md once selected, and the submethod's SKILL.md once a submethod is chosen.
1. Vocabulary Projection — ./vocabulary-projection/
Premise: the pre-trained unembedding matrix $\mathbf{W}_U$ can serve as a universal decoder for intermediate states, via $\mathbf{p} = \text{softmax}(\mathbf{z}\mathbf{W}_U)$.
Signal: tokens promoted by projecting an internal object into vocabulary space.
Cost: cheap. No training, no labels — direct inspection of any state.
What it answers: what semantic content is already linearly decodable from this state by the final layer? Intuitive for residual-stream states; degrades inside sub-layers where basis alignment weakens.
Advantage: training-free — any internal state can be read directly in token space without labels or auxiliary classifiers.
Limitation: assumes intermediate states share a basis with the output vocabulary, so reliability degrades inside sub-layers (FFN, MHA) and in models whose representation space rotates strongly across layers.
Submethods: Residual Stream State · Attention Head Output · Neuron Value Weight.
2. Magnitude Analysis — ./magnitude-analysis/
Premise: internal elements with larger numerical values often exert greater influence on the computation.
Signal: static or dynamic magnitudes (weight norms, activation statistics, layer-wise distances).
Cost: cheapest. No backward passes, no auxiliary training.
What it answers: which components are present and prominent? Useful first-pass screening before committing to expensive methods. Does not establish causality — a high-magnitude feature can still be cancelled downstream.
Advantage: the cheapest method — no backward passes, no training — so it scales to large models and can serve as a first-pass filter before more expensive methods like Causal Attribution.
Limitation: a heuristic only — high magnitude does not guarantee causal necessity (it may be cancelled downstream), and components dormant on the chosen inputs are missed.
Submethods: Static Parameters · Dynamic Components · Layer-wise Representation.
3. Representation and Parameter Analysis — ./representation-and-parameter-analysis/
Premise: many concepts are encoded as linear directions — either in activation space ($\mathbf{v}c \in \mathbb{R}^{d{\text{model}}}$) or in parameter space ($\boldsymbol{\tau} = \boldsymbol{\theta}{\text{ft}} - \boldsymbol{\theta}{\text{pre}}$). Once a target direction/feature is found, it can be used as a read-out (project) or write-in (add) operator — the write-in form doubling as a causal intervention that steers the behavior on demand.
Signal: dot products of states with concept directions; arithmetic on task vectors in weight space.
Cost: moderate. Vector construction is one or a few forward passes; evaluation and intervention are linear-algebraic.
What it answers: is a candidate direction causally sufficient (not just correlated) to drive the behavior? Promotes a probe direction into a controllable handle, and quantifies how much of the behavior the direction accounts for. In parameter space, the same view enables training-free model editing via task arithmetic.
Advantage: one direction serves both as a read-out (projection) and a write-in (addition), so monitoring, steering, and training-free model editing share the same handle, with no fine-tuning required and clean composition (add, subtract, negate).
Limitation: assumes concepts are linearly encoded — non-linear or entangled concepts are missed and additive edits spill into neighbouring features; directions are basis- and checkpoint-specific, and large edit strengths push the model off-distribution.
Submethods: Representation Engineering · Steering Vectors · Steering features · Parameter-Space Task Vectors.
Choosing among them — what gets manipulated: Parameter-Space Task Vectors edit the weights (a one-shot displacement in parameter space, applied before inference). The other three act on activations at inference time. Of those, Steering features and Steering Vectors both intervene on the input's own representation — Steering features directly amplifies/shrinks the model's existing internal feature for the target behavior, whereas Steering Vectors leaves the internal features untouched and instead adds an externally built direction (a CAA vector from contrastive pairs) into the residual stream. Representation Engineering is the read-and-write superset on the activation side: it extracts concept directions to both monitor (project) and steer (add) behavior.
4. Probing — ./probing/
Premise: train an auxiliary predictor (often linear) to decode a labeled property $y$ from an internal vector $\mathbf{z}$; treat the LLM as a frozen feature extractor.
Signal: probe accuracy or information-theoretic surrogate across candidate objects.
Cost: moderate. Requires a labeled dataset and probe training, but the LLM stays frozen.
What it answers: is property $y$ recoverable from this internal object by a restricted hypothesis class? Supports comparison across layers/heads/FFNs under a shared protocol. Decodability is not causality; follow-up causal tests are typically needed.
Advantage: with a fixed probe family, supports standardized layer-/head-wise comparisons under a single protocol; the LLM stays frozen, so broad sweeps are cheap and the probes themselves are interpretable.
Limitation: decodability is not causality — high probe accuracy does not mean the model actually uses the object, and results are sensitive to labels, token positions, and probe family, so causal follow-up tests are typically needed.
Submethods: Residual Stream States · SAE Feature Activation State.
5. Feature Dictionary Learning — ./feature-dictionary-learning/
Premise: re-base dense activations onto an over-complete, sparsely-active dictionary so that each atom is an interpretable, monosemantic feature: $\mathbf{a} \approx \mathbf{D},\mathbf{f}(\mathbf{a})$ with $|\mathbf{f}|_0 \ll m$.
Signal: per-token, per-feature firings of a trained sparse encoder.
Cost: high up-front (dictionary training is expensive, $m \gg d$); cheap to evaluate once trained.
What it answers: what are the monosemantic units of the model at this site, and how do they interact across sites? Underpins downstream tools — feature dashboards, circuit discovery via attribution graphs, SAE-based steering.
Advantage: replaces polysemantic neurons with a much more monosemantic basis; once trained, encoding and steering reduce to a single linear pass plus simple feature-weight edits, making feature dashboards, attribution-graph circuits, and SAE-style interventions tractable at LLM scale.
Limitation: dictionaries are expensive to train and suffer from dead, split, or absorbed features; reconstruction error leaves an "error term" that confounds full-circuit claims, and a dictionary trained on one site or checkpoint rarely transfers verbatim to another.
Practical rule: always search for an existing pre-trained SAE / transcoder / crosscoder for the target model first (e.g. on Hugging Face, SAELens, or the model's own release); do not train a dictionary from scratch unless the user explicitly asks for it.
Submethods: SAE · Transcoder · Crosscoder · ICA Lens
6. Gradient Detection — ./gradient-detection/
Premise: score internal objects with the sensitivity of a scalar target $F(x)$ with respect to the object, $s_j(x) = \phi(\nabla_{o_j} F(x), o_j)$.
Signal: gradient norm, gradient–input score, integrated gradients.
Cost: moderate. A small number of backward passes; much cheaper than exhaustive interventions.
What it answers: which objects are first-order influential on the target behavior? Produces fast rankings useful for narrowing the candidate set before a causal test. Local proxy only — not sufficient for functional necessity claims.
Advantage: applies to any object (inputs, activations, parameters) without extra training, needing only a backward pass; produces fast rankings that are far cheaper than exhaustive interventions, and can serve as a first-pass filter before more expensive methods like Causal Attribution.
Limitation: gradients are a local, first-order proxy — salience can be cancelled by downstream computation and finite interventions may diverge from first-order effects in non-linear regimes; results can be further validated with causal attribution.
Submethods: Inputs and Layer-wise States · Intermediate Outputs · Parameters.
7. Causal Attribution — ./causal-attribution/
Premise: intervene on an object and measure the resulting change in behavior.
Signal: effect of patching (replace with a counterfactual-derived activation), ablation (zero out / remove), or attribution patching (first-order approximation of patching).
Cost: expensive for exact patching/ablation; cheap for attribution patching.
What it answers: is this object causally necessary or sufficient for the behavior? The gold standard — but expensive enough that exact variants should usually be preceded by a cheaper screen.
Advantage: provides definitive evidence of functional responsibility — distinguishes components that actually drive a behavior from those that are merely active or correlated, which correlation-based methods cannot do.
Limitation: traditional patching/ablation cost scales linearly with the number of analyzed objects (one forward pass per intervention); Attribution Patching approximates the same effect with a single backward pass per task example, but is only first-order accurate. In practice, a cheaper method (e.g. Gradient Detection or Magnitude Analysis) is typically applied first to narrow the candidate set.
Practical rule:For long-response tasks (CoT, code, dialogue), each intervention has to be re-run through autoregressive decoding, so the cost is multiplied by the output length $T$ and Attribution Patching often becomes infeasible (it must back-propagate through the full $T$-step generation); the standard workaround is to reduce the metric to a single-position scalar — e.g. the next-token logit after the prompt or a fixed-template answer position — before sweeping interventions.
Submethods: Patching · Ablation · Attribution Patching.
8. Circuit Discovery — ./circuit-discovery/
Premise: a transformer's computation forms a graph of attention-head and MLP edges; the minimal subgraph that reproduces a target behavior is its circuit.
Signal: edge-level effect under iterative pruning (ACDC), gradient-attribution (EAP-IG), or sparse-feature replacement (transcoder-based).
Cost: moderate to expensive. EAP-IG runs in a few backward passes; ACDC scales linearly in edges; feature-based replacement adds the cost of training transcoders.
What it answers: which subgraph of edges is jointly necessary and sufficient for the behavior? Goes beyond per-component scoring to recover an end-to-end mechanism (e.g., factual recall, indirect-object identification).
Advantage: recovers a structured, end-to-end mechanism — not just which components matter but how they communicate — and the resulting subgraph can be checked for faithfulness on held-out tasks, supporting cross-model comparison and mechanism-level claims.
Limitation: the search space is over edges, so it is much more expensive than per-object localization; gradient-based shortcuts trade exactness for speed, and outcomes depend on the choice of task distribution, counterfactual inputs, and faithfulness metric.
Submethods: Intervention-based Edge Search (ACDC) · Attribution-based Edge Scoring (EAP-IG) · Feature-based Replacement Models (e.g. circuit-tracer; demo lives under ./feature-dictionary-learning/transcoder/).
9. SHAP — ./SHAP/
Premise: feature attribution as a coalition game — assign each input feature its Shapley value, the unique attribution that satisfies local accuracy, missingness, and consistency.
Signal: per-feature contributions $\phi_i$ to a single prediction $f(x)$, with $f(x) = \phi_0 + \sum_i \phi_i$.
Cost: model-dependent. Exact polynomial-time for tree ensembles (TreeSHAP); sample-based for arbitrary models (KernelSHAP); amortized neural surrogate for real-time use (FastSHAP).
What it answers: how does the model use each input feature for this prediction, on a scale that is comparable across model families? The standard tool for input-level feature importance and the reference framework that other attribution methods are compared against.
Advantage: unifies many ad-hoc attribution methods (LIME, DeepLIFT, LRP, classical Shapley) under one axiomatic framework, so explanations are comparable across model families; per-instance values aggregate into global importance, and tree models admit an exact polynomial-time estimator.
Limitation: exact computation is exponential in the number of features for arbitrary models, so estimators rely on sampling and assumptions about how "missing" features are modelled; values are correlational rather than causal, and the additive form obscures strong feature interactions.
Submethods: Foundational and Estimator-based SHAP · Extended SHAP (FastSHAP).
10. Neural Feature Learning — ./neural-feature-learning/
Premise: feature learning can be analysed without backpropagation through the Neural Feature Matrix $\mathbf{W}^\top\mathbf{W}$ and its empirical fingerprint, the expected gradient outer product $\mathbb{E}[\nabla f \nabla f^\top]$ (EGOP). Their alignment — the Deep Neural Feature Ansatz — predicts the directions a network has learned.
Signal: top eigenvectors of $\mathbf{W}^\top\mathbf{W}$ / EGOP; iterative kernel-EGOP fixed points (RFM); width-limit dynamics (NTK / NNGP / muP).
Cost: moderate to high. EGOP estimation requires per-sample Jacobians; infinite-width experiments are constrained by the choice of parameterization.
What it answers: how did the network learn its features, and can the same features be recovered without gradient descent? Connects classical kernel methods, infinite-width theory, and observed feature-learning behaviour in finite networks.
Advantage: gives a kernel-shaped view of feature learning that transfers across layers and widths; relies only on cheap input gradients, enabling backprop-free algorithms (RFM) and clean predictions in the infinite-width limits (NTK / NNGP / muP).
Limitation: the NFM-EGOP alignment is an empirical ansatz, not universal, and infinite-width predictions only approximate finite-width training when initialization scales and learning rates are tuned to the chosen parameterization; EGOP estimation is also expensive on high-dimensional inputs.
Submethods: Eigenvector Feature Direction (DNFA) · Gradient Outer Product (RFM) · Kernel/NTK Feature Regime (TP4) · Network as Filter (ConvRFM).
11. Multimodal-Specific Interpretability — ./multi-modal/
Premise: link an internal vision unit (neuron, channel, feature) to a natural-language concept via similarity to a text embedding from an aligned multi-modal model such as CLIP.
Signal: similarity scores between per-unit activation summaries and text-side embeddings of an open-vocabulary concept set.
Cost: moderate. Requires a probing image set and a forward pass through the alignment model; no fine-tuning of the analyzed network.
What it answers: what named concepts drive a vision (or vision-language) model's predictions, and how do those concepts compose into attribution graphs? Turns anonymous tensors into human-readable explanations that compose with attribution and steering.
Advantage: outsources the language side to a pre-trained vision-language model (e.g. CLIP), so labels come from an open-vocabulary concept set without crowdsourced annotation; the resulting concept-level handles compose cleanly with attribution and steering for concept-conditional heatmaps and feature visualisations.
Limitation: inherits the alignment model's biases — anything CLIP cannot embed cleanly (fine-grained categories, novel domains, low-resource languages, abstract qualifiers) yields noisy or empty rankings; results are correlational and depend on the choice of probing images and concept set, so causal follow-ups are typically needed.
Practical rule: most of the families in §1–§10 above already apply directly to both text-only LLMs and multimodal models — pick them whenever the analysis is about layers / heads / neurons / features regardless of modality. Reach for this section only when the goal is vision-specific and requires concept-level natural-language labels of internal units (neurons / channels / SAE features) via CLIP-style cross-modal alignment.
Submethods: CLIP-Dissect · Zennit-CRP.
Selecting a Method
Match the question to the family:
| Research question | Start with | Why |
|---|
| "Which components are prominent for this behavior?" | Magnitude Analysis | Cheapest screen; surfaces candidates without interventions |
| "What semantic content does this state carry, without labels?" | Vocabulary Projection | Zero-shot, no training, intuitive |
| "Is property $y$ linearly decodable from this layer/head?" | Probing | Standardized cross-layer comparison under a fixed probe family |
| "Is this object a first-order influencer of the target?" | Gradient Detection | Fast ranking with a few backward passes |
| "Is this object causally necessary for the behavior?" | Causal Attribution | Gold standard; use after a cheaper method has narrowed the set |
| "Which subgraph of edges is necessary and sufficient for this behavior?" | Circuit Discovery | Recovers an end-to-end circuit at the edge level |
| "What are the monosemantic feature units of the model at this site?" | Feature Dictionary Learning | Trains a sparse, over-complete basis whose atoms are interpretable |
| "Is a direction (in activations or parameters) sufficient to control the behavior?" | Representation and Parameter Analysis | Tests directional sufficiency via additive intervention or task arithmetic |
| "How does this network learn its features, and can a kernel reproduce them?" | Neural Feature Learning | Backprop-free analysis through the NFM / EGOP and width-limit dynamics |
| "How does the model use each input feature for this prediction?" | SHAP | Game-theoretic input attribution, model-agnostic on a comparable scale |
| "What named concepts drive this vision model's predictions?" | Multimodal-Specific Interpretability | Open-vocabulary concept labelling via CLIP-style alignment |
If the question spans multiple granularities (prompt tokens, residual stream, attention heads, neurons, SAE features, parameters, weights), consult the submethod tables inside each family's SKILL.md — granularity is the primary axis along which submethods are organized.
Reminder: choosing a family in this table is step 1 of the Loading Protocol. Before doing anything else, open that family's SKILL.md. Before running a specific submethod, open the submethod's SKILL.md. No exceptions.
Cross-round family selection
When the task carries a record of families already tried for this behavior + mechanism direction (e.g. families_already_settled: in EXPERIMENT_PLAN.md, derived from the cross-round memory):
- Skip settled families. Do not route to a
(direction, family) already shown confirmed or refuted for this behavior+direction; pick a different family that probes the still-open question. A family left inconclusive is not settled — it stays a retry candidate (optionally with a refined submethod).
- An explicit user/plan family pin overrides this avoidance. If the task pins a family (e.g.
family: Steering Vectors), route to it directly. Deciding whether to honor a pin that collides with an already-confirmed/refuted family for this behavior+direction is the caller's responsibility — act on whatever honor-or-replace decision the caller hands you, and do not raise that confirmation yourself.
Practical Tips
1. Finding an SAE for the Target Model
Check whether a Sparse Autoencoder has already been released for the target model — and for which layers. If one exists, use it to locate the target feature: SAE features are far more monosemantic and interpretable than directions read off the raw backbone activations, and intervening on them usually gives a cleaner, stronger effect.
Search local disk first (existing model/SAE caches, e.g. the Hugging Face cache or the project's own weights directory), and only download if nothing is found locally.
Commonly used public SAEs:
If no SAE covers the target model, fall back to a feature identified directly in the model's own activations — the same direct-intervention procedure applies, without the encode/decode step.
2. Token Position for Steering Vectors
Match the pooling site to where the behavior is encoded.
- Last token: default for prompt-based extraction — autoregressive models concentrate next-token signal at the final input position.
- Mean over response tokens: pair a positive and negative response to the same input, then average hidden states across response positions only (exclude the shared prefix). Use when the behavior spans the full sequence rather than a single token.
- Head / MLP output: if extracting from a head or MLP output instead of the residual stream, match pooling to the claim's granularity (last-token for next-token effects, mean-pool for sequence-level properties).
3. Choosing the Intervention Layer
Start where representations are richest for the target behavior, then refine.
- Default range: middle (~40–60% depth) to middle-to-late (~60–80%) layers. By this depth the residual stream carries compositional representations but has not yet committed to the output distribution, so additive interventions redirect behavior without breaking syntax/fluency.
- Task-specific refinement: if the default sweep fails, treat layer index as a hyperparameter. Use probing accuracy or gradient-based localization (§6 Gradient Detection) to narrow candidates before running full intervention sweeps.
4. Calibrating Intervention Strength
Find the magnitude that reliably elicits the target effect, judged jointly by a target metric and a general capability metric. Re-tune from scratch whenever layer, position, or method changes — the optimum may not transfer.
- Non-monotonic response: too small → no effect (signal drowned out); moderate → target behavior peaks; too large → fluency/coherence degrade, then the target effect itself collapses as activations go off-distribution.
- Sweep procedure:
- Start small (e.g., α = 1 for a steering vector on a normalized residual stream) and increase geometrically (1 → 2 → 4 → 8 → 16 → 32 …), not in fixed steps.
- At each step, log the target metric (e.g., target-behavior rate on held-out probes) and a capability metric (e.g., perplexity or benchmark score).
- Pick the smallest α that meets the target while capability drop stays within tolerance (e.g., < 5–10%) — not the α where the target metric peaks.
- Same recipe for SAE feature scaling or activation patching — sweep the coefficient or patch fraction.
- Layer–magnitude coupling: earlier layers need larger multipliers; later layers saturate sooner. Always re-sweep when the site changes.
- Suppression: subtracting a direction follows the same sweep; large negative multipliers produce symmetric off-distribution failures.
Composing Families
Mechanism work is rarely done in a single family. A common screen-to-verify pipeline:
- Screen with a cheap method — Magnitude Analysis or Vocabulary Projection or Gradient Detection — to narrow the candidate set of layers / heads / neurons / features.
- Decode with Probing or Vocabulary Projection or Multimodal-Specific Interpretability to confirm the candidates carry the property of interest.
- Verify with Causal Attribution or Representation and Parameter Analysis to establish necessity / sufficiency via interventions.
- Recover an end-to-end mechanism with Circuit Discovery if the claim is about how multiple components interact.
- Re-base with Feature Dictionary Learning when polysemantic neurons obscure the analysis, then re-run steps 2-4 in feature space.
Neural Feature Learning sits adjacent to this pipeline as a theoretical lens on how the features being analyzed came to exist; SHAP sits adjacent for input-side attribution that complements internal-side mechanism work.
Directory Layout
Each family lives in a folder whose name matches the path given in its section heading above (e.g. ### 1. Vocabulary Projection — ./vocabulary-projection/); submethod folders are named exactly as listed in that section's Submethods: line. The full visual tree is mirrored in ./layout.md.
A typical family folder follows this two-level shape:
<family>/
├── SKILL.md # family-level routing skill
├── article_references.md # canonical papers for the whole family
└── <submethod>/
├── article_references.md # narrower paper list for this submethod (when present)
├── scripts/ # runnable demo scripts (.py)
└── references/ # library/API documentation for the demo
└── api_reference.md
SKILL.md — the authoritative description of the family or submethod, and the mandatory load target at each level of the cascade (see Loading Protocol). Always read the family SKILL.md immediately after choosing a family, and the submethod SKILL.md immediately after choosing a submethod — the routing summaries in this file are deliberately too thin to plan from.article_references.md — a curated list of the originating papers (with links). A family-level file gives the umbrella reading list; submethod-level files (where present) narrow it to that specific technique. Use these to ground methodological choices and to cite source work.scripts/ — reference implementations illustrating API usage and experimental patterns of the demo library bundled with this submethod. They are starting points, not turnkey pipelines: adapt them to the project's specific model, dataset, and metrics rather than copying verbatim.references/ — local documentation of the demo's underlying library (typically api_reference.md), kept alongside the scripts so the demo can be understood and reproduced without external lookup. Distinct from article_references.md: papers vs. library docs.
