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-pluginSource: 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.
| Skill | What it does | Use when |
|---|---|---|
Submit, then wait | Send 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 length | Leave 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-cut | add_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 request | publish_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 quota | Submit 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 tool | If 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.
- Choose a server: create an API key on openshorts.app and add
https://mcp.openshorts.app/mcp, or self-host withdocker compose up --buildand addhttp://localhost:8000/mcp. - Add the MCP server to your agent, for example
claude mcp add --transport http openshorts http://localhost:8000/mcpfor a self-hosted instance. - Install the skill with the copy command or
npx skills add mutonby/openshorts. - Ask for the result, for example "Clip this podcast into short vertical clips with captions".
- 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.
