youtube-publisher

# 🎬 YouTube Publisher

**[🇷🇺 Читать на русском](README.ru.md)**

<p align="center">
  <img src=".github/cover.jpg" alt="YouTube Publisher" width="600">
</p>

> An AI agent skill that turns "upload this recording to YouTube" into a fully automated pipeline.  
> Works with Claude Code, Codex, Gemini CLI, [OpenClaw](https://github.com/openclaw/openclaw), or any agent with terminal access.  
> Your agent downloads from Drive, uploads to YouTube, transcribes, generates timestamps and metadata — you just say the word.

---

## The Problem

You recorded a meeting, a lecture, a workshop. It's sitting in Google Drive. Now what?

You download a 2GB file, drag it into YouTube Studio, wait for the upload, try to come up with a decent title, scrub through an hour of video to place timestamps, write a description, copy-paste everything, publish, delete the local file. That's 30-60 minutes of mind-numbing work per recording — and you have dozens of them every month.

## The Solution

Tell your agent:

> *"Upload last Friday's recording to YouTube"*

The skill handles the entire pipeline:

- ⬇️ **Downloads** from Google Drive (no local file juggling)
- 📤 **Uploads** to YouTube (resumable, handles large files)
- 🎤 **Transcribes** audio via Fireworks Whisper or Deepgram Nova-3
- ⏱️ **Generates timestamps** from topic boundaries
- 📝 **Creates title & description** from transcript content
- 🧹 **Cleans up** all temp files automatically

**~5 minutes for a 1-hour video.** Zero manual work. The agent does everything.

## Install

### With Any AI Agent

The skill is two things: `SKILL.md` (instructions) and `scripts/` (code). Copy them into your agent's workspace:

```bash
git clone https://github.com/smixs/youtube-publisher.git

# Claude Code / Codex / Gemini CLI — into your project
mkdir -p skills/youtube-publisher
cp youtube-publisher/SKILL.md skills/youtube-publisher/
cp -r youtube-publisher/scripts skills/youtube-publisher/

# OpenClaw
cp -r youtube-publisher/{SKILL.md,scripts}