skills.rest
raghavamohan
raghavamohanCOMMUNITY
Explore all skills by this author →
GitHub

check-references

Validates study bibliographies, local reference mirrors, and generated PDF links for integrity.

Updated Jun 12, 2026
Search Tags:#bibliography#citations#link checking#reference validation#integrity audit#pdf links#academic studies
One-click install
npx skills add https://github.com/raghavamohan/AnalyticMadhyasthDarshan --skill check-references-raghavamohan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: check-references
Source: https://github.com/raghavamohan/AnalyticMadhyasthDarshan/tree/main/.cursor/skills/check-references
Command: npx skills add https://github.com/raghavamohan/AnalyticMadhyasthDarshan --skill check-references-raghavamohan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Broken bibliography entries, missing local reference files, and bad links inside generated study PDFs are easy to miss when editing academic studies. This Skill runs the repository's reference check suite so citation and link problems are caught before committing bibliography or reference-file changes. ## Core Features & Use Cases - Bibliography and link validation: Checks ## References entries and every ../References/... link in study bodies against local mirror files, flagging empty, corrupt, or bot-wall HTML saved as PDF. - PDF link auditing: Verifies generated study PDFs contain no file:// links and that stable site links resolve to usable sources, with a --skip-pdf option and single-study --study <Slug> filtering. - Companion-note coverage guidance: Explains that canonical suites do not cover technical/research notes, and how to check those bibliographies and PDF annotations directly. - Use Case: After downloading new reference mirrors and editing a study's bibliography, run the suite to confirm every citation resolves, then regenerate affected PDFs before committing. ## Quick Start Ask the assistant to run the reference integrity checks on the study you just edited and report any broken bibliography entries or PDF links.

Frequently Asked Questions about check-references

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

FAQPage Schema
How do I check reference links in a study before committing?▼

Run python Scripts/_check_references.py from the repository root to validate bibliographies, markdown links, mirror files, and PDF links. For a single study, pass --study <Slug> to scope the check and speed it up while drafting.

How do I verify references for only one study?▼

Use python Scripts/_check_references.py --study <Slug>, for example --study Nature-Of-Time. Add --skip-pdf when the study PDFs have not been regenerated yet and you only want bibliography and mirror checks.

What counts as a broken or unusable reference file?▼

A local mirror is unusable when it is empty, too small, or a PDF whose content starts with <!DOCTYPE, meaning a publisher bot-wall HTML page was saved as a .pdf. Missing files should first be resolved through manifest-backed storage before being treated as broken.

Does the reference check cover companion technical notes?▼

No. The check and audit scripts enumerate canonical <Slug>/<Slug>.md studies only, so companion notes need direct inspection of their bibliographies, body links, and generated PDF annotations. Report those results separately from the canonical suite.

Why does the reference check pass but a citation still seem wrong?▼

Link integrity and quotation matching do not verify the meaning of a paraphrase, translation, or synthesis. A passing check only confirms files and links resolve; substantive source review requires the review-study workflow and manual inspection of the source.

What should I do when a reference check fails?▼

Re-download empty or corrupt files with the download-references workflow, resolve manifest-backed storage for missing files, or switch the entry to an external DOI/URL and document it in References/NOT-DOWNLOADED.md. Regenerate affected study PDFs after fixing markdown or mirrors.

Related Skills

Explore More Education & Research Skills→
alohaysalohays
5

validate-bib

Validate bibliography entries and citation links in LaTeX and Quarto files.

Community
Intermediate
open-haxopen-hax
6

opencode-sdk

Regenerate OpenCode SDKs after server or API contract changes.

Official
Intermediate
nealcarennealcaren

verifier

Verify quotes and claims in manuscripts against source documents.

Community
Advanced
issdandavisissdandavis
6

scbe-crosstalk-reliability

Audit SCBE cross-talk JSON packets, JSONL lane bus entries, and markdown mirrors for consistency.

Community
Intermediate