author-publication-versions
Fetch version lineages of the author's own published works (Zenodo) and record a cross-repository current-DOI ledger. Use when fixing self-citations or related identifiers, after a Zenodo version bump
SKILL.mdskills/en/author-publication-versions/SKILL.md
GitHubAuthor Publication Versions
Purpose
For the author's published works (v1: Zenodo only), fetch concept DOI and per-version DOIs from the primary API and write a cross-repository ledger. Self-citations, related identifiers in deposit metadata, and own-work rows in the literature matrix must use the Current version DOI (avoid citing superseded Zenodo version DOIs).
Trigger Conditions
- Immediately before citing own work or listing related identifiers (DOI lock)
- Right after publishing a new Zenodo version (refresh the ledger)
- When updating own-work rows (P1 / P2 / …) in the literature matrix
- When the user asks for “own-work versions” or “current Zenodo DOI”
Prerequisites
- Contact email:
export SCHOLARLY_CONTACT_EMAIL="..."(polite pool; script refuses HTTP if unset) - Work list:
config/author_publications.json(works[].zenodo= DOI or record id) - v1 scope: Zenodo only (no arXiv version history / ORCID enumeration yet)
Procedure
Step 1: Confirm inputs
- Ensure
config/author_publications.jsonlists the author's Zenodo DOIs - If missing, append DOIs or pass
--doion the CLI - Output path is repo-root relative
docs/literature/author-publication-versions.md(not under a paper-id; cross-cutting ledger)
Step 2: Fetch version lineages
Run from the paper repository root (e.g. academic-papers):
# Submodule install
python3 .scholarly-agent-skills/scripts/fetch_publication_versions.py
# Skills repo root, or via symlink
python3 scripts/fetch_publication_versions.py
# Extra DOI / dry-run
python3 scripts/fetch_publication_versions.py --doi 10.5281/zenodo.22065716 --dry-run
Multiple version DOIs for the same concept are deduplicated by concept id.
Step 3: Align downstream artifacts
- Read
docs/literature/author-publication-versions.md - Treat Cite targets as the source of truth for the current DOI
- Align as needed (do not auto-commit):
- Own-work rows in each paper's
literature/literature-matrix.md - Related identifiers in
design/deposit-metadata.md(drop superseded version DOIs) - Bibliography entries for own works
- Own-work rows in each paper's
Step 4: Superseded version DOIs
- Old versions may appear in the ledger; default cite / related-id target is Current only
- Use an older version DOI only with an explicit historical reason
- Concept DOIs may resolve to the latest version; for a pinned version, write the version DOI
Outputs
docs/literature/author-publication-versions.md(cross-repo: Summary / Cite targets / per-work tables)- (Optional) DOI sync diffs for matrix, deposit-metadata, and bibliography (after author confirmation)
Related Skills
submission-venue-advisor— deposit related-identifier draftsliterature-search— third-party literature search (separate from this ledger)citation-traceability-audit— body citations vs DOIspdf-paper-ingestion— re-fetch PDF for the current version when needed