For AI agents¶
yb ships artifacts for coding agents alongside its code. This page lists
them, says where each lives in the repository, and points at the
machine-readable copies of this documentation.
Skills¶
Skills are folders holding a SKILL.md (the Agent Skills format): a description that tells an agent when to use it and a body with the procedure. Install one into your agent with gh skill (any host: --agent claude-code, copilot, cursor, codex, gemini), or use the copy bundled in the wheel.
music2video¶
Turn songs (.wav/.mp3) into publishable YouTube music videos with the yb package: render a still-cover, Ken Burns, or audio-reactive video, derive the thumbnail, loudness-normalize a whole album, verify the result against what YouTube actually accepts, and publish. Use when the user wants to publish a song or album to YouTube, make a music video or visualizer from an audio file, add cover art to a track for upload, or check a rendered music video before shipping it.
gh skill install thorwhalen/yb music2video --agent claude-code
Source: yb/data/skills/music2video (bundled with the pip package).
yb-download¶
Download a YouTube video, or just its audio, with the yb package — including metadata-only lookups, playlists, sidecars (subtitles/thumbnail/description), and converting the downloaded audio to a specific format (mp3, wav, …). Use when the user wants to get/fetch/grab/rip a video or its audio from a YouTube link, extract audio from a video URL, pull a video’s metadata without downloading, or convert an audio file’s format.
gh skill install thorwhalen/yb yb-download --agent claude-code
Source: yb/data/skills/yb-download (bundled with the pip package).
yb-podcast¶
Prepare a podcast episode with the yb package: show notes, chapter markers (ID3 chapters embedded in the MP3 + a Podlove PSC sidecar), an optional cover-over-audio video (static or Ken Burns), and an RSS episode item. Use when the user wants to turn audio (or a video’s audio) into a publishable podcast episode, generate show notes / podcast chapters, embed chapters in an MP3, make a cover video for an audio episode, or build a podcast RSS feed.
gh skill install thorwhalen/yb yb-podcast --agent claude-code
Source: yb/data/skills/yb-podcast (bundled with the pip package).
yb-publish¶
Prepare and publish a video to YouTube with the yb package: transcribe, derive title/description/keywords, detect chapters, render a thumbnail, upload (with captions), and edit already-published videos (metadata, subtitles, chapters, thumbnail). Use when the user wants to publish/upload a video to YouTube, prepare YouTube metadata/chapters/subtitles, replace or add subtitles on an existing video, or update a published video’s title/ description/tags/thumbnail. For first-time OAuth setup, use yb-setup first.
gh skill install thorwhalen/yb yb-publish --agent claude-code
Source: yb/data/skills/yb-publish (bundled with the pip package).
yb-setup¶
Set up YouTube publishing for the yb package: install the right extras, create a Google OAuth client (gcloud optional — the console path works), wire up the credentials, run the one-time consent, and test the connection. Use when the user wants to publish/upload to YouTube for the first time, hits an OAuth or “client secrets” error, sees “accessNotConfigured”, needs to make or replace a YouTube OAuth client, or asks how to authenticate yb with YouTube.
gh skill install thorwhalen/yb yb-setup --agent claude-code
Source: yb/data/skills/yb-setup (bundled with the pip package).
The bundled skills are also on disk after pip install yb, under the package’s data/skills/ directory; link them into an agent without network access with skill link-skills <that directory>.
Machine-readable documentation¶
This site publishes the same documentation in forms that fit an agent’s context window:
llms.txt: an index of every page with a one-line description (llms.txt format)yb.md: the whole documentation as one Markdown file<page>.html.md: a rendered Markdown twin of every page, advertised from each page’s<head>with<link rel="alternate" type="text/markdown">objects.inv: the Sphinx inventory: a symbol-to-URL index (sphobjinv convert plain objects.inv -)