Known limitations and how to contribute to the skill

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.

1. Only LinkedIn and Instagram — Twitter/X, Threads, and TikTok are in the backlog. The skill’s publishing and account-lookup code is built around Blotato’s LinkedIn and Instagram endpoints; adding new platforms requires new bc.publish_post logic and corresponding Step 4 post-writing rules.
2. Trigger is Spanish-only — the command must start with "Crear post para Instagram y LinkedIn:". Any other phrasing (including English equivalents like "Repurpose this video") does not activate the skill. This is intentional — it prevents accidental triggers. To adapt the skill to another language, edit the description field in SKILL.md and the Command format block, then update the Step 3 question template and the Step 4 writing guidelines to match.
3. Template IDs hardcoded — visual template IDs referenced in SKILL.md may stop working if Blotato rotates them. If visuals stop generating despite a valid FREEPIK_API_KEY, this is the likely cause. The skill uses a generic fallback or fails silently in this case. This is a known open issue.
4. Instagram 5-hashtag limit — Instagram (via Blotato) rejects posts with more than 5 hashtags. The skill auto-enforces this via bc.enforce_ig_hashtags(), but the limit itself is imposed by the platform and may change without notice from Blotato.
5. Only Spanish and English output — the skill detects the video language from the transcript and writes posts in es or en. For any other source language, it defaults to Spanish and prints a warning. If you need another output language, override with idioma: en or idioma: es in the command.
6. No OAuth / multi-account switching mid-run — account IDs are read from .env at startup via bc.load_config(). There is no mechanism to switch accounts during a run. To use a different account, update BLOTATO_LINKEDIN_ACCOUNT_ID or BLOTATO_INSTAGRAM_ACCOUNT_ID in your .env and re-run the command.

​

Contributing

• Do not change the trigger format without coordinating first. The exact command format ("Crear post para Instagram y LinkedIn:") is relied on by existing users. Breaking it without a migration path is not acceptable.
• Document new Python dependencies. If your change adds a pip install requirement, update both README.md and SKILL.md to reflect it.
• Keep the Step 6 approval rule intact. The mandatory approval gate before any publish call is the skill’s primary safety guarantee. Do not bypass or weaken it.
• Keep blotato_client.py dependency-free. The script must use only Python stdlib (urllib). Do not introduce requests, httpx, or any other HTTP client.
• Bug reports: Include the exact command that triggered the error, the full output, and your Python version.