mechanism-audit

Audit mechanistic interpretability experiment rigor per claim using cross-model LLM review.

75|7|Updated May 2, 2026
One-click install
npx skills add https://github.com/zjunlp/Mechanist --skill mechanism-audit-zjunlp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mechanism-audit
Source: https://github.com/zjunlp/Mechanist/tree/main/skills/mechanism-audit
Command: npx skills add https://github.com/zjunlp/Mechanist --skill mechanism-audit-zjunlp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Mechanistic interpretability experiments can pass an honest evaluation audit while the underlying mechanism is mis-extracted, mis-scaled, or mis-applied — for example, a steering coefficient that was never swept, or a large alpha whose apparent effect is actually out-of-distribution collapse. This Skill audits the mechanism rigor itself, per claim, so downstream readers do not update on artifacts of under-tuned interventions. ## Core Features & Use Cases - Per-Claim Mechanism-Rigor Verdict: Scopes the audit to one claim's milestones, scripts, and outputs, then returns a PASS/WARN/FAIL/N/A verdict on that claim's mechanism rigor. - Steering Coefficient Sweep Check (Check A): Verifies that additive activation interventions (steering, CAA, DAS, RepE, SAE feature scaling, activation patching, ROME) used a swept alpha grid, logged capability metrics, identified a usable plateau, and locked alpha mid-plateau, with checks B–F reserved for future rigor dimensions. - Independent Cross-Model Review: The executor only collects claim-scoped artifacts; an external LLM reviewer via the llm-chat MCP reads the code and judges rigor, keeping the executor out of the verdict. - Use Case: After running a steering-vector experiment for claim C1, invoke the audit on refine-logs/ with -- claim C1 to produce MECHANISM_AUDIT.md and MECHANISM_AUDIT.json, which a caller like /auto-verify combines with the methodology audit via max-severity. ## Quick Start Run /mechanism-audit on your experiment directory with -- claim C1 and an optional -- output-dir to receive a per-claim mechanism-rigor verdict report.

Frequently Asked Questions about mechanism-audit

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

FAQPage Schema
How do I audit steering coefficient sweep rigor in an interpretability experiment?

Invoke /mechanism-audit with the experiment directory and -- claim <Cx>. The skill detects additive activation interventions, collects the sweep config, per-alpha outputs, and direction-extraction code, then has an external LLM reviewer judge the sweep against eight audit questions and return PASS, WARN, or FAIL.

What is the difference between mechanism-audit and experiment-audit?

experiment-audit checks evaluation methodology honesty such as ground-truth provenance and score normalization, while mechanism-audit checks whether the interpretability mechanism itself was properly tuned, such as coefficient sweeps and capability metrics. Both write into the same per-claim audit directory and their verdicts are combined by max severity.

How do I configure the external reviewer model for mechanism-audit?

Set mcpServers.llm-chat.env.LLM_MODEL, LLM_BASE_URL, and LLM_API_KEY in the project .mcp.json or user ~/.claude/settings.json, or export them as shell environment variables. The skill resolves them in that priority order and aborts if none is found when a check is triggered.

When does mechanism-audit return an N/A verdict?

It returns N/A when the claim's experiment uses no mechanism intervention, such as a pure dataset evaluation, because no implemented check triggers. In that case the reviewer is never called, and N/A is treated as PASS when combined with other audit verdicts.

What causes a FAIL verdict on the steering coefficient sweep check?

FAIL occurs when a single hardcoded alpha is used with no sweep, no capability metric is logged so collapse cannot be detected, alpha is chosen in the collapse range or within baseline noise, or an asymmetric sign protocol is flattened into uniform push.