메뉴
Use when Codex needs to refresh the tracked public Substack archive, validate the Eleventy mirror, troubleshoot sync or deploy failures, or follow the repo's documented manual-import fallback for publication_strategy_and_archive/.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Legacy fallback for repo-local paper intake when OpenDataLoader PDF cannot convert a source. Prefer opendataloader-paper-intake for PDF-to-Markdown conversion, and use markitdown only as the fallback or for non-PDF sources.
Use when Codex needs to place papers into a package's canonical source tree, convert PDFs to single-file markdown with OpenDataLoader PDF as the primary converter, omit images, fall back to markitdown on failure, and update the package paper index using the tracked paper-intake workflow.
Use when Codex needs to work with the repository's YouTube Data API automation for OAuth setup, authenticated channel inspection, caption download, playlist maintenance, Shorts draft review, or Operating Agents upload and replacement workflows under workflows/skills/youtube-data-api/.
Use when the user wants to work with the alphaXiv CLI to search for papers, inspect paper metadata or full text, manage saved paper or assistant context, or use the authenticated assistant, folders, or comments in terminal-based research workflows.
Use when Codex needs to republish the Operating Agents preface or essay markdown to live Substack, preserve embedded video blocks, keep published links Substack-first, and refresh the local archive after publication.
Use when Codex needs to generate the repository's standard NotebookLM artifact bundle for a notebook, inspect artifact/task status, reuse the established audio/slide/video prompt texts, or upload generated audio back into NotebookLM to recover a transcript.
| name | substack-archive-sync |
| description | Use when Codex needs to refresh the tracked public Substack archive, validate the Eleventy mirror, troubleshoot sync or deploy failures, or follow the repo's documented manual-import fallback for publication_strategy_and_archive/. |
Use this skill for the canonical public Substack pipeline in publication_strategy_and_archive/. Prefer the repo scripts in scripts/ over ad hoc scraping, manual metadata edits, or direct mirror edits.
.venv/bin/python ... and npm run ....scripts/sync_substack_archive.py as the canonical archive refresh entrypoint./feed is blocked or CI is failing with a 403, switch to the manual-import fallback instead of repeatedly rerunning a broken sync.publication_strategy_and_archive/substack_archive/metadata.json, localized assets, and the README publication table in sync.Normal refresh:
npm run sync:substack
Or run the underlying script directly with a machine-readable summary:
.venv/bin/python scripts/sync_substack_archive.py \
--summary-path /tmp/substack-sync-summary.json
Run the built-in validation path after syncs or manual imports:
npm run build:mirror
npm run check:mirror
Also check the GitHub Pages subpath mode when troubleshooting deployment issues:
ELEVENTY_PATH_PREFIX=/content/ MIRROR_SITE_URL=https://petroslamb.github.io npm run check:mirror
Use the lower-level checks when you need to isolate the failure:
scripts/check_mirror.py: validates metadata, asset references, README generation, and built-link integrity.scripts/e2e_mirror_smoke.py: serves _site/ locally and confirms homepage, archive, post, and feed routes.Use the documented manual-import path when feed discovery or the GitHub workflow is blocked. The manual fallback should create canonical slug files that future sync runs can overwrite cleanly, not duplicate shadow entries.
../../../workflows/substack-archive-sync/README.md: tracked canonical archive refresh, validation, and manual-import workflow.../../../publication_strategy_and_archive/README.md: tracked archive-system orientation.references/workflow.md: command inventory, validation flow, and manual-import checklist.references/rollout-lessons.md: feed 403 behavior, prefix-safe mirror checks, workflow cadence, and environment constraints.