podcast-publishing-assistant · git:20261028.0f0270d · 2026-10-28 · sha256 ed3d80e6ea44d6c8

podcast-publishing-assistant git:20261028.0f0270dA

Immutable. This exact content never changes and is served at /api/v1/blob/ed3d80e6ea44d6c8.

---
name: podcast-publishing-assistant
description: Draft or update podcast write-ups, chapters, title/hook options, show notes, and X promotion; prepare podcast posts and verify requested release states. Not standalone ASR, video editing, or thumbnail artwork.
---

# Podcast publishing assistant

Resume the existing episode and requested deliverables, reusing approved media,
copy, transcripts and overlay sources. Preserve user edits. Keep the current
master/version, edit map, approved angle/cover, destination IDs and release states
in the existing episode record, not a second tracking system.

Use `swyx-writing` for editorial copy, not verbatim transcripts or speaker labels.
Route missing ASR to `transcribe-anything`, edits and annotations to
`annotated-video-production`, and LS artwork to `latent-space-thumbnail-director`.
Prefer source audio; captions serve an explicitly requested rough pass. Anonymous
ASR labels do not establish named identities. Publishing consumes the approved
edit; it does not silently introduce editorial cuts.

## Choose the angle

For a new YouTube package or X launch angle, offer at least four distinct options
unless the user specifies otherwise. Pair YouTube titles with thumbnail hooks;
recommend one and briefly argue against each, including overemphasis on a minor
segment. Apply the user's selection or delegated choice; do not reopen it on
resume. Continue independent copy and chapter work while a choice is pending.

Prefer specific theses and mechanisms over vague promises. Keep recurring series
identity first. Thumbnail hooks should be thoughtful sentence/title case, with a
concise role, company or verified milestone where useful. Attribute guest claims.
Write one coherent description by default; alternatives, clips and quote cards
are optional unless requested, not mandatory launch-pack filler.

## Timing and source fidelity

Align chapters and transcript to the approved edit, including commentary, intro,
cold open and cuts. Use the edit map and verify against media or a synchronized
transcript. Do not assume a revision shifts every timestamp by one constant.
Approximate times are draft-only until verified. Format chapters as start time
plus a 2–10 word headline, in normal text rather than headings:
`0:00 Intro and origin story`. Verify quoted words and named speakers; identify
automated transcript uncertainty without rewriting it into polished commentary.

## Podcast post and media

Resume the named platform or existing draft, whether Beehiiv or Substack. For a
complete podcast post, use the approved MP3, episode-specific write-up, full
transcript and available video embed. Use the approved thumbnail as episode cover
when supported, adapting the crop without distorting faces or text.

Before the transcript, place bulleted show notes with a short description and
verified link for each relevant guest, company or source. Reuse research from
the edit selectively. Order: show notes → chapters → transcript.

Verify the exact destination publication/post/episode, saved audio and cover,
embed and requested visibility. **Newsletter post, podcast/RSS episode, YouTube
and X have independent release states.** A Beehiiv post draft does not prove the
episode is absent from RSS. Keep each unpublished, scheduled or live only as
authorized, and confirm video embeds are accessible to their intended audience
before release.

After media replacement, verify the saved attachment by filename and duration or
playback; upload completion alone is insufficient. Preserve prior media locally.
Update affected transcript, chapters, embed and promo links to the new edit;
report stale or unverified dependencies instead of calling the package ready.

## X promotion

Ground each angle in the episode write-up and specific moments, supplying verified
source timestamps for review. Lead with a concrete idea, story or tension and tag
verified guest accounts with relevant roles. Use the angle-selection rules above.

For a full native-video launch, attach the approved episode, put verified chapters
in the **same main post as the video**, and include domain and YouTube links. Use
a long post when supported; check timestamps against that uploaded edit and their
clickability. Replies can carry extra context, but are not equivalent to chapters
beside the video. Explain actual platform limits rather than silently moving them.

For clips, choose a useful opening and accurate captions that work without sound.
Offer link-led alternatives when helpful. When requested, provide clip windows
and quote-card candidates with their editorial rationale; mark provisional timing.

For inspiration, consult [X examples](references/x-podcast-promo-inspiration.md)
or research comparable announcements from followed accounts. Confirm whose follows
a filter uses. Treat visible views/likes as descriptive, not proof of listens or
causal evidence for a format; account for post age and audience differences.
Do not make fresh inspiration research a prerequisite to an already chosen post.

## Finish at the requested state

Deliver the requested copy, draft or authorized publication, with destination links
and verified state where applicable. Do not expand a single deliverable into an
entire launch pack or treat a draft as permission to publish.

The existing `scripts/transcribe_youtube.sh` helper remains available for audio
acquisition/transcription; inspect suitability before use. `transcribe-anything`
owns current ASR choices and recovery.