Labsco
vamsi-kodimela logo

Maagpi Youtube Workflow Skill

from vamsi-kodimela

Automate end-to-end youtube production pipeline for face less channels

🔥🔥🔥✓ VerifiedFreeQuick setup
#automation#seo#notion#calendar#database#ai-image#voice#git

YouTube Content Workflow Skill

Claude Code npm version npm downloads Node >=18 License: MIT Platforms Privacy: never public PRs Welcome GitHub stars

YouTube Content Workflow is a Claude Code skill that turns a Notion content calendar into scheduled YouTube videos end-to-end: pick a channel, generate SUCCESS-framework titles, run NotebookLM deep research, generate an Explainer video in the channel's language, transcribe it, draft the description, build the thumbnail (preferring Nano Banana Pro), generate tags, and schedule upload — never public.

This repository is the source for the skill. After install it lives at ~/.claude/skills/youtube-content-workflow/ and is invoked via the /youtube-content-workflow slash command.

Skill

  • Trigger: /youtube-content-workflow
  • Install path: ~/.claude/skills/youtube-content-workflow/
  • State: local JSON cache (per-channel + per-run) + Notion (canonical)
  • Full docs: see SKILL.md for the complete phase-by-phase contract

Phase Reference

The skill runs five phases. Phases 2 and 3 fan out as parallel Agent subagents (one per topic). User gates batch sequentially.

PhaseWhat it doesMCPs called
0. Channel + contextProbe MCPs. Pick channel. Load (cache → Notion) or capture (first-time) tone, audience, language, calendar DB.YouTube, Notion
1. Calendar readQuery Notion content calendar for topics whose Publish Date falls in your chosen range.Notion
2. Title genPer topic: 5 SEO + SUCCESS-framework titles (Heath, Made to Stick). User picks one.(LLM only)
3. Heavy pipelinePer topic: notebook → deep research → Explainer video → download → transcribe → description → thumbnail spec → image gen → tags → save.NotebookLM, image gen, transcription
4. ReviewShow every topic's assets + thumbnail. Approve / regen / skip. Pick privacy: private (default) or unlisted.(UI gate)
5. UploadPre-flight assert (privacy != public, files exist, date in future). Schedule upload. Update Notion.YouTube, Notion

Example

A typical run for three topics in the next 7 days:

Copy & paste — that's it
> /youtube-content-workflow

[Phase 0]   channel = Main Channel (UCxxxxxxxx) — cache hit
[Phase 1]   3 topics found in date range 2026-04-30..2026-05-07
[Phase 2]   spawned 3 parallel title gens
            topic 1: 5 candidates → user picked #2
            topic 2: 5 candidates → user picked #4
            topic 3: 5 candidates → user picked #1
[Phase 3]   spawned 3 parallel pipelines
            topic 1: notebook ✓ deep research (8m 12s) ✓ video (3m 4s) ✓
                     transcript ✓ description ✓ thumbnail ✓ tags ✓
            topic 2: ...
            topic 3: ...
[Phase 4]   review topic 1: approved
            review topic 2: regen thumbnail → approved
            review topic 3: approved
            privacy: private
[Phase 5]   pre-flight pass · uploaded 3 · all scheduled as private

✅ run complete: ~/.claude/skills/youtube-content-workflow/state/runs/run-2026-04-30-a1b2c3/

State Layout

Copy & paste — that's it
~/.claude/skills/youtube-content-workflow/
├── SKILL.md
├── schemas/
└── state/
    ├── channels/
    │   └── UCxxxxxxxx.json      # cached channel metadata (mirrors Notion)
    └── runs/
        └── run-2026-04-30-a1b2c3/
            └── <topic_slug>/
                ├── metadata.json
                ├── video.mp4
                ├── thumbnail.png
                ├── transcript.txt
                ├── description.txt
                ├── tags.json
                └── titles.json

Channel state is canonical in Notion and locally cached for speed. See schemas/notion-databases.md for the required Notion schema (YouTube Channels + Content Calendar).

Why this skill 🎯

  • Anti-hallucination by construction. Tool-sourced facts only, per-step output verification, language preservation. Never invents topics, calendar entries, or transcripts.
  • Parallel by default. Title gen and the heavy per-topic pipeline both fan out as subagent teams; user gates (title pick, review, privacy) batch sequentially.
  • Never public. Default privacy is private. unlisted requires explicit opt-in. A pre-flight assertion enforces this before every upload call.

Links

Relationship to existing skills

The legacy youtube-content-creator and youtube-notebooklm skills at ~/.claude/skills/ are left intact. This skill is a unified, MCP-first replacement. To retire the old ones, delete their directories and remove their CLAUDE.md entries manually — neither installer touches them.