本文へ移動
cccskills
無料GitHub で公開

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".

インストール方法を見る

含まれるファイル(1)

  • SKILL.md4.9 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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):

  1. Extract the number and its context from the .tex file
  2. Trace it to its source: code output, result file, log, or tracking system
  3. Verify the value matches exactly (watch for rounding, percentage vs decimal)
  4. 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

  1. Extract all defined terms from the methods section
  2. Search for each term across ALL sections
  3. 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:

  1. Find the corresponding code (function, class, module)
  2. Compare the paper's description with the actual implementation
  3. 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:

  1. Identify the equation and its variables
  2. Find the code that implements it
  3. Map each mathematical operation to its code equivalent
  4. 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

  1. Read the full paper (or specified sections)
  2. Build the verification table for each dimension
  3. For each entry, read the source and verify
  4. 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:

  1. Summary: X issues found (Y high, Z medium, W low)
  2. Numerical audit table: each number with source and match status
  3. Terminology issues: inconsistent terms with locations
  4. Code-paper mismatches: description vs implementation gaps
  5. Citation issues: metadata errors and unverified claims
  6. Suggested fixes: specific text replacements for each issue

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

compare

無料

Same-epoch comparison of training runs across wandb, neptune, tensorboard, or mlflow. Aligns runs at the student's current step (never current-vs-final-of-baseline) and separates proxy metrics from downstream targets. Use when the user asks to compare runs, check if a run is improving, track lag against a baseline, rank experiments, or evaluate run-vs-run performance.

日本語の概要は準備中です。原文の説明を表示しています。

fcakyon/phd-skills4162026年10月12日 更新

Use when the user wants to analyze dataset bias, create stratified samples, evaluate fairness, or plan dataset collection. Triggers on phrases like "dataset bias", "stratified sample", "class imbalance", "data distribution", "fairness analysis", or "ethical review".

日本語の概要は準備中です。原文の説明を表示しています。

fcakyon/phd-skills4162026年10月12日 更新

debug

無料

Evidence-before-action diagnosis of failing ML experiments. Probes the system before guessing causes, process list, dmesg, GPU stats, log scrollback, checkpoint state, then states a hypothesis as a hypothesis and runs a smoke before claiming a root cause. Use when the user asks why a run is failing, diverging, OOMing, hanging, slow, producing weird metrics, has crashed, or asks to debug, diagnose, troubleshoot, or investigate a training issue.

日本語の概要は準備中です。原文の説明を表示しています。

fcakyon/phd-skills4162026年10月12日 更新

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".

日本語の概要は準備中です。原文の説明を表示しています。

fcakyon/phd-skills4162026年10月12日 更新

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".

日本語の概要は準備中です。原文の説明を表示しています。

fcakyon/phd-skills4162026年10月12日 更新

launch

無料

Pre-flight checklist for long-running ML training jobs covering config diff, run naming, path verification, monitoring setup, and restart-cleanup. Use when the user asks to launch, kick off, start, restart, or kill a training run, or mentions launching a multi-hour or multi-day GPU job (python train, accelerate launch, torchrun, deepspeed, sbatch, tmux training).

日本語の概要は準備中です。原文の説明を表示しています。

fcakyon/phd-skills4162026年10月12日 更新

fcakyon のスキルをすべて見る

このスキルの問題を報告する