How do I install the Submagic skill?

Run npx skillmds@latest add tylerprogramming/submagic in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Submagic skill do?

Burn word-by-word on-screen captions onto the video at $ARGUMENTS using Submagic. It is listed under Docs & Writing on SkillMD.

Is Submagic safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Submagic?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Submagic free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Submagic?

tylerprogramming (@tylerprogramming) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Submagic by tylerprogramming — Agent Skill

Name: Submagic
Author: tylerprogramming

File contents

Burn word-by-word on-screen captions onto the video at $ARGUMENTS using Submagic.

Scope

This skill ONLY burns visual captions onto the video via Submagic.
It does NOT generate social media post copy (YouTube Shorts / TikTok / Reels / LinkedIn).
It does NOT replace /transcribe - Whisper stays the source for raw transcripts.

How it works

Uses Submagic's direct upload endpoint POST /v1/projects/upload with multipart/form-data. The mp4 is streamed straight to Submagic, so there is no Google Drive dependency, no virus-scan redirect problem on large files, and the requested userThemeId is preserved reliably (the older Drive-URL path sometimes got themes silently swapped under concurrent jobs).

Instructions

Verify the file exists and is an mp4.

Run the script:

python3 ~/.claude/skills/submagic/submagic_caption.py "$ARGUMENTS"

The script will:
- Upload the mp4 directly to Submagic (multipart)
- Poll GET /v1/projects/{id} every 15s until completed or failed
- Warn if Submagic silently swapped the requested theme (happens if the theme UUID was very recently edited in the dashboard - propagation delay)
- Download the captioned mp4 to ~/content/submagic/<original-name> - captioned-<short-project-id>.mp4
If the script fails, check ~/.claude/.env for:
- SUBMAGIC_API_KEY
- SUBMAGIC_THEME_ID (the custom theme UUID - grab it from the Submagic dashboard if changing)
Report the output path to the user. Do NOT generate platform captions unless asked.

Finding a theme UUID

Submagic's public API has no "list my custom themes" endpoint. To switch themes:

Log into https://app.submagic.co
Open DevTools (Cmd+Opt+I) -> Network tab
Navigate to the themes page
Find the XHR that returns a JSON array of themes - each has an id field
Copy the id of the theme you want and paste it into SUBMAGIC_THEME_ID in ~/.claude/.env

Preset templates (Beast, Hormozi 1-5, Doug, etc.) are available via a separate templateName field if ever needed - not wired into the script today.

---name: submagicdescription: Burn word-by-word on-screen captions onto the video at $ARGUMENTS using Submagic.---Burn word-by-word on-screen captions onto the video at $ARGUMENTS using Submagic.## Scope- This skill ONLY burns visual captions onto the video via Submagic.- It does NOT generate social media post copy (YouTube Shorts / TikTok / Reels / LinkedIn).- It does NOT replace `/transcribe` - Whisper stays the source for raw transcripts.## How it worksUses Submagic's direct upload endpoint `POST /v1/projects/upload` with `multipart/form-data`. The mp4 is streamed straight to Submagic, so there is no Google Drive dependency, no virus-scan redirect problem on large files, and the requested `userThemeId` is preserved reliably (the older Drive-URL path sometimes got themes silently swapped under concurrent jobs).## Instructions1. Verify the file exists and is an mp4.2. Run the script: ``` python3 ~/.claude/skills/submagic/submagic_caption.py "$ARGUMENTS" ```3. The script will: - Upload the mp4 directly to Submagic (multipart) - Poll `GET /v1/projects/{id}` every 15s until `completed` or `failed` - Warn if Submagic silently swapped the requested theme (happens if the theme UUID was very recently edited in the dashboard - propagation delay) - Download the captioned mp4 to `~/content/submagic/<original-name> - captioned-<short-project-id>.mp4`4. If the script fails, check `~/.claude/.env` for: - `SUBMAGIC_API_KEY` - `SUBMAGIC_THEME_ID` (the custom theme UUID - grab it from the Submagic dashboard if changing)5. Report the output path to the user. Do NOT generate platform captions unless asked.## Finding a theme UUIDSubmagic's public API has no "list my custom themes" endpoint. To switch themes:1. Log into https://app.submagic.co2. Open DevTools (Cmd+Opt+I) -> Network tab3. Navigate to the themes page4. Find the XHR that returns a JSON array of themes - each has an `id` field5. Copy the `id` of the theme you want and paste it into `SUBMAGIC_THEME_ID` in `~/.claude/.env`Preset templates (Beast, Hormozi 1-5, Doug, etc.) are available via a separate `templateName` field if ever needed - not wired into the script today.

Frequently asked questions

Submagic