# 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](https://agentskills.io) 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. ```bash gh skill install thorwhalen/yb music2video --agent claude-code ``` Source: [`yb/data/skills/music2video`](https://github.com/thorwhalen/yb/tree/HEAD/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. ```bash gh skill install thorwhalen/yb yb-download --agent claude-code ``` Source: [`yb/data/skills/yb-download`](https://github.com/thorwhalen/yb/tree/HEAD/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. ```bash gh skill install thorwhalen/yb yb-podcast --agent claude-code ``` Source: [`yb/data/skills/yb-podcast`](https://github.com/thorwhalen/yb/tree/HEAD/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. ```bash gh skill install thorwhalen/yb yb-publish --agent claude-code ``` Source: [`yb/data/skills/yb-publish`](https://github.com/thorwhalen/yb/tree/HEAD/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. ```bash gh skill install thorwhalen/yb yb-setup --agent claude-code ``` Source: [`yb/data/skills/yb-setup`](https://github.com/thorwhalen/yb/tree/HEAD/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 `. ## Machine-readable documentation This site publishes the same documentation in forms that fit an agent's context window: - [`llms.txt`](https://thorwhalen.github.io/yb/llms.txt): an index of every page with a one-line description ([llms.txt](https://llmstxt.org) format) - [`yb.md`](https://thorwhalen.github.io/yb/yb.md): the whole documentation as one Markdown file - `.html.md`: a rendered Markdown twin of every page, advertised from each page's `` with `` - [`objects.inv`](https://thorwhalen.github.io/yb/objects.inv): the Sphinx inventory: a symbol-to-URL index (`sphobjinv convert plain objects.inv -`)