Official agent skill

Upload R2

by remotion-dev in remotion-dev/remotion

Upload large Remotion repository assets to the Cloudflare R2 bucket behind remotion.media and replace local public/ assets with hosted URLs.

OfficialCustom licenceAuto-check: notesMedia & Creative

Install Upload R2

skills CLI

$ npx skills add remotion-dev/remotion --skill upload-r2 -a claude-code

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

GitHub CLI

$ gh skill install remotion-dev/remotion upload-r2 --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/remotion-dev/remotion.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/upload-r2 .claude/skills/upload-r2 && 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/

Paste into Claude Code

Install the "upload-r2" agent skill from https://github.com/remotion-dev/remotion/tree/main/.agents/skills/upload-r2 into .claude/skills/upload-r2/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upload-r2", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/remotion-dev/remotion/tree/main/.agents/skills/upload-r2

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add remotion-dev/remotion --skill upload-r2 -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install remotion-dev/remotion upload-r2 --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/remotion-dev/remotion.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/upload-r2 .agents/skills/upload-r2 && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "upload-r2" agent skill from https://github.com/remotion-dev/remotion/tree/main/.agents/skills/upload-r2 into .agents/skills/upload-r2/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upload-r2", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add remotion-dev/remotion --skill upload-r2 -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install remotion-dev/remotion upload-r2 --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/remotion-dev/remotion.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/upload-r2 .cursor/skills/upload-r2 && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "upload-r2" agent skill from https://github.com/remotion-dev/remotion/tree/main/.agents/skills/upload-r2 into .cursor/skills/upload-r2/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upload-r2", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/remotion-dev/remotion.git --path .agents/skills/upload-r2

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add remotion-dev/remotion --skill upload-r2 -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install remotion-dev/remotion upload-r2 --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/remotion-dev/remotion.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/upload-r2 .gemini/skills/upload-r2 && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "upload-r2" agent skill from https://github.com/remotion-dev/remotion/tree/main/.agents/skills/upload-r2 into .gemini/skills/upload-r2/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upload-r2", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install remotion-dev/remotion upload-r2

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add remotion-dev/remotion --skill upload-r2 -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/remotion-dev/remotion.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/upload-r2 .github/skills/upload-r2 && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "upload-r2" agent skill from https://github.com/remotion-dev/remotion/tree/main/.agents/skills/upload-r2 into .github/skills/upload-r2/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upload-r2", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add remotion-dev/remotion --skill upload-r2 -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install remotion-dev/remotion upload-r2 --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/remotion-dev/remotion.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/upload-r2 .opencode/skills/upload-r2 && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "upload-r2" agent skill from https://github.com/remotion-dev/remotion/tree/main/.agents/skills/upload-r2 into .opencode/skills/upload-r2/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upload-r2", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: upload-r2
GitHub stars: 62k
Token cost: ~535 tokens
SKILL.md length: 118 words
Files: 1
Skills in repo: 71
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Custom licence

At a glance

Upload large Remotion repository assets to the Cloudflare R2 bucket behind remotion.media and replace local public/ assets with hosted URLs.

Works in 6 steps: Find the main worktree → Load R2 credentials from the main worktree → Upload the file to the parser-media… → …
A file is too large for Git
Calls git, bun and curl; reaches remotion.media and 2fe488b3b0f4deee223aef7464784c46.r2.cloudflarestorage.com; needs AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY
A PR should avoid committing media binaries by hosting them on remotion.media

What it does

Upload R2 is an agent skill from remotion-dev/remotion, published by the product's own GitHub organization. Upload large Remotion repository assets to the Cloudflare R2 bucket behind remotion.media and replace local public/ assets with hosted URLs. Use when a file is too large for Git or when a PR should avoid committing media binaries by hosting them on remotion.media.

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Video production. It works with Remotion, Git and Cloudflare R2. The repository describes itself as: 🎥 Make videos programmatically with React.

When your agent uses it

A file is too large for Git
A PR should avoid committing media binaries by hosting them on remotion.media

Example prompts

“/upload-r2”

Requirements

A credential in AWS_SECRET_ACCESS_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

Find the main worktree
Load R2 credentials from the main worktree
Upload the file to the parser-media bucket using Bun's S3-compatible client
Verify the public URL
Replace local asset usage with the hosted URL and delete the local binary.
Run the focused lint or stylecheck for touched packages, then commit and push.

What it can do on your machine

Read from SKILL.md and the folder at commit 1e4c5de. 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
Shell commands in SKILL.md call:
- git
- bun
- curl
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:
- remotion.media
- 2fe488b3b0f4deee223aef7464784c46.r2.cloudflarestorage.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- AWS_ACCESS_KEY_ID
- AWS_SECRET_ACCESS_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Upload R2 loads about 535 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 118 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:21

nburger/remotion/packages/remotion-media/.env

NoteMentions a .env fileSKILL.md:27

nburger/remotion/packages/remotion-media/.env -e "import {S3Client} from 'bun'; const filePath='<local-file>'; const key

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); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 118 words (~535 tokens).

“Use this for large media assets that should be hosted on https://remotion.media/ instead of committed to Git.”

— opening of SKILL.md by remotion-dev, Custom licence

name: upload-r2

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/upload-r2 of remotion-dev/remotion.

Open the folder on GitHubat commit 1e4c5de

Compare with similar skills

Upload R2 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.

Upload R2 compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Upload R2 this skillremotion-dev/remotion	62k	—	~535	Automated safety check: Notes	Custom licence	today
Procedural Fish Rendervibe-motion/skills	1.3k	—	~419	Automated safety check: Pass	None	2 days ago
Remotion Best Practiceslyonjs/shortvid.io	147	32 repos	~1k	Automated safety check: Pass	MIT	2 days ago
Making Demo Videosnukeop/nuclear	19k	—	~892	Automated safety check: Pass	AGPL-3.0	yesterday
HyperFrames Video Entry Pointheygen-com/hyperframes	58k	3 repos	~5.2k	Automated safety check: Pass	Apache-2.0	today
Avatar Videocalesthio/OpenMontage	65k	—	~1.6k	Automated safety check: Pass	AGPL-3.0	4 days ago

