Agent skill

Muapi Youtube Shorts

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Auto-generate viral 9:16 YouTube Shorts (or TikTok / Reels clips) from a long-form video.

Apache-2.0Auto-check passedMedia & Creative

Install Muapi Youtube Shorts

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill muapi-youtube-shorts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins muapi-youtube-shorts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/SamurAIGPT/Generative-Media-Skills/library/social/youtube-shorts .claude/skills/muapi-youtube-shorts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
muapi-youtube-shorts
GitHub stars
1.3k
Token cost
~1.5k tokens
SKILL.md length
574 words
Files
2 (incl. scripts)
Skills in repo
716
Repo updated
First seen
Licence
Apache-2.0

At a glance

Auto-generate viral 9:16 YouTube Shorts (or TikTok / Reels clips) from a long-form video.

  • Works in 3 steps: Collect Inputs → Verify Prerequisites → Run the Pipeline
  • Tasks that involve Video scripts and shorts
  • SKILL.md covers When to Use This vs. AI Clipping, Agent Execution Protocol, What Happens Server-Side and Platform Defaults, plus 5 more sections
  • Runs Shell scripts from its folder; calls bash and jq; reaches youtube.com; needs MUAPI_API_KEY

What it does

Muapi Youtube Shorts is an agent skill from hashgraph-online/awesome-codex-plugins. 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.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/run-youtube-shorts.sh`).

It sits in Media & Creative, covering Video scripts and shorts. It works with TikTok. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Video scripts and shorts

Example prompts

  • “/muapi-youtube-shorts”

Requirements

  • A Bash shell
  • A credential in MUAPI_API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Collect Inputs
  2. Verify Prerequisites
  3. Run the Pipeline

What it can do on your machine

Read from SKILL.md and the folder at commit 3e1456a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • youtube.com

    Also links to:

    • github.com
    • muapi.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MUAPI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Muapi Youtube Shorts loads about 1.5k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 574 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 3e1456a, republished under its Apache-2.0 licence (© hashgraph-online). 574 words, ~1,495 tokens.

Download SKILL.mdSave it as .claude/skills/muapi-youtube-shorts/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
muapi-youtube-shorts
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.
slug
muapi-youtube-shorts
version
2.0.0
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 / ReelsYou want full control over aspect / count
You want platform-tuned defaultsYou want raw timestamps (--coords-only)
You'd rather pass --platform tiktok than think about ratiosYou're integrating into a custom renderer

Agent Execution Protocol

Step 1 — Collect Inputs
InputDefaultNotes
--source—YouTube URL, hosted mp4 URL, or local file
--platformshortsshorts | tiktok | reels | feed (sets ratio + count defaults)
--num-clipsplatform defaultOverride clip count
--aspect-ratioplatform defaultOverride 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
bash library/social/youtube-shorts/scripts/run-youtube-shorts.sh \
  --source "<YOUTUBE_URL>" \
  --platform shorts \
  --num-clips 5 \
  --view

The script:

  1. Resolves the source (uploads local files to muapi CDN if needed).
  2. Picks platform defaults if --aspect-ratio / --num-clips aren't passed.
  3. Calls muapi edit clipping (the /ai-clipping endpoint) with the chosen params.
  4. 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

PlatformFlagAspectDefault clipsNotes
YouTube Shorts--platform shorts9:163Hook in first 1s
TikTok--platform tiktok9:165Higher energy, longer ok
Instagram Reels--platform reels9:163Hook in first 1s
Instagram Feed--platform feed1:13Static-feel works well

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


Show full SKILL.md (211 more words)Show less

Quick Invocation Patterns

Single video, defaults:

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

TikTok preset — 5 clips, view in player:

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

Square Instagram feed clips:

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

Batch — urls.txt with one URL per line:

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

Async submit (returns request_id, poll later):

bash
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

json
{
  "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

  1. Wrong aspect ratio for the platform — Shorts / TikTok / Reels are 9:16. The platform preset handles this; only override if you know why.
  2. Padding to hit --num-clips — if the API returns fewer survivors, return what you have. Don't ship low-score filler.
  3. 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:

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

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in plugins/SamurAIGPT/Generative-Media-Skills/library/social/youtube-shorts of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • scripts/run-youtube-shorts.sh

Open the folder on GitHubat commit 3e1456a

Compare with similar skills

Muapi Youtube Shorts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Muapi Youtube Shorts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Muapi Youtube Shorts this skillhashgraph-online/awesome-codex-plugins1.3k—~1.5kAutomated safety check: PassApache-2.0
Viral Captions And Ctasvyralcontent/content-skills1341 repos~2.8kAutomated safety check: PassMIT
Shortform Idea Grillericosiu/ai-marketing-skills3.6k—~1.2kAutomated safety check: PassMIT
Viral Short Form Ideasvyralcontent/content-skills1341 repos~2.9kAutomated safety check: PassMIT
Viral Tiktok Contentvyralcontent/content-skills1341 repos~2.7kAutomated safety check: PassMIT
Viral Youtube Shortsvyralcontent/content-skills1341 repos~3kAutomated safety check: PassMIT

Similar skills

  • Viral Captions And Ctas

    vyralcontent/content-skills

    Write captions, on-screen text, hashtags, and CTAs for short-form video that earn saves and sends without tripping engagement-bait penalties.

    134 GitHub starsUsed in 1 repo~2.8k tokens
    Media & CreativeAuto-check passed
  • Shortform Idea Grill

    ericosiu/ai-marketing-skills

    Interview a founder or senior marketer one question at a time, mine current work and owned proof for net-new short-form video ideas, and return a ranked table with one five-second overlay hook…

    3.6k GitHub stars~1.2k tokensUpdated 18 days ago
    Media & CreativeAuto-check passed
  • Viral Short Form Ideas

    vyralcontent/content-skills

    Generate short-form video ideas at volume and stop the blank-page problem for good.

    134 GitHub starsUsed in 1 repo~2.9k tokens
    Media & CreativeAuto-check passed
  • Viral Tiktok Content

    vyralcontent/content-skills

    Write a tiktok script, a tiktok hook, or a fresh tiktok video idea shaped for how the FYP actually ranks content.

    134 GitHub starsUsed in 1 repo~2.7k tokens
    Media & CreativeAuto-check passed
  • Viral Youtube Shorts

    vyralcontent/content-skills

    Write and diagnose YouTube Shorts that hold attention on the Shorts Feed and route viewers into your long-form.

    134 GitHub starsUsed in 1 repo~3k tokens
    Media & CreativeAuto-check passed
  • Short Publish

    gug007/lpm

    Post a finished vertical lesson from ~/Movies/lpm-lessons/tiktok/<slug/ to YouTube Shorts (LPM channel, through Chrome) and TikTok (@lpm06557, from the user's iPhone through iPhone Mirroring) in…

    152 GitHub stars~3.1k tokensUpdated today
    Media & CreativeAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 715 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.3k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.3k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.3k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.3k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.3k GitHub stars~618 tokensUpdated today
    Auto-check passed

Works with

Questions about Muapi Youtube Shorts

What does Muapi Youtube Shorts do?

Auto-generate viral 9:16 YouTube Shorts (or TikTok / Reels clips) from a long-form video. Muapi Youtube Shorts is an agent skill from hashgraph-online/awesome-codex-plugins. Auto-generate viral 9:16 YouTube Shorts (or TikTok / Reels clips) from a long-form video.

When should I use Muapi Youtube Shorts?

Muapi Youtube Shorts fits situations like: tasks that involve Video scripts and shorts.

How do I install Muapi Youtube Shorts in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill muapi-youtube-shorts -a claude-code`. Or copy the skill folder (plugins/SamurAIGPT/Generative-Media-Skills/library/social/youtube-shorts in hashgraph-online/awesome-codex-plugins) into .claude/skills/muapi-youtube-shorts in your project. Claude Code loads it when a task matches its description.

