| name | retarget-journal |
| description | Use when you need to retarget a paper to a different journal (rename, swap bib, update citations). |
| allowed-tools | Bash(latexmk*), Bash(pdflatex*), Bash(xelatex*), Bash(mkdir*), Bash(ls*), Bash(cp*), Bash(mv*), Bash(git*), Read, Write, Edit, Glob, Grep, Task |
| argument-hint | ["target-journal-name"] |
Retarget Journal Skill
Switch a paper manuscript from one journal to another. Handles folder renaming, bibliography swaps, citation key updates, formatting changes, and compilation verification.
When to Use
- Switching a paper's target venue (e.g., Journal A to Journal B, Journal C to Journal D)
- After a rejection when resubmitting to a different journal
- When strategic decisions change the target venue mid-drafting
Before Starting
Ask the user for:
- Current project path — where is the paper?
- Target journal — full name and abbreviation
- What changes? — some retargets are minor (formatting), others are major (restructuring)
Read the project's CLAUDE.md and README.md to understand current state.
Workflow
Phase 1: Assess Scope
Read the current manuscript and compare against the target journal's requirements:
| Check | What to compare |
|---|
| Word/page limit | Does the draft fit? Need to cut or can expand? |
| Required sections | Does the target need sections the current draft lacks? (e.g., "Relevance Statement", "AI Disclosure") |
| Citation style | Author-year vs numbered? natbib vs biblatex? |
| Formatting | Template class? Column layout? Font requirements? |
| Supplementary material | Online appendix conventions? |
Present the assessment to the user before proceeding.
Phase 2: Rename and Restructure
-
Rename project folder if it references the old journal:
mv "old-journal-name/" "new-journal-name/"
-
Update Overleaf symlink if one exists:
rm paper/
ln -s "/path/to/Overleaf/new-project" paper
-
Update folder references in CLAUDE.md, README.md, .gitignore
Phase 3: Bibliography
- Swap
.bib file if the user provides a new export from Paperpile
- Update citation keys across all
.tex files:
- Read the new
.bib to get the new key format
- Find all
\cite{...}, \citet{...}, \citep{...}, \citeauthor{...} commands in .tex files
- Map old keys to new keys (match by author + year)
- Replace all occurrences
- Validate — run
/bib-validate to ensure no missing or unused keys
Phase 4: Formatting
- Switch document class/template if needed
- Add required sections (e.g., data availability, AI disclosure, conflict of interest)
- Adjust page layout (margins, columns, font size)
- Update
\bibliographystyle{} if citation style changes
- Update abstract — check word limit for target journal
Phase 5: Update Documentation
- Project
CLAUDE.md — update target journal, formatting notes
- Project
README.md — update journal reference, submission info
MEMORY.md — carry forward any learnings, update journal-specific notes
- vault research pipeline — update the Target Journal and Status fields. If the retarget closes a live venue event (rejection or withdrawal), append the closing
history: row (event: decision, outcome: reject or event: withdrawn) to the OLD venue's submission entry per rules/submission-file-archive.md § history — the new target's entry gets its own history: when it is actually submitted, not at retarget time
- atlas topic
outputs[] — update the retargeted output's venue (slug must resolve to a ~/vault/venues/ file). Refresh or clear cycle: if the new venue is a Conference/Workshop and the output is submission-active, set cycle: <NewVenue> <edition-year>; if the new venue is a journal, remove any stale cycle — per rules/atlas-status-vocabulary.md § submission-join completeness. A stale cycle from the old venue must never survive a retarget. If the retarget also changed the paper's title, update paper_title here and the registry canonical_title together (keep them aligned per paper-vault-alignment.md).
Phase 6: Compile and Verify
- Compile to
out/ with latexmk
- Fix all warnings (overfull/underfull)
- Check page count against target journal limit
- Verify all citations resolve
- Visual check: does the formatting look right for the target venue?
Phase 7: Confirm
Report a summary:
Retargeted [Paper Name]: [Old Journal] → [New Journal]
Changes made:
- Folder: [old path] → [new path]
- Symlink: updated to [new Overleaf project]
- Bibliography: [N] citation keys updated
- Sections added: [list]
- Sections removed: [list]
- Page count: [N] pages (limit: [M])
- Compilation: clean (0 warnings)
Updated: CLAUDE.md, README.md, vault
Important Rules
- Never delete the old
.bib file — rename it to old-journal.bib.bak as a safety copy
- Verify citation key mappings with the user before bulk-replacing — automated matching can misfire on common surnames
- Don't restructure content without approval — some retargets only need formatting changes, not rewriting
- Preserve git history — commit the retarget as a single, well-documented commit
Venue Style Guides
When retargeting, the writing style often needs to change too — not just the formatting. Read the appropriate guide from the shared venue-guides resource:
Cross-References
| Skill | When to use alongside |
|---|
/bib-validate | After Phase 3 to verify all citation keys |
/latex | Default compiler — use for compilation with auto error resolution |
/latex | For manual compilation config and .latexmkrc setup |
/proofread | After retarget to check for remnants of old journal formatting |
vault sync (edit vault files directly) | After Phase 5 to sync with central context library |