Similar skills

Procedural Fish Render
vibe-motion/skills
Clone or update https://github.com/vibe-motion/procedural-fish and render procedural-fish animation to a video using the project's own render command.
1.3k GitHub stars~419 tokensUpdated 2 days ago
Media & CreativeAuto-check passed
Remotion Best Practices
lyonjs/shortvid.io
Best practices for Remotion - Video creation in React. An agent skill from lyonjs/shortvid.io.
147 GitHub starsUsed in 32 repos~1k tokens
Media & CreativeAuto-check passed
Making Demo Videos
nukeop/nuclear
A skill your agent uses when making a demo, tutorial, or feature video of Nuclear.
19k GitHub stars~892 tokensUpdated yesterday
Media & CreativeAuto-check passed
HyperFrames Video Entry Point
heygen-com/hyperframes
Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.
58k GitHub starsUsed in 3 repos~5.2k tokens
Media & CreativeAuto-check passed
Avatar Video
calesthio/OpenMontage
Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API.
65k GitHub stars~1.6k tokensUpdated 4 days ago
Media & CreativeAuto-check passed
Video Podcast Maker
Agents365-ai/video-podcast-maker
A skill your agent uses when the user gives a topic and wants an automated topic-driven narrated explainer, podcast, or knowledge-summary video (Bilibili / YouTube / Xiaohongshu / Douyin / WeChat…
1.7k GitHub stars~4.9k tokensUpdated 6 days ago
Media & CreativeAuto-check passed

More from remotion-dev/remotion

All 71 skills in this repo

Gh Stack
remotion-dev/remotion
Official
Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack.
62k GitHub starsUsed in 6 repos~2.4k tokens
Auto-check passed
Canvas Capture Extension
remotion-dev/remotion
Official
Rebuild, install, and reload the private Remotion Canvas Capture unpacked Chrome extension.
62k GitHub stars~868 tokensUpdated today
Auto-check passed
Nullable New Params
remotion-dev/remotion
Official
Fix newly added optional parameters, optional React props, and optional type/interface members in Remotion monorepo diffs by converting internal APIs to required nullable values and updating call…
62k GitHub stars~1k tokensUpdated today
Auto-check passed
Vercel
remotion-dev/remotion
Official
Set up a Codex monitor for Vercel deployments and preview URLs.
62k GitHub stars~1.2k tokensUpdated today
Auto-check passed
Writing Docs
remotion-dev/remotion
Official
Guides for writing and editing Remotion documentation. An agent skill from remotion-dev/remotion.
62k GitHub starsUsed in 1 repo~1.9k tokens
Auto-check passed
Find Unplanned Issues
remotion-dev/remotion
Official
Audit and clean the Remotion GitHub masterplan hierarchy. An agent skill from remotion-dev/remotion.
62k GitHub stars~673 tokensUpdated today
Auto-check passed

Works with

Questions about Upload R2

What does Upload R2 do?

Upload large Remotion repository assets to the Cloudflare R2 bucket behind remotion.media and replace local public/ assets with hosted URLs. Upload R2 is an agent skill from remotion-dev/remotion, published by the product's own GitHub organization.media and replace local public/ assets with hosted URLs.

When should I use Upload R2?

Upload R2 fits situations like: A file is too large for Git; A PR should avoid committing media binaries by hosting them on remotion.media.

How do I install Upload R2 in Claude Code?

Run `npx skills add remotion-dev/remotion --skill upload-r2 -a claude-code`. Or copy the skill folder (.agents/skills/upload-r2 in remotion-dev/remotion) into .claude/skills/upload-r2 in your project. Claude Code loads it when a task matches its description.

How do I install Upload R2 in Codex?

Run `npx skills add remotion-dev/remotion --skill upload-r2 -a codex`. Or copy the skill folder (.agents/skills/upload-r2 in remotion-dev/remotion) into .agents/skills/upload-r2 in your project. Codex loads it when a task matches its description.

Can I use Upload R2 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 remotion-dev/remotion --skill upload-r2 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/upload-r2, .gemini/skills/upload-r2, .github/skills/upload-r2 and .opencode/skills/upload-r2 in your project.

What does Upload R2 need to run?

Going by SKILL.md and its folder, Upload R2 needs the command-line tools its instructions call (git, bun and curl) and credentials named AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY. Our summary lists: A credential in AWS_SECRET_ACCESS_KEY.

Does Upload R2 access the network?

SKILL.md names 2 domains. In commands or code: remotion.media and 2fe488b3b0f4deee223aef7464784c46.r2.cloudflarestorage.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Upload R2 safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Upload R2 use?

Upload R2 has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Upload R2 use?

About 535 tokens (SKILL.md is roughly 2.1k 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 Upload R2?

Skills that share tags, products or a category with Upload R2: Procedural Fish Render (vibe-motion/skills, 1.3k stars), Remotion Best Practices (lyonjs/shortvid.io, 147 stars), Making Demo Videos (nukeop/nuclear, 19k stars) and HyperFrames Video Entry Point (heygen-com/hyperframes, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Upload R2?

remotion-dev (a GitHub organization, an official publisher) maintains it in remotion-dev/remotion, which has 62,235 GitHub stars. The repository holds 71 skills in this directory. The repository was last updated on October 7, 2026.

Source: remotion-dev/remotion on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Upload R2

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

More from remotion-dev/remotion

Related

Questions about Upload R2