How do I install Muapi Youtube Shorts in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill muapi-youtube-shorts -a codex`. Or copy the skill folder (plugins/SamurAIGPT/Generative-Media-Skills/library/social/youtube-shorts in hashgraph-online/awesome-codex-plugins) into .agents/skills/muapi-youtube-shorts in your project. Codex loads it when a task matches its description.

Can I use Muapi Youtube Shorts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill muapi-youtube-shorts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/muapi-youtube-shorts, .gemini/skills/muapi-youtube-shorts, .github/skills/muapi-youtube-shorts and .opencode/skills/muapi-youtube-shorts in your project.

What does Muapi Youtube Shorts need to run?

Going by SKILL.md and its folder, Muapi Youtube Shorts needs a shell for the scripts in its folder, the command-line tools its instructions call (bash and jq) and credentials named MUAPI_API_KEY. Our summary lists: A Bash shell; A credential in MUAPI_API_KEY.

Does Muapi Youtube Shorts access the network?

SKILL.md names 3 domains. In commands or code: youtube.com; the agent is likely to contact it when it follows the instructions. As links in the text: github.com and muapi.ai. This is read from the text; nothing was executed.

Is Muapi Youtube Shorts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Muapi Youtube Shorts use?

Muapi Youtube Shorts is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Muapi Youtube Shorts use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Muapi Youtube Shorts?

Skills that share tags, products or a category with Muapi Youtube Shorts: Viral Captions And Ctas (vyralcontent/content-skills, 134 stars), Shortform Idea Grill (ericosiu/ai-marketing-skills, 3.6k stars), Viral Short Form Ideas (vyralcontent/content-skills, 134 stars) and Viral Tiktok Content (vyralcontent/content-skills, 134 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Muapi Youtube Shorts?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,267 GitHub stars. The repository holds 716 skills in this directory. The repository was last updated on October 10, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.