Skip to content
cccskills
FreePublished on GitHub

add-new-package

Create a new @remotion package within the Remotion monorepo, a repository containing multiple packages. Set up its files, register it across the project, and prepare documentation, usage examples, and build configuration.

OriginalShow the original description

Add a new package to the Remotion monorepo, including package scaffolding, monorepo registration, documentation, build scripts, and release checklist updates. Use when creating a new @remotion package.

See how to install

Good for

  • Creating a new @remotion package
  • Registering a package across the monorepo
  • Adding documentation and usage examples
  • Setting up build and dependency configuration

Files included (1)

  • SKILL.md3.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Add a new Remotion package

Steps

  1. Create packages/<name>/ with these files:

    • package.json — copy from @remotion/light-leaks as template; update name, description, homepage, dependencies
    • tsconfig.json — extends ../tsconfig.settings.json, uses tsgo with emitDeclarationOnly: true, outDir: "dist", module: "es2020", moduleResolution: "bundler", target: "ES2022"
    • src/index.ts — exports
    • bundle.ts — Bun build script, externalize react, remotion, remotion/no-react, react/jsx-runtime, react/jsx-dev-runtime, react-dom
    • eslint.config.mjs — use remotionFlatConfig({react: true}) if React, {react: false} otherwise
    • .npmignore — copy from @remotion/light-leaks
    • README.md — package name, description, install command, link to docs
  2. Register in monorepo:

    • tsconfig.json (root) — add {"path": "./packages/<name>"} to references
    • packages/cli/src/list-of-remotion-packages.ts — add '@remotion/<name>'
    • packages/create-video/src/list-of-remotion-packages.ts — add '@remotion/<name>'
    • packages/studio-shared/src/package-info.ts — add to packages, descriptions, installableMap, apiDocs
  3. Documentation (packages/docs/docs/<name>/):

    • Add "@remotion/<name>": "workspace:*" to packages/docs/package.json dependencies (needed for twoslash snippets)
    • index.mdx — install tabs, table of contents, license
    • table-of-contents.tsx — TOCItem grid linking to component/function pages
    • Individual component/function .mdx pages
    • Edit packages/docs/sidebars.ts — add category
    • Edit packages/docs/components/TableOfContents/api.tsx — import table of contents and add section

See the writing-docs skill for details on writing documentation.

  1. Example usage:

    • Add "@remotion/<name>": "workspace:*" to packages/example/package.json
    • Create packages/example/src/<Name>/index.tsx
    • Register <Composition> in packages/example/src/Root.tsx
    • Add {"path": "../<name>"} to packages/example/tsconfig.json references
  2. Run bun i to install dependencies

  3. Build: cd packages/<name> && bun run make

Version

Use the current version from packages/core/src/version.ts.
For the documentation version, increment the patch version by 1 as it will only be released with the next Remotion release.

Patterns

  • Use "workspace:*" for internal dependencies
  • Use "catalog:" for shared external dependency versions
  • The make script is: tsgo && bun --env-file=../.env.bundle bundle.ts
  • Add "type": "module" to package.json
  • Add "@typescript/native-preview": "catalog:" to devDependencies
  • Types/main point to dist/index.d.ts and dist/index.js (not dist/cjs/)
  • Packages with React components need peerDependencies for react and react-dom

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

add-bug

FreeSummary

Add a reported Remotion bug to the bugs API with its affected versions, a short title, and upgrade guidance. Follow the existing entry format and place the new record first so recent bugs appear at the top.

  • Adding a reported bug to the Remotion bugs API
  • Recording which versions a bug affects
  • Including upgrade guidance in a bug description
remotion-dev/remotion65KUpdated Oct 18, 2026

add-cli-option

FreeSummary

Add a Remotion command-line or configuration option, or convert a hardcoded flag into a shared option definition. Connect parsing, configuration setters, help entries, and generated documentation so the option is consistently available and documented.

  • Add a new Remotion command-line flag
  • Convert a hardcoded flag into a shared option
  • Connect an option to Config setters
remotion-dev/remotion65KUpdated Oct 18, 2026

add-effect

FreeSummary

Add a new effect to @remotion/effects, including its implementation, package entry points, documentation, interactive demo, and preview images. Follow the package conventions and verify the changes with tests, formatting checks, and builds.

  • Implementing a new effect for @remotion/effects
  • Registering effect imports and parameter types
  • Creating documentation and an interactive effect demo
remotion-dev/remotion65KUpdated Oct 18, 2026

add-expert

FreeSummary

Add a person to the Remotion experts page by placing their portrait, entering their profile and contact links, and generating an expert card image. The instructions specify file locations, profile fields, and how to verify card generation.

  • Add a new person to the Remotion experts page
  • Register a portrait, specialties, and contact links
  • Generate an expert card image
remotion-dev/remotion65KUpdated Oct 18, 2026

add-sfx

FreeSummary

Add a new sound effect to @remotion/sfx, from registering the audio file to exporting its URL and documenting its use. The workflow covers playback examples, attribution, navigation entries, waveform generation, and the package build.

  • Add a sound effect to @remotion/sfx
  • Create documentation with playback and usage examples
  • Update sound effect navigation and waveform data
remotion-dev/remotion65KUpdated Oct 18, 2026

Add browser WebCodecs bugs to the Remotion Mediabunny documentation. It checks the linked issue’s title, filing date, reporter, and resolution, then adds a table row while preserving the existing format.

  • Adding a Chromium bug to the documentation
  • Recording WebKit or Firefox issues
  • Checking reporter details and fix status before adding a row
remotion-dev/remotion65KUpdated Oct 18, 2026

See all skills by remotion-dev

Report a problem with this skill