# 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, verifying citation accuracy, building exemplar sets for introduction/related work learning, checking if existing citations are real and accurate, supplementing local literature library. Triggers on: 找引用…

- **Type:** Skill
- **Install:** `agentstack add skill-joshua-zyy-academic-paper-writer-academic-citation`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [joshua-zyy](https://agentstack.voostack.com/s/joshua-zyy)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [joshua-zyy](https://github.com/joshua-zyy)
- **Source:** https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation

## Install

```sh
agentstack add skill-joshua-zyy-academic-paper-writer-academic-citation
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [joshua-zyy](https://github.com/joshua-zyy)
- **Source:** [joshua-zyy/academic-paper-writer](https://github.com/joshua-zyy/academic-paper-writer)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-joshua-zyy-academic-paper-writer-academic-citation
- Seller: https://agentstack.voostack.com/s/joshua-zyy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.