菜单
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.