academic-citation

Search, verify, and map citations for CS/AI/ML papers. Produces VERIFIED/UNVERIFIED reference lists with Citation-to-Claim maps and Exemplar Sets. Use when: finding references for a paper section, ver

SKILL.md

GitHub

Academic Citation

将此 skill 视为"文献取证代理",而不是搜索结果搬运器。

Router Protocol

  1. Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
  2. Read every file listed under always_load. These are the skill's binding rules — not reference material.
  3. Apply the loaded material as constraints:
    • stance.md defines non-negotiable rules, source/inference boundary, and scope.
    • red-lines.md defines absolute prohibitions. Do not negotiate these.
    • output-contract.md defines deliverables per mode.
    • anti-patterns.md defines known failure modes and their correct alternatives.
  4. If the user wants to use a local literature library, first distinguish:
    • local_ref_md_dir: an existing Markdown library containing _index_ref.json.
    • local_ref_pdf_dir: a PDF directory, or any local library directory that lacks _index_ref.json.
  5. For local_ref_pdf_dir, stop before citation search. Tell the user to register a MinerU API token, set MINERU_API_TOKEN, run scripts/convert-pdfs-to-md.py, and return only after they confirm PDF→MD completion. Do not proceed to local reading until the generated MD directory has _index_ref.json.
  6. Detect the workflow using the manifest's workflow axis. Literature reading output must separate source quotes from agent inference; only source: 原文 or source: 图片 content may be used as citation evidence.
  7. Echo the selected mode to the user before executing.
  8. Reach for references/ only when the manifest's references.on_demand condition is satisfied.

Modes

Mode Use when
full-citation-pass Complete coverage for a full paper or core section
targeted-citation-search Specific claim, section, or topic
exemplar-set-only Build Exemplar Set only, not full citation list
citation-verification Verify metadata of existing candidate list
local-citation-pass Local MD library first, then web supplement
citation-verification-with-reading Full-text reading after paper draft completion

Agent Dispatch

Agent Purpose
agents/citation_agent.md Literature search strategy (4-class query templates, output schema)
agents/literature-reader-agent.md Literature reading & extraction (MD full-text → LiteratureReadingReport)

Dispatched by academic-paper-writer orchestrator at Step 3. Subagents search and verify only; they must not modify project files or write paper prose independently. literature-reader-agent is dispatched in parallel by citation_agent or the orchestrator at Step 3a/3b.

Independent Use

Input Mode Priority Behavior
Section + keywords full-citation-pass 1 (explicit) Full 6-step workflow
Citation list / seed papers citation-verification 1 (explicit) Metadata only, no extra search
local_ref_md_dir provided and _index_ref.json exists local-citation-pass 2 (path trigger) Local MD + batch parallel reader agent dispatch
Local PDF library path provided, or local path lacks _index_ref.json pdf2md-preflight 1 (blocking preflight) Instruct MinerU setup and script command; wait for user confirmation
Section only targeted-citation-search 3 (single feature) Auto-keyword, 4-class query
Explicit Exemplar Set request exemplar-set-only 1 (explicit) Exemplar Set only

Multi-condition: lower priority number wins.

Scenario Recommended
Just searching/verifying citations This skill (standalone)
Integrating into paper drafting academic-paper-writer orchestrator
Existing draft needs citation review This skill → academic-reviser