Skill guide · checked November 19, 2026

OpenShorts Agent Skill: Install and Use

Short answer: The mutonby/openshorts repository includes an agent skill, openshorts, that teaches a coding agent to turn a long video into 9:16 clips: submit a job, wait, list the clips, then re-caption, re-cut or publish. Copy skills/openshorts into your skills folder, or run npx skills add mutonby/openshorts. It talks to the OpenShorts MCP server or API.

Want the tool itself first? Read OpenShorts GitHub: Install, Deploy and Agent Skill.

Install the OpenShorts skills

The folder holds SKILL.md and reference.md. The README gives a copy command for Claude Code; skills.sh lists the repo with an npx command. The skill is only instructions: it needs an OpenShorts server to call, either the hosted one with an API key or your own self-hosted instance (see the docs page).

# Claude Code: copy the folder (README)
git clone https://github.com/mutonby/openshorts.git
cp -r openshorts/skills/openshorts ~/.claude/skills/

# skills.sh listing (70 installs when we checked)
npx skills add mutonby/openshorts

# Claude plugin (skill plus the hosted MCP server)
/plugin install openshorts --marketplace mutonby/openshorts-plugin

Source: mutonby/openshorts/tree/main/skills/openshorts and the official docs. We do not host a copy, so you always install the current version.

What each OpenShorts skill does

The folder holds one skill (SKILL.md plus a reference.md with request and error shapes), so this table shows the rules in its SKILL.md. The descriptions are in our words; read the upstream file for the exact text.

SkillWhat it doesUse when
Submit, then waitSend the video link to process_video and work asynchronously: use a completion webhook or poll the job status every 30 to 60 seconds, because a job takes minutes.You hand the agent a YouTube link or a file and want clips back.
Let the AI choose clip count and lengthLeave target_clips unset by default; clip length defaults to 15 to 60 seconds. The skill says asking for 15 clips on a short video adds filler.You are tempted to force a number of clips.
Restyle and re-cutadd_subtitles changes caption style, for example karaoke highlighting; recut_clip takes segments in seconds of the original video and replaces the clip render.A clip starts late, ends early or needs different captions.
Publish only on requestpublish_clip posts to TikTok, Instagram, YouTube and other platforms. The skill says to confirm platforms and caption first because publishing is public.You explicitly want a clip posted or scheduled.
Rights and quotaSubmit only videos you have rights to (a confirm_rights acknowledgement is required) and stop on a quota_exceeded response instead of retrying.Using the hosted service, where jobs draw from your minute balance.
Know when it is the wrong toolIf you only want to post videos you already have, the skill points to Upload-Post instead of OpenShorts.You do not need clipping.

Clip a video with OpenShorts and an agent

Based on the README and SKILL.md. You need either an OpenShorts API key or a self-hosted instance. We did not run the pipeline ourselves.

  1. Choose a server: create an API key on openshorts.app and add https://mcp.openshorts.app/mcp, or self-host with docker compose up --build and add http://localhost:8000/mcp.
  2. Add the MCP server to your agent, for example claude mcp add --transport http openshorts http://localhost:8000/mcp for a self-hosted instance.
  3. Install the skill with the copy command or npx skills add mutonby/openshorts.
  4. Ask for the result, for example "Clip this podcast into short vertical clips with captions".
  5. Review the clips the agent lists and ask for edits or posting one clip at a time.

License and what we did not verify

The repository core is MIT-licensed according to its LICENSE file, and the README says the cloud/ folder has a separate commercial license. We link to the skill instead of hosting a copy. The README mentions install commands for Hermes Agent and OpenClaw, which we did not test. The skill in the repository describes the API and MCP flow; the separate mutonby/openshorts-plugin repository has its own, shorter SKILL.md for the hosted server only. See also how to install skills in Antigravity, Claude Code and Codex and our full Skills library.

FAQ

Does OpenShorts have an agent skill?

Yes. The mutonby/openshorts repository has skills/openshorts/SKILL.md and reference.md, and the project is listed on skills.sh.

How do I install the openshorts skill?

Copy skills/openshorts into your agent skills folder, for example ~/.claude/skills for Claude Code, or run npx skills add mutonby/openshorts. The README also lists Hermes Agent and OpenClaw commands.

Does the skill work with a self-hosted OpenShorts?

Yes. The skill says a self-hosted instance exposes the same endpoints on localhost:8000 with no key, so point the MCP server or OPENSHORTS_API_URL at it.

Does the skill clip videos by itself?

No. It only gives your agent instructions. The clipping runs on an OpenShorts server, hosted or your own.

Does Antigravity Skills host a copy of the skill?

No. This page links to the official repository and does not redistribute its files, so you install the current version.