academic-citation

Name: academic-citation
Author: joshua-zyy

101stars1forks

How to install academic-citation?

joshua-zyy/academic-paper-writer/academic-citation

$npx -y skills add joshua-zyy/academic-paper-writer --skill academic-citation

Installs into the current project.

Summary

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 l

Files · 1

View on GitHub

SKILL.md

1	# Academic Citation
2
3	将此 skill 视为"文献取证代理"，而不是搜索结果搬运器。
4
5	## Router Protocol
6
7	1. Read `manifest.yaml`. It declares `always_load` files, `axes`, and `references.on_demand`.
8	2. Read every file listed under `always_load`. These are the skill's binding rules — not reference material.
9	3. Apply the loaded material as constraints:
10	- `stance.md` defines non-negotiable rules, source/inference boundary, and scope.
11	- `red-lines.md` defines absolute prohibitions. Do not negotiate these.
12	- `output-contract.md` defines deliverables per mode.
13	- `anti-patterns.md` defines known failure modes and their correct alternatives.
14	4. If the user wants to use a local literature library, first distinguish:
15	- `local_ref_md_dir`: an existing Markdown library containing `_index_ref.json`.
16	- `local_ref_pdf_dir`: a PDF directory, or any local library directory that lacks `_index_ref.json`.
17	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`.
18	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.
19	7. Echo the selected mode to the user before executing.
20	8. Reach for `references/` only when the manifest's `references.on_demand` condition is satisfied.
21
22	## Modes
23
24	\| Mode \| Use when \|
25	\|---\|---\|
26	\| `full-citation-pass` \| Complete coverage for a full paper or core section \|
27	\| `targeted-citation-search` \| Specific claim, section, or topic \|
28	\| `exemplar-set-only` \| Build Exemplar Set only, not full citation list \|
29	\| `citation-verification` \| Verify metadata of existing candidate list \|
30	\| `local-citation-pass` \| Local MD library first, then web supplement \|
31	\| `citation-verification-with-reading` \| Full-text reading after paper draft completion \|
32
33	## Agent Dispatch
34
35	\| Agent \| Purpose \|
36	\|---\|---\|
37	\| `agents/citation_agent.md` \| Literature search strategy (4-class query templates, output schema) \|
38	\| `agents/literature-reader-agent.md` \| Literature reading & extraction (MD full-text → LiteratureReadingReport) \|
39
40	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.
41
42	## Independent Use
43
44	\| Input \| Mode \| Priority \| Behavior \|
45	\|---\|---\|---\|---\|
46	\| Section + keywords \| full-citation-pass \| 1 (explicit) \| Full 6-step workflow \|
47	\| Citation list / seed papers \| citation-verification \| 1 (explicit) \| Metadata only, no extra search \|
48	\| `local_ref_md_dir` provided and `_index_ref.json` exists \| local-citation-pass \| 2 (path trigger) \| Local MD + batch parallel reader agent dispatch \|
49	\| 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 \|
50	\| Section only \| targeted-citation-search \| 3 (single feature) \| Auto-keyword, 4-class query \|
51	\| Explicit Exemplar Set request \| exemplar-set-only \| 1 (explicit) \| Exemplar Set only \|
52
53	Multi-condition: lower priority number wins.
54
55	\| Scenario \| Recommended \|
56	\|---\|---\|
57	\| Just searching/verifying citations \| This skill (standalone) \|
58	\| Integrating into paper drafting \| academic-paper-writer orchestrator \|
59	\| Existing draft needs citation review \| This skill → academic-reviser \|

People who liked this also viewed

6 picks

Type

academic-citation

101stars1forks

View on GitHub

How to install academic-citation?

joshua-zyy/academic-paper-writer/academic-citation

$npx -y skills add joshua-zyy/academic-paper-writer --skill academic-citation

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Academic Citation
2
3	将此 skill 视为"文献取证代理"，而不是搜索结果搬运器。
4
5	## Router Protocol
6
7	1. Read `manifest.yaml`. It declares `always_load` files, `axes`, and `references.on_demand`.
8	2. Read every file listed under `always_load`. These are the skill's binding rules — not reference material.
9	3. Apply the loaded material as constraints:
10	- `stance.md` defines non-negotiable rules, source/inference boundary, and scope.
11	- `red-lines.md` defines absolute prohibitions. Do not negotiate these.
12	- `output-contract.md` defines deliverables per mode.
13	- `anti-patterns.md` defines known failure modes and their correct alternatives.
14	4. If the user wants to use a local literature library, first distinguish:
15	- `local_ref_md_dir`: an existing Markdown library containing `_index_ref.json`.
16	- `local_ref_pdf_dir`: a PDF directory, or any local library directory that lacks `_index_ref.json`.
17	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`.
18	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.
19	7. Echo the selected mode to the user before executing.
20	8. Reach for `references/` only when the manifest's `references.on_demand` condition is satisfied.
21
22	## Modes
23
24	\| Mode \| Use when \|
25	\|---\|---\|
26	\| `full-citation-pass` \| Complete coverage for a full paper or core section \|
27	\| `targeted-citation-search` \| Specific claim, section, or topic \|
28	\| `exemplar-set-only` \| Build Exemplar Set only, not full citation list \|
29	\| `citation-verification` \| Verify metadata of existing candidate list \|
30	\| `local-citation-pass` \| Local MD library first, then web supplement \|
31	\| `citation-verification-with-reading` \| Full-text reading after paper draft completion \|
32
33	## Agent Dispatch
34
35	\| Agent \| Purpose \|
36	\|---\|---\|
37	\| `agents/citation_agent.md` \| Literature search strategy (4-class query templates, output schema) \|
38	\| `agents/literature-reader-agent.md` \| Literature reading & extraction (MD full-text → LiteratureReadingReport) \|
39
40	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.
41
42	## Independent Use
43
44	\| Input \| Mode \| Priority \| Behavior \|
45	\|---\|---\|---\|---\|
46	\| Section + keywords \| full-citation-pass \| 1 (explicit) \| Full 6-step workflow \|
47	\| Citation list / seed papers \| citation-verification \| 1 (explicit) \| Metadata only, no extra search \|
48	\| `local_ref_md_dir` provided and `_index_ref.json` exists \| local-citation-pass \| 2 (path trigger) \| Local MD + batch parallel reader agent dispatch \|
49	\| 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 \|
50	\| Section only \| targeted-citation-search \| 3 (single feature) \| Auto-keyword, 4-class query \|
51	\| Explicit Exemplar Set request \| exemplar-set-only \| 1 (explicit) \| Exemplar Set only \|
52
53	Multi-condition: lower priority number wins.
54
55	\| Scenario \| Recommended \|
56	\|---\|---\|
57	\| Just searching/verifying citations \| This skill (standalone) \|
58	\| Integrating into paper drafting \| academic-paper-writer orchestrator \|
59	\| Existing draft needs citation review \| This skill → academic-reviser \|

People who liked this also viewed

6 picks

Type