muapi-youtube-shorts
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 `/…
Install / Use
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-youtube-shortsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of muapi-youtube-shorts
muapi-youtube-shorts scores 91/100 on our quality scale, 1034th of 4,700 Development & Engineering skills we index (top 22%).
Its SKILL.md is 5.8 KB long, well organised into 13 sections with 7 code examples: a solid amount of guidance for an agent.
With 4,329 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so muapi-youtube-shorts is actively maintained.
- Our last check on 2026-10-28 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
muapi-youtube-shorts compared with similar skills
All 4 of these similar skills score higher than muapi-youtube-shorts; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| muapi-youtube-shorts (this skill)by SamurAIGPT | 91 | 4.3k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install muapi-youtube-shorts?
- Run
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-youtube-shorts. The install tabs above show the steps for each supported agent. - Which AI agents does muapi-youtube-shorts work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is muapi-youtube-shorts safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is muapi-youtube-shorts still maintained?
- The repository was last updated about 2 months ago, so muapi-youtube-shorts is actively maintained.
Skill content
View source on GitHubslug: muapi-youtube-shorts
name: muapi-youtube-shorts
version: "2.0.0"
description: 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.
acceptLicenseTerms: true
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-cliinstalled and authed (muapi auth configure)MUAPI_API_KEYavailable
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-clipsaren't passed. - Calls
muapi edit clipping(the/ai-clippingendpoint) 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_idwithmuapi 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-timeoutand retry. - Source URL not reachable — upload the file via
muapi upload fileand 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.shortshas up tonum_clipsentries, each with a workingclip_url.- The user has been shown the ranked list (score, time range, title, hook, URL).
- If
--output-jsonwas set, the file exists and parses.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
