prose-cluster-hybrid-citation-fix

Anchors orphaned LaTeX bibitems into prose via grouped citation insertion and compile verification.

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill prose-cluster-hybrid-citation-fix-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prose-cluster-hybrid-citation-fix
Source: https://github.com/yakeworld/Synthos/tree/main/skills/private/prose-cluster-hybrid-citation-fix
Command: npx skills add https://github.com/yakeworld/Synthos --skill prose-cluster-hybrid-citation-fix-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Academic manuscripts often contain bibliography entries (\bibitem) that were generated but never cited in the text, leaving orphan references that break citation integrity. This Skill fixes the hybrid case where dense prose paragraphs and method sections lack formal \cite anchors by mapping each bibitem to a precise text anchor and inserting grouped citations. ## Core Features & Use Cases - Citation-to-Anchor Mapping: Builds a cite-key/topic/section/anchor mapping table so every bibitem gets a defined insertion location in the IMRaD structure. - Clustered Batch Insertion: Merges same-topic references into a single \cite{a,b,c} at one anchor, uses exact-phrase string replacement in dense prose, and appends explanatory sentences after method \subsection headings. - Verification Loop: Runs a Python script computing cite/bibitem intersection coverage (D10a) and orphan counts, then double-compiles with pdflatex and checks the log for undefined references. - Use Case: A paper.tex has 9 unanchored bibitems (e.g., raissi19, iahn17) and prose-only author-year mentions; the Skill inserts grouped citations, reports D10a 100% with zero orphans, and confirms a clean double pdflatex compile. ## Quick Start Fix the unanchored bibliography entries in 01-manuscript/paper.tex by mapping each bibitem to a text anchor, inserting grouped citations, and verifying with the orphan-check script and a double pdflatex compile.

Frequently Asked Questions about prose-cluster-hybrid-citation-fix

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

FAQPage Schema
How do I fix uncited bibitems in a LaTeX paper?

Build a mapping table linking each bibitem key to a topic, section, and exact text anchor, then insert \cite commands at those anchors via string replacement. Verify by comparing the set of cited keys against bibitem keys until orphans reach zero.

How to insert multiple citations at one location in LaTeX?

Combine same-topic references into a single \cite{key1,key2,key3} at one anchor instead of repeating citations sentence by sentence. For methodology clusters, place the grouped citation after the relevant \subsection heading with an explanatory sentence.

How do I check for orphan bibliography entries in LaTeX?

Run a Python script that extracts all \bibitem keys and all \cite keys with regex, then computes the set difference. Any bibitem key not appearing in the cited set is an orphan that needs an in-text anchor.

Why does pdflatex need to run twice for citations?

The first pass writes citation and cross-reference data to auxiliary files, and the second pass resolves them. After both passes, grep the log for "undefined" to confirm all references resolved; the count should be zero.

When should I not use anchor-based string replacement for citations?

Avoid it when the paper has no prose anchor points at all, such as a pure inline variant where bibitems have no contextual location in text. In that case use a manual mapping approach that assigns each bibitem to its contextual section first.