muapi-youtube-shorts

Q: How do I install muapi-youtube-shorts?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-youtube-shorts in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/muapi-youtube-shorts/ (personal) or .claude/skills/muapi-youtube-shorts/ (project).

by samuraigptMedia & Creative

Auto-generate viral 9:16 YouTube Shorts (or TikTok / Reels clips) from a long-form video. Thin platform-aware wrapper around the AI Clipping skill — picks sensible defaults for short-form social platforms (9:16, 30–60s sweet spot) and delegates the actual highlight extraction + crop to muapi.ai's /ai-clipping endpoint.

Installs: 2.7K
Last 24h: +8
Trending rank: #9911
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-youtube-shorts

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads muapi-youtube-shorts automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

YouTube Shorts Generator

Long video → ranked vertical short clips, tuned for short-form social.

This skill is a platform-aware preset over the AI Clipping primitive. It picks the right aspect ratio and clip count for the target platform and delegates highlight extraction, dedupe, and face-tracked auto-crop to muapi.ai's managed /ai-clipping endpoint.

Reference implementation: https://github.com/SamurAIGPT/AI-Youtube-Shorts-Generator Underlying API: https://muapi.ai/playground/ai-clipping

When to Use This vs. AI Clipping

Use this skill when…	Use AI Clipping directly when…
Target is YouTube Shorts / TikTok / Reels	You want full control over aspect / count
You want platform-tuned defaults	You want raw timestamps (`--coords-only`)
You'd rather pass `--platform tiktok` than think about ratios	You're integrating into a custom renderer

Agent Execution Protocol

Step 1 — Collect Inputs

Input	Default	Notes
`--source`	—	YouTube URL, hosted mp4 URL, or local file
`--platform`	`shorts`	`shorts` \| `tiktok` \| `reels` \| `feed` (sets ratio + count defaults)
`--num-clips`	platform default	Override clip count
`--aspect-ratio`	platform default	Override aspect ratio

If the user gave only a URL, run with platform defaults — don't block.

Step 2 — Verify Prerequisites

muapi-cli installed and authed (muapi auth configure)
MUAPI_API_KEY available

That's it. Transcription, highlight ranking, dedupe, and cropping all run server-side — no ffmpeg, no Python, no Whisper, no LLM keys needed locally.

Step 3 — Run the Pipeline

bash library/social/youtube-shorts/scripts/run-youtube-shorts.sh \
  --source "<YOUTUBE_URL>" \
  --platform shorts \
  --num-clips 5 \
  --view

The script:

Resolves the source (uploads local files to muapi CDN if needed).
Picks platform defaults if --aspect-ratio / --num-clips aren't passed.
Calls muapi edit clipping (the /ai-clipping endpoint) with the chosen params.
Polls until done, prints a ranked summary, optionally downloads / opens clips.

What Happens Server-Side

The /ai-clipping endpoint runs the full pipeline:

Transcribes the audio.
Ranks highlights through a virality framework — hook moments, emotional peaks, opinion bombs, revelation moments, conflict, quotable lines, story peaks, practical value.
Dedupes overlapping candidates by score.
Top-N selects and face-tracks vertical crops.

Each clip ships with score (0–100), opening hook line, and a one-sentence "why it works" reason.

Platform Defaults

Platform	Flag	Aspect	Default clips	Notes
YouTube Shorts	`--platform shorts`	`9:16`	3	Hook in first 1s
TikTok	`--platform tiktok`	`9:16`	5	Higher energy, longer ok
Instagram Reels	`--platform reels`	`9:16`	3	Hook in first 1s
Instagram Feed	`--platform feed`	`1:1`	3	Static-feel works well

Override any default with --aspect-ratio / --num-clips.

Quick Invocation Patterns

Single video, defaults:

bash run-youtube-shorts.sh --source "https://youtube.com/watch?v=VIDEO_ID"

TikTok preset — 5 clips, view in player:

bash run-youtube-shorts.sh --source "<URL>" --platform tiktok --view

Square Instagram feed clips:

bash run-youtube-shorts.sh --source "<URL>" --platform feed --num-clips 3

Batch — urls.txt with one URL per line:

xargs -a urls.txt -I{} bash run-youtube-shorts.sh --source "{}"

Async submit (returns request_id, poll later):

REQUEST_ID=$(bash run-youtube-shorts.sh --source "<URL>" --async --output-json - | jq -r '.request_id')
muapi predict wait "$REQUEST_ID" --download ./outputs

Output Schema

{
  "source_video_url": "...",
  "shorts": [
    {
      "title": "The one mistake that cost me $50K",
      "start_time": 124.3,
      "end_time": 187.6,
      "score": 92,
      "hook_sentence": "Nobody talks about this, but it killed my first startup...",
      "virality_reason": "Opens with a number + regret, peaks on a contrarian lesson",
      "clip_url": "https://.../short_1.mp4"
    }
  ]
}

When reporting back, surface for each clip: rank, score, time range, title, hook, and clip URL.

Common Mistakes to Avoid

Wrong aspect ratio for the platform — Shorts / TikTok / Reels are 9:16. The platform preset handles this; only override if you know why.
Padding to hit --num-clips — if the API returns fewer survivors, return what you have. Don't ship low-score filler.
Re-running on a 404'd clip URL — re-fetch the same request_id with muapi predict wait <id> rather than re-clipping.

Failure Modes

API key missing or rejected — surface the error; don't fabricate a key.
Job timed out — bump --poll-timeout and retry.
Source URL not reachable — upload the file via muapi upload file and pass the returned URL.
Fewer clips returned than requested — source had fewer rankable highlights. Return what came back with a note.

Done Criteria

The skill is done when:

result.shorts has up to num_clips entries, each with a working clip_url.
The user has been shown the ranked list (score, time range, title, hook, URL).
If --output-json was set, the file exists and parses.

FAQ

What does the muapi-youtube-shorts skill do?

How do I install muapi-youtube-shorts?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-youtube-shorts in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/muapi-youtube-shorts/ (personal) or .claude/skills/muapi-youtube-shorts/ (project).

Which AI agents can use muapi-youtube-shorts?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is muapi-youtube-shorts safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains muapi-youtube-shorts?

It is published by samuraigpt in samuraigpt/generative-media-skills. It has 2,667 recorded installs.