Skip to content
Research
Command

/xray

Multi-dimensional paper audit — spawns 5 parallel sub-agents to check numerical accuracy, terminology consistency, code-paper alignment, citation accuracy, and evaluation integrity.

BOOST
From plugin
phd-skills
4236 skills2 agents6 commands
Install
> /plugin marketplace add fcakyon/phd-skills
> /plugin install phd-skills@phd-skills

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/xray

Context preview

What this command does when you run it.

Multi-dimensional paper audit — spawns 5 parallel sub-agents to check numerical accuracy, terminology consistency, code-paper alignment, citation accuracy, and evaluation integrity.

Command definition

xray.md
description: >
  Multi-dimensional paper audit — spawns 5 parallel sub-agents to check
  numerical accuracy, terminology consistency, code-paper alignment,
  citation accuracy, and evaluation integrity.
allowed-tools: Agent, Read, Glob, Grep, Bash, WebSearch, WebFetch

Paper X-Ray Audit

You are performing a multi-dimensional audit of a research paper against its codebase and experimental results.

Step 1: Discover Paper Files

Find all .tex files in the project:

  • Use Glob to find `**/*.tex` files
  • Identify the main .tex file (usually imports other sections)
  • Find .bib files for citation checking
  • Find result files (JSON, CSV, logs) for numerical verification

Step 2: Launch Parallel Audits

Spawn **5 sub-agents in parallel**, each handling one audit dimension. Each agent should return a structured list of findings rated HIGH/MEDIUM/LOW.

Agent 1: Numerical Accuracy

Task: Extract every number from the .tex files (dataset sizes, metric values, percentages, counts). For each number, trace it to its source in the codebase — a result file, code output, config, or tracking system. Report any number that doesn't match its source or cannot be traced.

Agent 2: Terminology Consistency

Task: Extract all technical terms defined in the methods section. Search for each term across ALL sections of the paper. Flag inconsistent usage: same concept with different names, same name with different meanings, defined but unused terms, or used but undefined terms.

Agent 3: Code-Paper Alignment

Task: For each method or algorithm described in the paper, find the corresponding code implementation. Compare the paper's description with the actual code. Check that hyperparameters, architecture details, loss functions, and training procedures match between paper and code.

Agent 4: Citation Accuracy

Task: Read the .bib file. For each entry, verify author names, venue, and year against web search or DBLP. For cited claims in the .tex files that include specific numbers, check whether those numbers appear in the cited paper. Flag unverified metadata and unsupported cited claims.

Agent 5: Evaluation Integrity

Task: Review the evaluation code and result files. Check for: data leakage between train/val/test splits, off-by-one errors in metric computation, wrong aggregation methods (micro vs macro), mismatched ground-truth and prediction alignment, zero-division edge cases, and results that don't reproduce from the evaluation scripts.

Step 3: Consolidate Results

After all agents return, merge their findings into a single prioritized list:

Output Format

## X-Ray Audit Results

### HIGH Priority (must fix before submission)
1. [Dimension] Finding description — suggested fix

### MEDIUM Priority (should address)
1. [Dimension] Finding description — suggested fix

### LOW Priority (nice to have)
1. [Dimension] Finding description — suggested fix

Step 4: Auto-Fix Offer

For HIGH priority issues that have clear fixes (wrong numbers, typos, stale values):

  • Show the exact .tex location and current text
  • Show the verified correct value from the source
  • Ask the user for confirmation before applying fixes
Read more
Ships withphd-skills

Catch AI mistakes before they cost weeks of compute. Reproduce papers from arxiv. Debug runs evidence-first. Compare experiments at the right epoch. Launch with discipline.

Get the whole plugin

Other commands on phd-skills.

factcheck
Command

factcheck

Verify BibTeX entries and cited claims against DBLP and web sources. Checks author names, venues, years, and specific numerical…

@fcakyon@fcakyonInstall Command
fortify
Command

fortify

Select strongest ablations and anticipate reviewer questions. Reads paper and experiment results to prepare for peer review.

@fcakyon@fcakyonInstall Command
gaps
Command

gaps

Literature gap analysis with web confirmation. Takes a research topic or question and maps existing work to find what's missing.

@fcakyon@fcakyonInstall Command
help
Command

help

Show all phd-skills features, commands, skills, agents, and hooks at a glance. Use for in-session discoverability.

@fcakyon@fcakyonInstall Command
setup
Command

setup

30-second auto-detection tour, then optional configuration of notifications, CLI allowlist, research CLAUDE.md rules, and LaTeX…

@fcakyon@fcakyonInstall Command