Citation Verification Guide
Galaxy-Dawn/claude-scholar
Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.
Verifies that every reference in a manuscript is real, correctly identified and actually supports its claim, and produces a citation registry for typesetting.
$ npx skills add Light0305/Light-skills --skill light-citation -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Light0305/Light-skills light-citation --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Light0305/Light-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/light-citation .claude/skills/light-citation && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "light-citation" agent skill from https://github.com/Light0305/Light-skills/tree/master/skills/light-citation into .claude/skills/light-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "light-citation", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Light0305/Light-skills/tree/master/skills/light-citationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Light0305/Light-skills --skill light-citation -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Light0305/Light-skills light-citation --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Light0305/Light-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/light-citation .agents/skills/light-citation && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "light-citation" agent skill from https://github.com/Light0305/Light-skills/tree/master/skills/light-citation into .agents/skills/light-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "light-citation", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Light0305/Light-skills --skill light-citation -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Light0305/Light-skills light-citation --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Light0305/Light-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/light-citation .cursor/skills/light-citation && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "light-citation" agent skill from https://github.com/Light0305/Light-skills/tree/master/skills/light-citation into .cursor/skills/light-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "light-citation", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Light0305/Light-skills.git --path skills/light-citation--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Light0305/Light-skills --skill light-citation -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Light0305/Light-skills light-citation --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Light0305/Light-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/light-citation .gemini/skills/light-citation && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "light-citation" agent skill from https://github.com/Light0305/Light-skills/tree/master/skills/light-citation into .gemini/skills/light-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "light-citation", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Light0305/Light-skills light-citationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Light0305/Light-skills --skill light-citation -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Light0305/Light-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/light-citation .github/skills/light-citation && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "light-citation" agent skill from https://github.com/Light0305/Light-skills/tree/master/skills/light-citation into .github/skills/light-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "light-citation", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Light0305/Light-skills --skill light-citation -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Light0305/Light-skills light-citation --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Light0305/Light-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/light-citation .opencode/skills/light-citation && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "light-citation" agent skill from https://github.com/Light0305/Light-skills/tree/master/skills/light-citation into .opencode/skills/light-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "light-citation", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
light-citationVerifies that every reference in a manuscript is real, correctly identified and actually supports its claim, and produces a citation registry for typesetting.
This is stage 10 of a research-writing workflow. It treats formatting, metadata existence, publication-integrity facts and semantic support as four separate questions. Input comes from the paper-writing stage and includes claim locators, the manuscript and reference candidates. Output is a canonical citation registry, BibTeX, CSL JSON, source-level evidence, failure records, a claim-edge review, a citekey audit and a findings file.
The rules are strict: never invent a reference, DOI or locator, and never treat a network failure or index miss as proof that a work does not exist. A reference is marked CONFIRMED only when registration metadata and at least one independent source agree, and CONFIRMED-MISSING only when the DOI registration agency reports non-existence and both Crossref and DataCite return 404 or 410; otherwise it stays UNAVAILABLE or UNRESOLVED. Confirmed missing works and chimeric citations form the one critical gate, while metadata conflicts, update alerts and formatting issues only warn. A `delivery.json` with hashes goes to typesetting.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 6b44f57. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 7 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
pythonFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Citation Verification loads about 3.4k tokens when it runs, and up to ~5.4k if it reads all its reference files. Until then it costs about 143 tokens; SKILL.md has 1,348 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from Light0305/Light-skills at commit 6b44f57, republished under its MIT licence (© Light0305). 1,348 words, ~3,358 tokens.
.claude/skills/light-citation/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.Make every author-used reference traceable, real, correctly identified, and honestly connected to the claim it is supposed to support. Treat formatting, metadata existence, publication-integrity facts, and semantic support as four different questions.
Read citation-resource-map.md before a full
manuscript audit. Read
references/registry_contract.md before
producing or consuming the canonical registry. Read
references/locator_audit.md before judging
claim support.
light.paper_claims.v1, exact claim/source locators,
current claim text hashes, reviewer-bound citation-support hashes,
manuscript, figures/tables, supplement, and reference candidates.light.citation_registry.v1, BibTeX, CSL JSON, source-level evidence,
failure records, claim-edge review, citekey audit, and
light.findings.v1(producer=citation).citation_verify: confirmed missing works
and chimeric citations. Metadata conflicts, unavailable sources, claim
relevance, formatting, and publication-update alerts are warn/skip.ROUTES has no key 10; never invent a
back-edge.references.bib, citekey-audit.json, registry and delivery.json to
typesetting. Typesetting compiles and checks keys; it does not re-decide
authenticity. delivery.json must declare status and per-deliverable
sha256: hashes so typesetting can reject stale or edited handoffs.CONFIRMED-MISSING only when DOI Registration Agency explicitly
reports non-existence and Crossref plus DataCite both return 404/410.CONFIRMED only when registration metadata and at least one
independent field source confirm the work. Otherwise retain
UNAVAILABLE or UNRESOLVED.updated-by; the notice carries inverse update-to.SUPPORTS requires a locator-backed semantic review.Use the claim map, manuscript, figures/tables and supplement together:
python scripts/citation_registry.py \
--claim-map claim_plan.json \
--draft paper.tex \
--figure figure_notes.md \
--supplement supplement.md \
--refs-spec citation_input.json \
--out-dir citation-deliveryPreserve claim_id, exact claim, claim locator, artifact path, occurrence
locator, citekey and raw identifier. Use
templates/citation_input.json when the
project has no reference spec.
Normalize DOI, arXiv, PMID, ISBN and URL. Deduplicate exact works. Keep arXiv, accepted manuscript, versioned dataset and published DOI as explicit versions under one work only when the inputs establish the relationship. If not established, keep them separate and mark the relationship unresolved.
python scripts/verify_refs.py \
--spec citation_input.json \
--self-author Smith \
--out verify.jsonUse Crossref or DataCite as the registration source. Use PubMed, Semantic
Scholar, or configured OpenAlex as the independent field source. Keep each
endpoint, HTTP status, outcome, timestamp and returned fields in
source_evidence,并保存实际参与判定的 normalized-field SHA-256。Crossref polite-pool
email、OpenAlex/Semantic Scholar key 只用于请求,绝不写入 endpoint、registry 或日志。
Interpret status exactly:
| Status | Meaning | Action |
|---|---|---|
CONFIRMED | registration source + independent field source | eligible for canonical BibTeX/CSL |
CONFIRMED-MISSING | DOI RA explicit non-existence + Crossref/DataCite 404 | critical; replace or delete |
UNAVAILABLE | transport/rate/auth/5xx prevents lookup | retry or use another free source |
UNRESOLVED | partial evidence or second source incomplete | investigate; do not call verified |
Compare the author's cited title, authors and year against registration
metadata. Inspect field_conflicts source by source. Keep the user's raw
citation unchanged until a human resolves the conflict.
Treat these as chimeric critical:
Treat a single title translation, subtitle, year-online/year-print difference, author omission or ordering issue as metadata warning unless corroborating evidence establishes a chimera.
Inspect publication_updates. Confirm relation direction with both the
affected work and notice DOI when the alert matters. Record type, notice DOI,
source and direction. Send those facts to research-ethics; do not label a
correction notice itself retracted because it has update-to.
Use
templates/claim_citation_review.json
and the original full text:
supports: the cited locator supports the claim as written;partial: only a narrower statement is supported;related_only: same topic, but not evidence for this proposition;unsupported: the source contradicts or does not support it;review_required: full text/locator/reviewer is missing.Each review must record access, a real non-placeholder source_locator,
source_evidence_sha256, reviewer, an already-occurred ISO reviewed_at, and
reviewed_claim_sha256 for the exact claim text that was reviewed. The registry
also emits the current claim_text_sha256; the two hashes must match, otherwise
the review is stale and is downgraded to REVIEW_REQUIRED. SUPPORTS without
those fields, with a future reviewed_at, with a template/absolute/escaping
locator, or with a mismatched claim hash is downgraded to REVIEW_REQUIRED by
the registry/gate; metadata-only access can never support a claim. If access is only ABSTRACT_ONLY, SUPPORTS also requires
support_scope=ABSTRACT_EXPLICIT or abstract_claim_explicit=true; otherwise
the registry/gate downgrades it to REVIEW_REQUIRED. Check direction,
population, intervention, comparator, metric, time, modality, causal strength
and scope. Change the claim or citation when related-only or unsupported. Do
not promote an abstract-level heuristic to final support.
Normalize the four gates explicitly before delivery:
python scripts/citation_four_gate.py \
--registry citation-delivery/citation-registry.json --as-of 2026-07-05
# 或仅调试模板合约:
python scripts/citation_four_gate.py \
--input templates/citation-four-gate.example.json --as-of 2026-07-05The public template is intentionally UNKNOWN and must exit 1. A later gate
can never repair an earlier failure: existence → identity → directed
publication status → locator-backed claim support. Prefer --registry so the
four-gate records are derived from the canonical registry rather than a hand
copied template. ABSTRACT_ONLY may be
direct only when the declared claim is explicitly present in the abstract;
metadata alone never supports a claim. Retracted work may document historical
record but cannot silently support a current conclusion.
Run the registry online after inputs are complete:
python scripts/citation_registry.py \
--claim-map claim_plan.json --draft paper.tex \
--refs-spec citation_input.json --online \
--out-dir citation-delivery
python scripts/citekey_audit.py \
--tex paper.tex --bib citation-delivery/references.bib --jsonOnly confirmed, non-chimeric works enter generated BibTeX/CSL. Preserve every
failure and unresolved review in separate artifacts. The generated
delivery.json is DELIVERED only when citation-failures.json and
claim-citation-review.json are empty and the citekey audit is OK; otherwise
it exposes ERROR or REVIEW_REQUIRED. Use doi_to_any.py for one-off DOI
content negotiation and formatting, not as proof of semantic support.
python scripts/citation_verify_gate.py \
--registry citation-delivery/citation-registry.json \
--tex paper.tex --bib citation-delivery/references.bib \
--report citation_findings.json
python ../light-orchestrator/scripts/run_checkpoint.py \
--file .light/passport.yaml --stage 10 \
--findings citation_findings.json --write --ts <ISO-8601>Expect citation_verify_gate.py to return exit 1 on a critical finding.
Repair the registry root cause, rebuild all derived artifacts, rerun the gate,
then rerun the same stage-10 checkpoint. Deliver only after the checkpoint
passes and passport records delivered.
| Script | Responsibility |
|---|---|
citation_registry.py | inventory, normalization, version grouping, verification orchestration, claim edges, registry/BibTeX/CSL/evidence/failure/delivery |
verify_refs.py | authoritative multi-source fields, honest status machine, source evidence, conflicts, chimeras, Crossref update direction |
citation_verify_gate.py | stage-10 findings producer; exit 1 on confirmed missing/chimeric |
citekey_audit.py | manuscript ↔ .bib key audit; reused by typesetting |
doi_to_any.py | DOI content negotiation and citation-format output |
verify_citation_edge.py | paper A→B open-index relation; never claim support |
citation_four_gate.py | ordered existence/identity/update/support contract with purpose-aware retraction handling; can derive records directly from light.citation_registry.v1 |
citation-resource-map.md: executable order and resource tiers.references/registry_contract.md: machine artifact semantics.references/locator_audit.md: human semantic-support protocol.references.md: API/style/reference-manager details; load only the relevant
section.templates/*: author input and review contracts.assets/citation_checklist.md: final human checklist.docs/competitors/citation.md: R1 evidence and comparative claims, not an
execution guide.updated-by direction is correct; notices are not inverted.SUPPORTS edge has source evidence SHA-256, reviewer,
non-future reviewed_at, matching claim_text_sha256/reviewed_claim_sha256
and non-metadata access, with no template/absolute/escaping locator.--registry unless there is a documented reason to use a hand-written fixture.delivery.json records status plus sha256: hashes for every
deliverable consumed by typesetting.© Light0305, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 15 other files (scripts, references, assets) in skills/light-citation of Light0305/Light-skills.
Open the folder on GitHubat commit 6b44f57
Citation Verification next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Citation Verification this skillLight0305/Light-skills | 640 | — | ~3.4k | Automated safety check: Pass | MIT | |
| Citation Verification GuideGalaxy-Dawn/claude-scholar | 5.7k | 2 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Citation Managementforyourhealth111-pixel/Vibe-Skills | 3.6k | — | ~7.6k | Automated safety check: Notes | MIT | |
| Citation ManagementK-Dense-AI/claude-scientific-writer | 2.4k | 2 repos | ~3.9k | Automated safety check: Notes | MIT | |
| Citation Managementneflibata-feng/MyArxiv-Agent | 126 | 19 repos | ~8.1k | Automated safety check: Notes | MIT | |
| Academic Paper Writing PipelineImbad0202/academic-research-skills | 51k | — | ~16k | Automated safety check: Pass | Custom licence |
Galaxy-Dawn/claude-scholar
Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.
foryourhealth111-pixel/Vibe-Skills
Turns DOIs, PMIDs and arXiv IDs into clean BibTeX, searches Google Scholar and PubMed, and checks and deduplicates a reference list.
K-Dense-AI/claude-scientific-writer
Finds papers in OpenAlex, PubMed and Google Scholar, turns DOIs, PMIDs and arXiv IDs into clean BibTeX, and validates citations for a manuscript or thesis.
neflibata-feng/MyArxiv-Agent
Comprehensive citation management for academic research. An agent skill from neflibata-feng/MyArxiv-Agent.
Imbad0202/academic-research-skills
Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.
Ar9av/PaperOrchestra
Step 3 of the PaperOrchestra pipeline (arXiv:2604.05018). An agent skill from Ar9av/PaperOrchestra.
Light0305/Light-skills
Coordinates and recovers multi-stage Light research projects from a single passport file, with checkpoints, stale-work tracking and rerouting only when you approve.
Light0305/Light-skills
Builds an evidence-backed invention disclosure packet from a project or research result for attorney or patent-agent review, without giving legal advice.
Light0305/Light-skills
Audits, scaffolds and safely migrates research project folder structures, keeping existing repositories read-only until you approve exact moves from a plan.
Light0305/Light-skills
Prepares draft materials for a China software copyright registration from a real project: application worksheet, source deposit plan, operation manual and consistency checks.
Light0305/Light-skills
Evidence-based workflow for designing or modernizing a software system: current-state inventory, options, API and schema contracts, migration plans, ADRs and verification.
Light0305/Light-skills
Build and preflight submission-ready LaTeX/PDF artifacts for Light stage 11.
Categories
Verifies that every reference in a manuscript is real, correctly identified and actually supports its claim, and produces a citation registry for typesetting. This is stage 10 of a research-writing workflow. It treats formatting, metadata existence, publication-integrity facts and semantic support as four separate questions.
Citation Verification fits situations like: auditing a manuscript bibliography for fabricated or mixed-up citations; checking DOIs, arXiv IDs or PMIDs against authoritative sources; checking whether a cited source really supports the claim attached to it; preparing BibTeX and a citation registry for typesetting.
Run `npx skills add Light0305/Light-skills --skill light-citation -a claude-code`. Or copy the skill folder (skills/light-citation in Light0305/Light-skills) into .claude/skills/light-citation in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Light0305/Light-skills --skill light-citation -a codex`. Or copy the skill folder (skills/light-citation in Light0305/Light-skills) into .agents/skills/light-citation in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Light0305/Light-skills --skill light-citation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/light-citation, .gemini/skills/light-citation, .github/skills/light-citation and .opencode/skills/light-citation in your project.
Going by SKILL.md and its folder, Citation Verification needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python to run the bundled verification scripts; Network access to Crossref, DataCite and other authoritative sources.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Citation Verification is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.4k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Citation Verification: Citation Verification Guide (Galaxy-Dawn/claude-scholar, 5.7k stars), Citation Management (foryourhealth111-pixel/Vibe-Skills, 3.6k stars), Citation Management (K-Dense-AI/claude-scientific-writer, 2.4k stars) and Citation Management (neflibata-feng/MyArxiv-Agent, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Light0305 (a GitHub user) maintains it in Light0305/Light-skills, which has 640 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on July 6, 2026.
Source: Light0305/Light-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.