| name | cleanup-articles |
| description | Clean up published or removed article drafts and orphaned assets in this repository. Use when the user asks to delete published articles, remove an article with its source notes and images, clean unused notes/images, or run orphan cleanup. |
Cleanup Articles
Use this for repository hygiene after articles are published or removed.
Scripts
scripts/remove-articles.py: targeted removal for specific article drafts. It deletes the article files, their rows in articles/_index.md, and only the source notes/images that are not referenced by remaining articles.scripts/cleanup.py: global orphan cleanup. It scans all remaining articles and deletes inbox files/images that are not referenced anywhere.scripts/check-links.py: validation for broken internal article links.
Remove Published Articles
- Confirm the article drafts are already published, usually via
articles/_substack-archive-index.md.
- Run a dry run:
python scripts/remove-articles.py articles/path-one.md articles/path-two.md
- Review:
- article files to delete
_index.md rows to remove- unique source notes to delete
- unique images to delete
- shared notes/images kept
- missing notes/images ignored
- Ask the user for confirmation before deleting.
- Apply:
python scripts/remove-articles.py articles/path-one.md articles/path-two.md --delete
- Replace links from remaining articles to deleted local drafts with the published Substack URLs.
Clean All Orphans
Run a dry run first:
