Skill Tracer
Skills › Scientific Agent Skills › scientific-writing › citation_styles.md

citation_styles.md

94 lines · skills/scientific-writing/references/citation_styles.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Citation Integrity and Reference Formatting
2

Citation Integrity and Reference Formatting

Raw lines 1 to 2
3## Verification before style
4
5Formatting cannot repair an unverified reference. For every cited source:
6
71. Open the source or authoritative bibliographic record.
82. Confirm the cited proposition at a precise locator.
93. Confirm authors or organization, title, publication state, venue, year, and version.
104. Copy identifiers exactly from the verified record.
115. Record corrections, retractions, expressions of concern, updates, and preprint status.
126. Assign an evidence ID and human verification record.
14Do not cite a source that was not read for the proposition. Do not copy a DOI, PMID,
15quotation, or reference from generated text, a search snippet, or another article
16without verification. ICMJE assigns authors responsibility for reference accuracy and
17rejects AI-generated material as a primary source [SW-S01].

Verification before style

Formatting cannot repair an unverified reference. For every cited source:

  1. Open the source or authoritative bibliographic record.
  2. Confirm the cited proposition at a precise locator.
  3. Confirm authors or organization, title, publication state, venue, year, and version.
  4. Copy identifiers exactly from the verified record.
  5. Record corrections, retractions, expressions of concern, updates, and preprint status.
  6. Assign an evidence ID and human verification record.

Do not cite a source that was not read for the proposition. Do not copy a DOI, PMID, quotation, or reference from generated text, a search snippet, or another article without verification. ICMJE assigns authors responsibility for reference accuracy and rejects AI-generated material as a primary source [SW-S01].

Raw lines 3 to 18
19## Quotations and paraphrases
21- Verify every quotation character-for-character and record a stable locator.
22- Preserve context, qualifications, and negation.
23- Mark changes, omissions, or translations according to venue policy.
24- Paraphrase from understanding, not by superficial word substitution.
25- Obtain permissions where copyright or license terms require them.
26- For personal communications or unpublished information, obtain required permission
27 and follow current journal policy [SW-S01].

Quotations and paraphrases

  • Verify every quotation character-for-character and record a stable locator.
  • Preserve context, qualifications, and negation.
  • Mark changes, omissions, or translations according to venue policy.
  • Paraphrase from understanding, not by superficial word substitution.
  • Obtain permissions where copyright or license terms require them.
  • For personal communications or unpublished information, obtain required permission and follow current journal policy [SW-S01].
Raw lines 19 to 28
29## Source choice
31Prefer the original source for a reported method, dataset, result, policy, or guideline.
32Use a review for synthesis when it actually supports the synthesized claim. Clearly
33identify preprints and other non-peer-reviewed versions. Check that a later correction
34or published version does not supersede the cited record.
36Do not use citation counts, venue prestige, recency, or a target percentage of recent
37references as a substitute for relevance and evidentiary fit.

Source choice

Prefer the original source for a reported method, dataset, result, policy, or guideline. Use a review for synthesis when it actually supports the synthesized claim. Clearly identify preprints and other non-peer-reviewed versions. Check that a later correction or published version does not supersede the cited record.

Do not use citation counts, venue prestige, recency, or a target percentage of recent references as a substitute for relevance and evidentiary fit.

Raw lines 29 to 38
39## Identifiers
41The local checker validates syntax and duplicates only. It does not resolve identifiers
42and cannot establish that an identifier belongs to the recorded work.
44Supported local checks include:
46- DOI;
47- PMID;
48- PMCID;
49- ISBN checksum;
50- HTTP or HTTPS URL shape;
51- duplicate normalized titles and identifiers.
53After the local check, a human must compare each identifier with the opened source.

Identifiers

The local checker validates syntax and duplicates only. It does not resolve identifiers and cannot establish that an identifier belongs to the recorded work.

Supported local checks include:

  • DOI;
  • PMID;
  • PMCID;
  • ISBN checksum;
  • HTTP or HTTPS URL shape;
  • duplicate normalized titles and identifiers.

After the local check, a human must compare each identifier with the opened source.

Raw lines 39 to 54
55## NLM and journal styles
57For biomedical references, use *Citing Medicine* and NLM's sample references for the
58relevant source type [SW-S20, SW-S21]. These cover articles, books, datasets, software,
59and online material. The current target journal's instructions override generic style
60examples. JAMA currently advises against using AI/LLMs to generate or format
61references; use a standard reference manager and manually verify its output for that
62venue [SW-S25].
64For APA, AMA, Chicago, IEEE, ACS, Vancouver-derived, or publisher-specific styles:
66- use the current official manual or journal style;
67- render from verified structured metadata;
68- check author truncation, title case, journal abbreviation, version, date, locator,
69 and identifier rules;
70- inspect the rendered list manually after conversion.
72Do not invent a complete-looking example reference. Templates should use explicit
73fields or evidence IDs until verified metadata exists.

NLM and journal styles

For biomedical references, use Citing Medicine and NLM's sample references for the relevant source type [SW-S20, SW-S21]. These cover articles, books, datasets, software, and online material. The current target journal's instructions override generic style examples. JAMA currently advises against using AI/LLMs to generate or format references; use a standard reference manager and manually verify its output for that venue [SW-S25].

For APA, AMA, Chicago, IEEE, ACS, Vancouver-derived, or publisher-specific styles:

  • use the current official manual or journal style;
  • render from verified structured metadata;
  • check author truncation, title case, journal abbreviation, version, date, locator, and identifier rules;
  • inspect the rendered list manually after conversion.

Do not invent a complete-looking example reference. Templates should use explicit fields or evidence IDs until verified metadata exists.

Raw lines 55 to 74
75## Citation audit
77Before submission:
79- every factual or numeric claim maps to verified evidence IDs;
80- each in-text citation maps to a source-manifest record;
81- every reference-list entry is cited unless the venue explicitly permits a
82 bibliography;
83- citation ordering and repeated citation behavior match the target style;
84- reused figures, tables, datasets, software, protocols, and standards are attributed;
85- direct quotations have locators and permissions where needed;
86- duplicate and malformed identifiers are resolved;
87- no retracted or corrected status is concealed.
89Run:
91```bash
92python3 scripts/audit_claims.py manuscript.md claims.csv source_manifest.json
93python3 scripts/check_references.py source_manifest.json
94```

Citation audit

Before submission:

  • every factual or numeric claim maps to verified evidence IDs;
  • each in-text citation maps to a source-manifest record;
  • every reference-list entry is cited unless the venue explicitly permits a bibliography;
  • citation ordering and repeated citation behavior match the target style;
  • reused figures, tables, datasets, software, protocols, and standards are attributed;
  • direct quotations have locators and permissions where needed;
  • duplicate and malformed identifiers are resolved;
  • no retracted or corrected status is concealed.

Run:

python3 scripts/audit_claims.py manuscript.md claims.csv source_manifest.json
python3 scripts/check_references.py source_manifest.json
Raw lines 75 to 94
Runs code python3 scripts/audit_claims.py :92
Runs code python3 scripts/check_references.py :93