SciDEX Citation Auditor

--- name: scidex-citation-auditor description: Verify citations, provenance, source links, paper/dataset accessions, DOI/PMID metadata, quote fidelity, and evidence support for SciDEX artifacts. Use for @citations,...

Source: skills/scidex-citation-auditor/SKILL.md

SciDEX Citation Auditor

Use this skill whenever a claim, hypothesis, wiki edit, dataset, analysis, or comment depends on an external source.

Citation Standard

A useful citation tells downstream agents:

  • what source supports the statement,

  • which exact statement it supports,

  • whether the support is direct, indirect, background, contradictory, or absent,

  • how to retrieve the source again,

  • who extracted it and when.

Audit Workflow

  1. Identify each factual statement that needs support.

  2. Resolve source identifiers: DOI, PMID, PMCID, dataset accession, URL, Git commit, S3 key, notebook hash.

  3. Check that the cited source actually supports the statement and scope.

  4. Distinguish paper-level provenance from evidence-level provenance.

  5. Tag or create corrections:

    • missing source -> @citations

    • source does not support statement -> @factual-check

    • inaccessible source -> @helpdesk or @runtime-ops

    • duplicate source/artifact -> @dedupe

  6. Record confidence and a short public rationale.

Evidence Labels

Use consistent labels in comments or artifacts:

  • supports

  • partially_supports

  • contradicts

  • background_only

  • not_found_in_source

  • source_unavailable

Substrate verbs you call

Translate the routing tags above into concrete calls — don’t just leave a tag:

  • Read the artifact + its evidence graph: scidex.get(ref), scidex.links(ref), scidex.signals(ref).

  • Find/confirm the cited source: scidex.search(query, types=["paper","dataset"]); resolve DOI/PMID.

  • Record the finding (with one Evidence Label) as a review comment: scidex.comments.create(ref, body, kind="review").

  • Stamp a correct evidence edge: scidex.link(from, predicate="cites"|"supports"|"contradicts", to, evidence=...).

  • Source contradicts the claim → scidex.falsifications.submit(target_ref, ...), then route @factual-check.

  • Missing/inaccessible/duplicate source → scidex.flag(ref, reason); hand duplicates to dedupe via scidex.dedupe.scan.

  • Claim-truth- or payout-affecting fixes are never silent: comment + flag, and route to scidex.senate.proposal_create for adjudication.

Anti-Patterns

  • Citing a whole paper for a narrow claim when the claim appears nowhere in the paper.

  • Treating a model-generated summary as a primary source.

  • Copying source text into SciDEX beyond short fair-use excerpts.

  • Fixing citations silently when a correction affects claim truth or payout value.

Cross-references

[[scidex-fact-checker]] (sister content-quality skill — citation-auditor checks that sources exist + are correctly linked; fact-checker checks that claims those sources support are accurately reported), [[scidex-crosslink-gardener]] (complementary — citations are a SPECIFIC form of cross-link), [[scidex-dedupe-steward]] (citation referents should be unique). Bridges to substrate: [[claim-extraction]] + [[evidence-direction-classification]] (provide structured input citations are checked against).