nsfc-ref-alignment

Validates citation-bibliography consistency and semantic alignment in NSFC LaTeX proposals.

2.7k|251|Updated Feb 12, 2024
One-click install
npx skills add https://github.com/huangwb8/ChineseResearchLaTeX --skill nsfc-ref-alignment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nsfc-ref-alignment
Source: https://github.com/huangwb8/ChineseResearchLaTeX/tree/main/skills/nsfc-ref-alignment
Command: npx skills add https://github.com/huangwb8/ChineseResearchLaTeX --skill nsfc-ref-alignment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bibtexparser, PyYAML, and includes scripts (resource) components.

What problem does it solve?

NSFC grant proposals in LaTeX often contain broken citations, missing BibTeX keys, malformed DOIs, or sentences that cite papers whose content does not actually support the claim. Manually auditing every \cite command across a multi-file proposal is slow and error-prone. This Skill performs a read-only audit of citations and references, producing a structured review report without touching your .tex or .bib files.

Core Features & Use Cases

  • Deterministic integrity checks: Parses the full \input/\include dependency tree, extracts every citation command, and detects missing bibkeys, duplicate entries, missing required fields (title/author/year), and invalid DOI formats.
  • Optional online DOI verification: Queries Crossref and OpenAlex to confirm DOI existence and flag title mismatches between your BibTeX entry and the registered metadata.
  • AI-assisted semantic review: Generates a structured JSON input so the host AI can judge, per citation, whether the sentence's claim actually matches the cited paper, flagging P0/P1 risks like misattribution or overclaiming.
  • Use Case: Before submitting an NSFC proposal, run the audit on projects/NSFC_General to receive a report listing all missing bibkeys, suspicious DOIs, and sentences whose citations need manual re-checking.

Quick Start

Ask the AI to use nsfc-ref-alignment to check citation reliability for your proposal at projects/NSFC_General in read-only mode, outputting only a review report to ./references.

Frequently Asked Questions about nsfc-ref-alignment

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

FAQPage Schema
How do I check for missing BibTeX keys in a LaTeX project?

Run the read-only audit on your project root; it parses the \input/\include tree from main.tex, extracts all \cite commands, and reports every bibkey not found in your .bib files as a P0 issue with file and line locations.

How to verify DOI authenticity in BibTeX entries?

Enable the verify_online option to query Crossref and OpenAlex for each cited DOI. The check confirms the DOI exists and compares the registered title against your BibTeX title, flagging mismatches below a similarity threshold.

Does this tool modify my .tex or .bib files?

No, it is strictly read-only by default. It writes intermediate artifacts to a .bensz-api task directory and a final review report to ./references, and explicitly forbids writes to .tex, .bib, .cls, and .sty files.

Can it detect citations that do not match the cited paper's content?

Yes, it generates a structured JSON pairing each citation sentence with the entry's metadata so the host AI can judge semantic alignment. It flags P0 risks like misattribution and P1 risks like overclaiming, but the judgment is done by the AI, not the script.

What happens if bibtexparser is not installed?

The script falls back to a best-effort manual BibTeX parser and emits a single warning. Core checks like missing keys, duplicates, and required fields still work, though deeply nested brace fields may parse less reliably.

When should I not use this citation audit approach?

Do not use it if you want automatic rewriting of sentences or automatic bibkey replacement, since it only produces a review report. For completing missing BibTeX entries, use a bibliography management skill first, then run this audit.