Recommend Citations From Text
Read the target text, decide which claims need support, recommend appropriate references, and produce a citation intake document that can be reused when adding entries to a BibTeX file later.
Do not invent papers, titles, or links. Verify each recommended source before presenting it. When browsing is available, prefer primary sources such as publisher pages, arXiv, conference pages, journal landing pages, or official project pages.
Workflow
1. Read and segment the text
- Work paragraph by paragraph or sentence by sentence.
- Mark the exact span that needs support. Use one of these anchors:
- A short quoted phrase from the text
- A sentence opening
- A sentence index within the paragraph
- Separate different evidence needs:
- definition or background claim
- factual statement or statistic
- method choice
- comparison with prior work
- broad field overview
2. Choose citation strategy
- Prefer the smallest useful set of citations.
- Match source type to the claim:
- Use a seminal or standard reference for canonical definitions and classic methods.
- Use a recent survey for broad summaries when the text synthesizes a subfield.
- Use recent primary papers for current empirical claims, benchmarks, and trends.
- Use the original source for datasets, tools, models, and named methods when possible.
- When one sentence makes multiple claims, either:
- recommend one source that supports all of them, or
- split the sentence into multiple citation anchors and say so explicitly.
3. Recommend references
- For each anchor, provide:
- recommended paper title
- stable link
- brief reason it fits this claim
- suggested insertion position
- If confidence is limited, say why, for example:
- the paragraph is too broad
- the claim needs a domain-specific paper
- the text is making a statement that should be softened instead of cited
4. Mark insertion positions clearly
- Use placement notes that are easy to map back into the draft:
after sentence 2 in paragraph 1
after "transformer-based sequence modeling"
end of the first paragraph
replace generic cite at paragraph 3 sentence 1
- If the best edit is to split or rewrite a sentence before citing, say that directly.
5. Create or update the citation intake document
- Keep a running document for later BibTeX entry.
- Record exactly these fields for each candidate reference:
ID
Source text anchor
Suggested insertion location
Paper title
Link
Why this source
Status
- Default status values:
to-add
already-in-bib
needs-review
rejected
- When no log exists yet, initialize one with:
python scripts/create_citation_log.py --output /absolute/path/to/citation-intake.md --title "Citation Intake"
- Then append rows manually or programmatically in the same structure.
Output Format
Return two things:
- A concise recommendation list in chat or in the working artifact.
Use this shape when no stricter format is requested:
1. Anchor: "..."
Suggested insertion: ...
Paper: ...
Link: ...
Rationale: ...
- A citation intake document path.
Use the template in
assets/citation-log-template.md or create one with scripts/create_citation_log.py.
Resource Notes
scripts/create_citation_log.py
- Create a reusable Markdown intake sheet for citation collection.
- Use
--append to keep an existing log and add a fresh empty section header for another pass.
assets/citation-log-template.md
- Copy or adapt this template when a lightweight manual log is enough.
Handoff to BibTeX Work
- After the intake sheet is ready, use the recorded title and link to add the final entry into a
.bib file.
- If the task is specifically about appending normalized entries into a bibliography, hand off to
bibtex-reference-adder after this skill finishes the recommendation and intake stages.
1---2name: recommend-citations-from-text3description: Recommend supporting references for a paragraph, section, draft, outline, or claim list, identify the best citation insertion points, and record the selected papers with title, link, and placement notes for later BibTeX entry. Use when Codex needs to read prose and answer requests such as "find citations for this text", "tell me where to insert references", "recommend papers for this paragraph", or "make a citation intake sheet before updating a .bib file".4---56# Recommend Citations From Text78Read the target text, decide which claims need support, recommend appropriate references, and produce a citation intake document that can be reused when adding entries to a BibTeX file later.910Do not invent papers, titles, or links. Verify each recommended source before presenting it. When browsing is available, prefer primary sources such as publisher pages, arXiv, conference pages, journal landing pages, or official project pages.1112## Workflow1314### 1. Read and segment the text1516- Work paragraph by paragraph or sentence by sentence.17- Mark the exact span that needs support. Use one of these anchors:18 - A short quoted phrase from the text19 - A sentence opening20 - A sentence index within the paragraph21- Separate different evidence needs:22 - definition or background claim23 - factual statement or statistic24 - method choice25 - comparison with prior work26 - broad field overview2728### 2. Choose citation strategy2930- Prefer the smallest useful set of citations.31- Match source type to the claim:32 - Use a seminal or standard reference for canonical definitions and classic methods.33 - Use a recent survey for broad summaries when the text synthesizes a subfield.34 - Use recent primary papers for current empirical claims, benchmarks, and trends.35 - Use the original source for datasets, tools, models, and named methods when possible.36- When one sentence makes multiple claims, either:37 - recommend one source that supports all of them, or38 - split the sentence into multiple citation anchors and say so explicitly.3940### 3. Recommend references4142- For each anchor, provide:43 - recommended paper title44 - stable link45 - brief reason it fits this claim46 - suggested insertion position47- If confidence is limited, say why, for example:48 - the paragraph is too broad49 - the claim needs a domain-specific paper50 - the text is making a statement that should be softened instead of cited5152### 4. Mark insertion positions clearly5354- Use placement notes that are easy to map back into the draft:55 - `after sentence 2 in paragraph 1`56 - `after "transformer-based sequence modeling"`57 - `end of the first paragraph`58 - `replace generic cite at paragraph 3 sentence 1`59- If the best edit is to split or rewrite a sentence before citing, say that directly.6061### 5. Create or update the citation intake document6263- Keep a running document for later BibTeX entry.64- Record exactly these fields for each candidate reference:65 - `ID`66 - `Source text anchor`67 - `Suggested insertion location`68 - `Paper title`69 - `Link`70 - `Why this source`71 - `Status`72- Default status values:73 - `to-add`74 - `already-in-bib`75 - `needs-review`76 - `rejected`77- When no log exists yet, initialize one with:7879```bash80python scripts/create_citation_log.py --output /absolute/path/to/citation-intake.md --title "Citation Intake"81```8283- Then append rows manually or programmatically in the same structure.8485## Output Format8687Return two things:88891. A concise recommendation list in chat or in the working artifact.90Use this shape when no stricter format is requested:9192```markdown931. Anchor: "..."94 Suggested insertion: ...95 Paper: ...96 Link: ...97 Rationale: ...98```991002. A citation intake document path.101Use the template in `assets/citation-log-template.md` or create one with `scripts/create_citation_log.py`.102103## Resource Notes104105### `scripts/create_citation_log.py`106107- Create a reusable Markdown intake sheet for citation collection.108- Use `--append` to keep an existing log and add a fresh empty section header for another pass.109110### `assets/citation-log-template.md`111112- Copy or adapt this template when a lightweight manual log is enough.113114## Handoff to BibTeX Work115116- After the intake sheet is ready, use the recorded title and link to add the final entry into a `.bib` file.117- If the task is specifically about appending normalized entries into a bibliography, hand off to `bibtex-reference-adder` after this skill finishes the recommendation and intake stages.