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.

Claude writes both posts directly using the extracted transcript, title, tags, and chapters — no external LLM call is made. Each platform gets its own resolved tono and objetivo from Step 3, so LinkedIn and Instagram can end up with entirely different registers. The language is set by the lang value detected in Step 1. Posts are not shown to you immediately after writing; they pass through the humanization step first.

LinkedIn post structure

LinkedIn posts are professional, value-driven, and optimized for feed engagement.
  • Length: 150–300 words
  • Hook: The first line must stop the scroll. It must never start with “En este video…” or “In this video…” — both are treated as generic and rewritten.
  • Body: 3–5 key insights formatted with or bullets for scannability. Tone is conversational but authoritative, shaped by tono_linkedin + objetivo_linkedin.
  • YouTube URL: The original video URL (with timestamp parameters stripped) is placed on its own line just before the hashtags, prefixed with a short CTA:
    • ES: ▶ Mira el video completo aquí: <url>
    • EN: ▶ Watch the full video here: <url>
    LinkedIn auto-unfurls YouTube links into a preview card. The URL is never wrapped in markdown.
  • Hashtags: 3–5 relevant hashtags at the end (see sourcing rules below).
  • Closing question: A question to spark engagement, placed after the URL line, before or among the hashtags — whichever reads more naturally.

Instagram post structure

Instagram posts are punchy, visual, and built for quick consumption.
  • Length: 80–150 words
  • Hook: A bold, single-sentence opening — specific to the video’s content, not a generic pattern.
  • Body: Bullet points or short sentences for scannability. 3–6 emojis woven in naturally throughout the text — never stacked at the end or beginning.
  • Tone: Driven by tono_instagram + objetivo_instagram.
  • Call to action: A clear CTA such as “Link en bio”, “Guarda esto”, or “Etiqueta a alguien”. The raw YouTube URL is never pasted into an Instagram caption — Instagram does not make links in captions clickable, so it only adds noise.
  • Hashtags: Maximum 5 (Instagram hard limit — Blotato rejects posts with more than 5 hashtags and bc.enforce_ig_hashtags() removes any extras before publishing).

Hashtag sourcing

Hashtags are built from the video’s own metadata, not invented wholesale. The algorithm runs in four ordered stages:
  1. Start with tags — pick 2–3 that fit the platform’s audience. Filter out tags that are too generic (#video, #youtube) or too long and obscure (#bestvideosof2025).
  2. Add from chapters — derive 1–2 hashtags from chapter titles using camelCase or PascalCase on the relevant nouns (e.g., chapter “Product strategy basics” → #productStrategy).
  3. Invent only if still under the minimum — if the pool is below 3 (the minimum for both platforms), add 1–2 topic-specific hashtags. These must be concrete, not aspirational: #productivityTips is accepted, #successMindset is not.
  4. Apply the platform cap — LinkedIn: 3–5 hashtags. Instagram: max 5.
If both tags and chapters are empty, the algorithm falls back entirely to invented hashtags, but still keeps them topic-specific.

Faithful citations rule

Every quote, number, percentage, name, and specific claim in the posts must appear literally in the transcript (or, if the transcript is empty, in title + description). Before writing each post, Claude builds a mental checklist of the facts it intends to use and verifies each one against the source text — numbers as digits, names spelled identically. If a fact cannot be found:
  • Rephrase it as a non-specific insight, or
  • Drop the claim entirely.
Paraphrasing the content of the video is fine. Inventing figures, attributions, or quotes is not.

Humanization pass (Step 4.5)

After both posts are written, Claude runs a silent cleanup pass before they are shown to you. Nothing is re-approved at this stage — the only approval gate is Step 6, which covers posts, visuals, and timing together. The humanization pass removes or rewrites the following patterns in both Spanish and English: AI filler connectors
LanguageExamples removed or substituted
ES”En conclusión”, “En resumen”, “Cabe destacar”, “Es importante destacar que…”, “No obstante”, “Asimismo”, “Por consiguiente”, “En última instancia”, “Vivimos en una era…”
EN”In conclusion”, “It’s important to note that…”, “Furthermore”, “Moreover”, “That said,”, “Needless to say”, “In today’s fast-paced world…”, “In the ever-evolving landscape of…”
Inflated AI vocabulary
LanguageExamples removed or substituted
ES”revolucionario”, “transformador”, “disruptivo”, “imprescindible”, “esencialmente”, “navegar por”, “desbloquear el potencial”, “potenciar”
EN”game-changer”, “leverage”, “unlock”, “harness”, “elevate”, “delve into”, “navigate”, “robust”, “seamless”, “cutting-edge”, “synergy”, “empower”, “supercharge”
Structural patterns
  • Em-dashes: Maximum 1 em-dash () per post, ideally zero. Excess em-dashes are replaced with commas, colons, parentheses, or split sentences. This applies to both em-dash () and en-dash used as a substitute ().
  • Sentence length variety: If 3 or more consecutive sentences are similar in length, one is shortened and another lengthened. Short sentences (3–6 words), medium, and the occasional long sentence should all appear.
  • Bullet parallelism: If all bullet points start with the same conjugated verb or follow the same syntactic pattern, 1–2 are rewritten with a different construction (noun phrase, question, nominal clause).
Decorative AI emojis The following emojis are removed when they appear as generic decoration (not when they relate directly to the video’s topic): 🚀 🎯 💡 🌟 ✨ 🔥 💪 🌱. Stacked emoji openers (💡✨🚀 …) are always removed. If a more specific emoji fits the video’s subject (🎬 for film, 📊 for data, 🏋️ for fitness), it is preferred. Generic hooks If the first line matches a generic AI opening pattern, it is rewritten to something concrete and specific to the video’s content:
LanguageForbidden hook patterns
ES”En este video / post…”, “Descubre cómo…”, “¿Alguna vez te has preguntado…?”, “Imagina que…”, “¿Sabías que…?”, “Hoy te voy a contar…”
EN”In this video / post…”, “Discover how…”, “Have you ever wondered…?”, “Imagine if…”, “Did you know that…?”
The humanization pass is strictly cosmetic and stylistic. It never adds information that is not already in the transcript, and it never weakens or alters factual claims — those stay exactly as written in Step 4.

Build docs developers (and LLMs) love