
paper-verification
Use when the user wants to verify paper claims against code or data, audit numerical accuracy, check formula-code alignment, or validate citation accuracy. Triggers on phrases like "verify claims", "check numbers", "do the numbers match", "formula vs code", "audit the paper", or "cross-check results".
- Installs
- 75
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/fcakyon/phd-skills --skill paper-verification- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads paper-verification automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Paper Verification Methodology
You are helping a researcher verify that their paper accurately reflects their code and experimental results. This is the most critical quality control step in academic writing.
Verification Dimensions
1. Numerical Accuracy Audit
For every number in the paper (dataset sizes, metric values, percentages, counts):
- Extract the number and its context from the .tex file
- Trace it to its source: code output, result file, log, or tracking system
- Verify the value matches exactly (watch for rounding, percentage vs decimal)
- Flag any number that cannot be traced to a source
Template:
| Paper claim | Location (.tex) | Source file/code | Source value | Match? |
|-------------|-----------------|-----------------|-------------|--------|
| "13,999 frames" | abstract L3 | len(glob(labels/*.json)) | ? | ? |
| "4.2% improvement" | Table 2 | eval_results.json | ? | ? |
Common numerical errors:
- Rounding inconsistencies (3.14 in text, 3.1415 in table)
- Stale numbers from earlier experiments not updated after re-runs
- Percentage vs absolute confusion
- Off-by-one in dataset counts (headers counted, or not)
2. Terminology Consistency Audit
- Extract all defined terms from the methods section
- Search for each term across ALL sections
- Flag any inconsistent usage:
- Same concept, different names (e.g., "tag head" vs "classification head")
- Same name, different meanings across sections
- Defined but never used, or used but never defined
3. Code-Paper Alignment
For each method described in the paper:
- Find the corresponding code (function, class, module)
- Compare the paper's description with the actual implementation
- Check specifically:
- Algorithm steps match code flow
- Hyperparameters in text match config/code defaults
- Architecture descriptions match model code
- Loss functions in equations match loss code
- Training procedures match training scripts
Common mismatches:
- Paper describes an idealized version, code has edge cases not mentioned
- Hyperparameters changed during development but paper not updated
- Paper describes a method that was later modified or removed from code
4. Formula-Code Verification
For each equation in the paper:
- Identify the equation and its variables
- Find the code that implements it
- Map each mathematical operation to its code equivalent
- Verify:
- Summation bounds match loop bounds
- Division operations handle edge cases
- Normalization factors match
- Gradient flow matches (detach, no_grad)
- Reduction operations (mean vs sum) match
5. Citation Fact-Checking Protocol
For each citation in the paper:
Step 1: Extract the claim and the cited paper
Use paper-search tool get_crossref_paper_by_doi <doi> to retrieve the cited record. For an arXiv paper, use paper-search download arxiv <id> and paper-search read arxiv <id>. See setup if the CLI is missing. Inspect the PDF itself when text extraction loses table or equation layout.
Step 2: Verify BibTeX metadata against DBLP:
- Author names (exact spelling, correct order)
- Paper title (exact, from published version not preprint)
- Venue and year (confirmed against actual publication)
Step 3: For cited claims with specific numbers:
- Locate the exact table/figure in the cited paper
- Verify the number matches what the citing paper states
- If the number cannot be confirmed, suggest qualitative language instead
Step 4: Check for common citation errors:
- Citing preprint when published version exists
- Wrong year (submission vs publication)
- Author name misspellings
- Citing for a claim the paper doesn't actually make
Verification Process
- Read the full paper (or specified sections)
- Build the verification table for each dimension
- For each entry, read the source and verify
- Produce a prioritized issue list:
- HIGH: Incorrect numbers, wrong claims, missing citations
- MEDIUM: Terminology inconsistencies, stale but close numbers
- LOW: Minor formatting, optional improvements
Output Format
Produce a structured verification report:
- Summary: X issues found (Y high, Z medium, W low)
- Numerical audit table: each number with source and match status
- Terminology issues: inconsistent terms with locations
- Code-paper mismatches: description vs implementation gaps
- Citation issues: metadata errors and unverified claims
- Suggested fixes: specific text replacements for each issue
FAQ
What does the paper-verification skill do?
Use when the user wants to verify paper claims against code or data, audit numerical accuracy, check formula-code alignment, or validate citation accuracy. Triggers on phrases like "verify claims", "check numbers", "do the numbers match", "formula vs code", "audit the paper", or "cross-check results".
How do I install paper-verification?
Run npx skills add https://github.com/fcakyon/phd-skills --skill paper-verification in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/paper-verification/ (personal) or .claude/skills/paper-verification/ (project).
Which AI agents can use paper-verification?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is paper-verification safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains paper-verification?
It is published by fcakyon in fcakyon/phd-skills. It has 75 recorded installs.
More from fcakyon/phd-skills
paper-writing
fcakyon/phd-skills
Open the skill to read its SKILL.md instructions.
literature-research
fcakyon/phd-skills
Use when the user wants to find related work, survey a research area, identify literature gaps, or discover open-source implementations. Triggers on phrases like "find papers on", "related work", "literature review", "what papers exist", "open source implementation", or "papers with code".
experiment-design
fcakyon/phd-skills
Use when the user wants to design experiments, plan ablation studies, structure baselines, or create incremental evaluation strategies. Triggers on phrases like "design ablation", "plan experiment", "what experiments should I run", "baseline comparison", or "experiment matrix".
reviewer-defense
fcakyon/phd-skills
Use when the user wants to anticipate reviewer questions, select the strongest ablations to present, prepare rebuttals, or identify paper weaknesses before submission. Triggers on phrases like "reviewer questions", "anticipate reviewers", "rebuttal", "paper weaknesses", "defend the paper", or "strengthen the paper".
latex-setup
fcakyon/phd-skills
Use when the user wants to set up or troubleshoot a LaTeX environment, choose between biber and bibtex, install packages for a specific venue template, or configure compilation. Triggers on phrases like "setup latex", "biber vs bibtex", "latex compilation error", "install latex packages", "venue template", or "texlive setup".
Popular education & science skills
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
scaffold-exercises
mattpocock/skills
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
paper-context-resolver
lllllllama/rigorpilot-skills
Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.
caveman-learn
juliusbrussee/caveman
Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.
gsap-plugins
greensock/gsap-skills
Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.