paper-citation-integrity-gate

Validates citation-map summaries against numeric citation targets with deterministic pass/block verdicts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Academic paper writing workflows need a trustworthy check that the bibliography actually meets the required citation count, without relying on an LLM's self-assessment. This gate deterministically compares the citation_map SUMMARY against the declared CITATION_TARGET and blocks the pipeline when coverage is insufficient or entries are invalid.

Core Features & Use Cases

  • Deterministic Citation Audit: Parses the machine-readable SUMMARY line of a citation map and compares distinct cited keys against the integer CITATION_TARGET extracted from the paper contract.
  • Quality Classification Checks: Verifies that strong, ok, weak, and invalid counts sum to the total cited keys, blocking on any weak or invalid entries while reporting unused bibliography entries as warnings.
  • Use Case: In an automated meta-paper-write pipeline, after generating a citation map, run this gate to confirm at least 40 valid sources are cited before allowing the draft to proceed to final rendering.

Quick Start

Run the citation integrity gate on my citation map to verify the paper meets its citation target before continuing.

Frequently Asked Questions about paper-citation-integrity-gate

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

FAQPage Schema
How do I verify a paper meets its citation count requirement automatically?

Run a deterministic audit script that parses the citation map's SUMMARY line and compares total cited keys against the CITATION_TARGET declared in the paper contract. It returns a pass verdict only when coverage meets the target and no entries are weak or invalid.

What input format does the citation integrity check expect?

The gate reads a JSON object from stdin containing a citation_map string with exactly one machine-readable SUMMARY line, plus a paper_contract or paper_preferences field containing CITATION_TARGET as an integer. Missing or malformed fields produce a block verdict.

Can unused bibliography entries fail the citation audit?

No, unused bibliography entries are reported as warnings, not blockers. The audit only blocks when cited keys fall below target, when entries are classified weak or invalid, or when the SUMMARY fields are missing or inconsistent.

Why does the citation gate block when weak or invalid keys exist?

Weak or invalid cited keys indicate unreliable sources, so the gate treats any nonzero weak or invalid count as a blocker regardless of total coverage. This enforces citation quality, not just quantity, before the paper draft proceeds.

What are the limits of the citation target validation?

The CITATION_TARGET must be a machine-readable integer between 1 and 500; values outside that range cause a block. The check is purely numeric and structural, so it does not assess the actual scholarly relevance of cited sources.