paper-refbib-stub

Convert multi-search-engine JSON results into sanitized BibTeX entries with DOI and arXiv identifiers.

6.8k|540|Updated May 6, 2026
One-click install
npx skills add https://github.com/opensquilla/opensquilla --skill paper-refbib-stub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-refbib-stub
Source: https://github.com/opensquilla/opensquilla/tree/main/src/opensquilla/skills/bundled/paper-refbib-stub
Command: npx skills add https://github.com/opensquilla/opensquilla --skill paper-refbib-stub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Turning raw web search results into a usable bibliography is tedious and error-prone: search snippets contain untrusted text, duplicate DOIs, and missing years that corrupt BibTeX files. This Skill converts normalized multi-search-engine JSON into a clean, minimal BibTeX file automatically.

Core Features & Use Cases

  • JSON to BibTeX Conversion: Reads a multi-search-engine JSON payload on stdin and emits one @misc{} entry per result with deterministic keys (ref1, ref2, ...).
  • Identifier Preservation: Extracts and normalizes real DOIs, arXiv IDs (modern and legacy), authors, corporate authors, and publication years when available; unknown years are omitted rather than invented.
  • Deduplication and Sanitization: Collapses duplicate DOI records to a single entry and neutralizes control characters, embedded BibTeX fragments, and unbalanced braces from untrusted search text.
  • Use Case: After running a literature search across multiple engines, pipe the normalized JSON results through this Skill to produce paper/references.bib with provenance notes that downstream citation-integrity gates can audit.

Quick Start

Pipe the JSON output of your multi-engine paper search into this Skill to generate a sanitized references.bib file with DOI and arXiv metadata preserved.

Frequently Asked Questions about paper-refbib-stub

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

FAQPage Schema
How do I convert search results to BibTeX automatically?

Pipe a JSON document with a results array into the json_to_bib.py script via stdin. Each result becomes an @misc entry keyed ref1, ref2, and so on, written to the file specified by the --out argument.

How to generate a references.bib from multi-engine paper search output?

Normalize your search results into JSON with title, url, and optional doi, authors, and year fields, then feed it to this converter. It preserves DOIs and arXiv IDs as structured BibTeX fields and records the source domain in the note field.

Does the BibTeX converter handle duplicate DOI entries?

Yes. DOIs are normalized case-insensitively and tracked in a seen set, so repeated DOI records emit only the first entry. This keeps citation keys unique and deterministic across runs.

What happens when a search result has no publication year?

The year field is omitted entirely rather than guessed. Only values matching a four-digit year pattern are written, so malformed or missing years never produce fabricated citation data.

Can untrusted search snippets corrupt the generated BibTeX file?

No. Control characters, backticks, backslashes, embedded BibTeX entry fragments, and unbalanced braces are neutralized before emission, and URL delimiters are percent-encoded. Truncated snippets cannot break the bibliography structure.