mcpbeat

Upload R2

remotion-dev/upload-r2

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.

534 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
55471
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/remotion-dev/remotion --skill upload-r2

The instruction itself

2 sections, as written by the author

Upload R2 Asset

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

Workflow

  • Find the main worktree:
   git worktree list --porcelain

Prefer the worktree on refs/heads/main, usually /Users/jonathanburger/remotion.

  • Load R2 credentials from the main worktree:
   --env-file=/Users/jonathanburger/remotion/packages/remotion-media/.env

Do not print secret values. The required variables are AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY.

  • Upload the file to the parser-media bucket using Bun's S3-compatible client:
   bun --env-file=/Users/jonathanburger/remotion/packages/remotion-media/.env -e "import {S3Client} from 'bun'; const filePath='<local-file>'; const key='<remote-file-name>'; const client=new S3Client({accessKeyId:Bun.env.AWS_ACCESS_KEY_ID, secretAccessKey:Bun.env.AWS_SECRET_ACCESS_KEY, endpoint:'https://2fe488b3b0f4deee223aef7464784c46.r2.cloudflarestorage.com', bucket:'parser-media'}); const file=Bun.file(filePath); if (await client.exists(key)) { const stat=await client.stat(key); if (stat.size===file.size) { console.log('exists-same-size', key, file.size); process.exit(0); } } await client.write(key, file); const stat=await client.stat(key); console.log('uploaded', key, stat.size);"
  • Verify the public URL:
   curl -I --fail https://remotion.media/<remote-file-name>
  • Replace local asset usage with the hosted URL and delete the local binary.

Do not wrap remote URLs in staticFile(): staticFile() rejects http:// and https:// URLs. Use the URL string directly, for example:

   <Video src="https://remotion.media/example.mp4" />
  • Run the focused lint or stylecheck for touched packages, then commit and push.

How to use it

Copy the folder

Take remotion-dev/upload-r2 from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.