Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Zoen-DEV/repurpose-youtube-video/llms.txt

Use this file to discover all available pages before exploring further.

Turn any YouTube video into polished, platform-optimized social media posts in a single conversation. This Claude Code skill extracts the video transcript, writes copy tailored to LinkedIn and Instagram, generates visuals with Freepik Mystic, and publishes via the Blotato API — without you ever leaving your terminal.

Installation

Clone the skill, install Python dependencies, and configure your Blotato credentials in under five minutes.

Quickstart

Run your first post end-to-end with a single command and see the approval workflow in action.

Command reference

Exact trigger format, all optional parameters, and precedence rules for tone and objective overrides.

How it works

Eight-step workflow — from transcript extraction and post writing to visual generation and publishing.

​
What this skill does

Starting from a YouTube URL, the skill:
  1. Extracts the video title, description, transcript, tags, and chapters using yt-dlp and youtube-transcript-api — no extra API key needed.
  2. Detects the content language (Spanish or English) automatically, or uses the idioma: override you provide.
  3. Asks for tone and objective per platform — LinkedIn and Instagram can have different registers — unless you supply them upfront.
  4. Writes copy optimized for each platform: LinkedIn (150–300 words, professional) and Instagram (80–150 words, punchy), with hashtags sourced from the video’s own tags and chapters.
  5. Humanizes the text by removing AI tells — em-dashes, inflated vocabulary, generic hooks — so posts read like they were written by a person.
  6. Generates platform-appropriate visuals via Freepik Mystic and applies text overlays using Pillow: a hook image for LinkedIn (4:5) and a single image or 3-slide carousel for Instagram.
  7. Shows everything in a single approval block — posts, visuals, and publish timing — and waits for your explicit confirmation.
  8. Publishes or schedules posts via Blotato, or skips publishing entirely if you used dry-run: si.
The skill never publishes without an explicit sí confirmation. The approval gate in Step 6 is mandatory and hardcoded — it cannot be skipped.

​
Requirements

Claude Code

Installed and running. The skill loads automatically from ~/.claude/skills/.

Python 3.9+

Available on your PATH. Used to run the helper scripts for YouTube extraction and image overlay.

Blotato account

A plan with API access and visual generation. LinkedIn and/or Instagram connected in the dashboard.

Freepik API key

Required for AI visual generation. Optional if you supply your own images with images:.

Build docs developers (and LLMs) love

Get started for freeTalk to us