Production-ready animations, transitions, backgrounds, and scenes for Remotion
TypeScript ai-agentsclaude-codedemo-videomcpmcp-servermodel-context-protocolmotion-designproduct-demoreactremotionshadcnvideo
feat: the skill fetches docs instead of bundling them
kapishdimaec6168623efe
diff --git a/content/changelog/2026-07-25-docs-for-agents.mdx b/content/changelog/2026-07-25-docs-for-agents.mdxindex 2f77bfa6..f0aafa33 100644--- a/content/changelog/2026-07-25-docs-for-agents.mdx+++ b/content/changelog/2026-07-25-docs-for-agents.mdx@@ -52,3 +52,7 @@ Six components were installable from the registry but had no documentation. They- CI now fails when a registry component has no docs page, when a page is missing its metadata, orwhen a page recommends a component that does not exist. The catalogue had drifted silently beforethis: ten shipped components were missing from the agent's view entirely.+- The [agent skill](/docs/getting-started/agent-skill) no longer bundles a copy of the catalogue —+ it reads these docs live. A component added today is visible to an agent whose skill was installed+ months ago, and a prop can no longer go stale in two places at once. The skill keeps what does not+ change per component: the two tiers, timing rules, and the recipes for composing a video.diff --git a/content/docs/compositions/ecosystem-constellation.mdx b/content/docs/compositions/ecosystem-constellation.mdxindex 42ff692e..f3d9b58d 100644--- a/content/docs/compositions/ecosystem-constellation.mdx+++ b/content/docs/compositions/ecosystem-constellation.mdx@@ -82,6 +82,12 @@ import { EcosystemConstellation } from "@/components/remocn/ecosystem-constellatdefault: '"#a855f7"',description: "Color of the hub, glow, and connection lines",},+ {+ name: "speed",+ type: "number",+ default: "1",+ description: "Time multiplier applied as frame × speed. Above 1 the satellites assemble and orbit sooner",+ },{name: "className",type: "string",diff --git a/content/docs/compositions/live-code-compilation.mdx b/content/docs/compositions/live-code-compilation.mdxindex 50324889..cd9bcf6f 100644--- a/content/docs/compositions/live-code-compilation.mdx+++ b/content/docs/compositions/live-code-compilation.mdx@@ -53,6 +53,12 @@ export const RemotionRoot = () => (default: '"#3b82f6"',description: "Color used for the JSX prop highlight, the HMR flash, and the default button background",},+ {+ name: "speed",+ type: "number",+ default: "1",+ description: "Time multiplier applied as frame × speed. The typing schedule is a fixed set of frame constants, so this shifts the whole sequence rather than remapping it cleanly — leave it at 1 unless you are matching an external beat",+ },{name: "className",type: "string",diff --git a/content/docs/getting-started/agent-skill.mdx b/content/docs/getting-started/agent-skill.mdxindex 7a8be884..ea6c9936 100644--- a/content/docs/getting-started/agent-skill.mdx+++ b/content/docs/getting-started/agent-skill.mdx@@ -4,12 +4,20 @@ description: Install the remocn agent skill with skills.sh so your AI generates---Remocn ships an **agent skill** — a knowledge pack that teaches AI coding agents (Claude Code and-friends) how to build videos with remocn: the full component catalog with props and durations,-design defaults, motion-design principles, and common anti-patterns.+friends) how to build videos with remocn: how the two component tiers differ, how to budget a+timeline, how to compose a video out of beats, and where to read the rest.Once installed, your agent picks the right components, budgets the timeline correctly, and stylesyour additions to match the library — without you pasting context every time.+<Note title="The catalog is not bundled">+ The skill does not carry a copy of the component reference. It reads these docs live, starting+ from [`/llms-components.txt`](https://remocn.dev/llms-components.txt) and following the link to+ each component's page. That way a component added today is visible to an agent whose skill was+ installed months ago, and a prop that changed cannot go stale in two places at once. Your agent+ needs network access to remocn.dev; without it, it will tell you rather than guess.+</Note>+## Install with skills.shThe skill lives in the [`skills/`](https://github.com/Remocn/remocn/tree/main/skills) folder of@@ -50,11 +58,20 @@ npx skills use Remocn/remocn@remocn | claude| File | Contents ||---|---|-| `SKILL.md` | Install flow, the two tiers, categories, patterns, design defaults |-| `references/components.md` | Every component — props, defaults, dependencies, duration & vibe |-| `references/design.md` | Anti-slop design defaults + tokens (palette, fonts, canvas) |-| `references/motion-principles.md` | The 12 motion principles adapted to remocn |-| `references/anti-patterns.md` | Common generation mistakes and their fixes |+| `SKILL.md` | Install flow, the two tiers and their differing APIs, canvas and timing rules, remocn-specific gotchas, and where to fetch everything else |+| `references/anatomy.md` | Composing a full video — template vs compose vs build, the product-demo beats, the good-vs-slop bar |+| `references/archetypes/` | Per-archetype recipes: product demo, changelog, feature announcement, OSS showcase, CLI demo, testimonial reel, year in review, pricing reveal, logo bumper |++What the skill reads from this site instead of bundling:++| URL | Contents |+|---|---|+| [`/llms-components.txt`](https://remocn.dev/llms-components.txt) | Every installable component with its use / avoid signal, natural length, vibe, tier and dependencies |+| `/docs/<section>/<name>.md` | One component's full reference — props, examples, all use / don't-use notes |+| [`/docs/craft/`](/docs/craft) | Design defaults, motion principles, anti-patterns |++Any docs URL serves raw Markdown when you append `.md`, so you can read the same pages your agent+does.## Prerequisitesdiff --git a/lib/docs-meta.test.ts b/lib/docs-meta.test.tsindex 7dd9e24f..6c8a016a 100644--- a/lib/docs-meta.test.ts+++ b/lib/docs-meta.test.ts@@ -191,6 +191,58 @@ describe("component pages carry selection metadata", () => {});});+describe("the agent skill points at pages that exist", () => {+ const skillSources = [...new Glob("skills/**/*.md").scanSync(".")].map(+ (file) => ({+ file,+ text: readFileSync(file, "utf8"),+ }),+ );++ const urls = skillSources.flatMap(({ file, text }) =>+ [...text.matchAll(/https:\/\/remocn\.dev(\/[^\s`)"']*)/g)].map((m) => ({+ file,+ path: m[1],+ })),+ );++ it("cites at least the component index", () => {+ expect(urls.some((u) => u.path === "/llms-components.txt")).toBe(true);+ });++ it("every cited docs page resolves to a real file", () => {+ const slugs = new Set(+ pages.map((p) =>+ p.file.replace(/^content\/docs\//, "").replace(/\.mdx$/, ""),+ ),+ );+ const broken = urls+ .filter(({ path }) => path.startsWith("/docs/"))+ .map(({ file, path }) => ({+ file,+ path,+ slug: path.replace(/^\/docs\//, "").replace(/\.md$/, ""),+ }))+ .filter(+ ({ slug }) =>+ !slug.includes("<") &&+ !slugs.has(slug) &&+ !slugs.has(`${slug}/index`),+ )+ .map(({ file, path }) => `${file} -> ${path}`);++ expect(broken).toEqual([]);+ });++ it("no longer ships a bundled component catalog", () => {+ const catalog = [+ ...new Glob("skills/remocn/references/components/**").scanSync("."),+ ];++ expect(catalog).toEqual([]);+ });+});+describe("navigation lists every page", () => {it("each component page appears in its section meta.json", () => {const missing: string[] = [];diff --git a/skills/remocn/SKILL.md b/skills/remocn/SKILL.mdindex dd045441..4f4ca4de 100644--- a/skills/remocn/SKILL.md+++ b/skills/remocn/SKILL.md@@ -13,15 +13,44 @@ description: >Copy-paste components for Remotion videos. Components install via `shadcn` and land in`components/remocn/` — you own the code.+## The catalog lives at remocn.dev++This skill does not carry a copy of the component catalog. There are ~240 components and they+change; a bundled copy goes stale silently. Read the live docs instead.++**Start every component search here:**++```+https://remocn.dev/llms-components.txt+```++One table per category, every installable component, each row carrying `Use for` / `Avoid for`,+natural length, vibe, tier, dependencies, and a link to its full page. Scan it, shortlist, then+fetch only the pages you shortlisted.++**One component's full reference** — props with descriptions, worked examples, all use / don't-use+notes — is the docs URL with `.md` appended:++```+https://remocn.dev/docs/typography/blur-out-up.md+https://remocn.dev/docs/transitions/whip-pan.md+https://remocn.dev/docs/ui/components/dialog.md+```++The index gives you the exact URL per component — don't guess the section from the name, several+components live somewhere non-obvious.++Fetch with whatever your environment provides (a web-fetch tool, `curl`, `WebFetch`). If the+network is unavailable, say so and stop — do not invent props, defaults, or durations from memory,+and do not substitute a component you have not read. A wrong prop name fails at build; an invented+duration silently clips the animation.+## InstallationPrerequisites: a Remotion project (`npx create-video@latest`).```bash-# Add any component (namespaced shadcn registry)shadcn add @remocn/blur-out-up--# Component lands at components/remocn/blur-out-up.tsx````@remocn/<name>` is the canonical namespaced form (configured under `registries` in@@ -46,23 +75,7 @@ remocn has two kinds of components — they have **different APIs**:select, command-menu, tooltip…). State-based props (`state`, `style`, `variant`, `theme`).**No `speed` prop.** Built on `@remocn/remocn-ui`.-## Component categories--Pick by what you're building. The catalog is split one file per component under-`references/components/`. **Start at `references/components/index.md`** — a router table grouped by-these categories with a `Use for` / `Avoid for` signal per component. Scan it, pick candidates, then-open only the `references/components/<name>.md` files you need (full props, example, all use / don't-use-notes). Don't read every file.--| Category | Tier | Use for |-|---|---|---|-| **Text Animations** | `remocn` | Reveal/replace/emphasize text (`typewriter`, `blur-out-up`, `tracking-in`, `rolling-number`, `shimmer-sweep`…) |-| **Backgrounds & Effects** | `remocn` | Animated foundations, cursors, one-shot effects (`simulated-cursor`, `confetti`, `backdrop`, `paper-wobble`, `ink-arrow`) |-| **Shaders** | `remocn` | WebGL shader backdrops, frame-driven for deterministic renders (`shader-mesh-gradient`, `shader-warp`, `shader-voronoi`, `shader-god-rays`, `shader-metaballs`…) |-| **Transitions** | `remocn` | TransitionSeries presentations between two scenes (`whip-pan`, `push-through`, `focus-pull`, `grain-dissolve`, `wave-wipe`…) |-| **UI Blocks** | `remocn` | Interface sims for product demos (`terminal-simulator`, `glass-code-block`, `animated-bar-chart`, `progress-steps`…) plus paper props (`paper-sticker`, `polaroid`) |-| **AI & Social Cards** | `remocn` | Brand/product card scenes (`chat-gpt`, `claude-code`, `v0`, `github-stars`, `x-follow-card`…) |-| **UI Primitives** | `remocn-ui` | shadcn-style primitives for video (`button`, `dialog`, `select`, `command-menu`, `tooltip`…) |+The index's `Tier` column tells you which one you are looking at before you open the page.## Component patterns@@ -76,6 +89,9 @@ Conventions differ by tier — don't assume animation-tier props on a primitive.- Transitions: lowercase factories (e.g. `whipPan(props)`) returning a `TransitionPresentation` — pass to `TransitionSeries.Transition` via `presentation`, pace with `linearTiming` / `springTiming`.- `className?: string` on the root.+Not everything filed under transitions is a presentation: `slide-swap` and `spring-settle` are scene+sequencers that take a `scenes` array and own the whole timeline. The page says which one you have.+### UI Primitives (`remocn-ui`)- State-based, **not** `speed`-based: `state` (e.g. `"open"` / `"closed"`), `style`, `variant`,@@ -115,15 +131,15 @@ import { Sequence, Series } from "remotion";### Canvas & timing- **Canvas standard:** `1280×720 @ 30fps`. Components are laid out for it.-- **Budget each Sequence around the component's natural length** — the `Length` column in- `components/index.md` (and each file's `Natural length`). Under-budgeting clips the animation;- over-budgeting leaves dead air.-- **Tone matching:** each catalog entry carries a `vibe` tag (`tech`/`premium`/`data`/`clean`/- `playful`/`social`/`paper`) — pick components whose vibe fits the brand. `paper` is the- stop-motion kit: a quantized ~10-poses-per-second clock, handwriting and ink. Those components- read as one world, so mix them with each other rather than with the smooth tiers.-- **Palette & fonts:** stay within the library's tokens (`references/design.md` → tokens) so your- own elements don't clash.+- **`Length` is the component's own motion, not the whole beat.** For a transition it is the value+ to pass to `linearTiming` / `springTiming`; for everything else it is the frame the animation+ finishes on. Treat it as the floor for the `Sequence` and add hold time when the element should+ stay on screen after it settles. `state-driven` means the component renders from its `state` prop+ and has no duration of its own.+- **Tone matching:** each entry carries a `vibe` tag (`tech`/`premium`/`data`/`clean`/`playful`/+ `social`/`paper`) — pick components whose vibe fits the brand. `paper` is the stop-motion kit: a+ quantized ~10-poses-per-second clock, handwriting and ink. Those components read as one world, so+ mix them with each other rather than with the smooth tiers.## Design defaults — avoid AI-slop@@ -132,8 +148,14 @@ default tracking, sentence case, solid text color, subtle 1px elevation — no dletter-spacing, ALL-CAPS, gradient text-fills, or glow shadows. Never strip these traits from acomponent whose essence *is* the effect (`tracking-in`, social-card gradients, designed elevation).-Full do/avoid examples + design tokens: `references/design.md`. Motion quality (timing,-anticipation, staging, easing): `references/motion-principles.md`.+Full do/avoid examples, design tokens, motion principles and the anti-pattern list live in the+Craft section:++```+https://remocn.dev/docs/craft/design-defaults.md+https://remocn.dev/docs/craft/motion-principles.md+https://remocn.dev/docs/craft/anti-patterns.md+```## Gotchas (remocn-specific)@@ -158,16 +180,23 @@ Don't dump components — compose one story. When asked to build a full video ("3. **Use the recipe** — `references/archetypes/index.md` routes to per-archetype builds: content contract(infer → ask → placeholder), duration variants, beat→component slots, and a worked`<TransitionSeries>` skeleton.-4. **Pick each beat's component** from `references/components/index.md`; match the `vibe` tag to the- brand and budget its `Sequence` per Canvas & timing above.+4. **Pick each beat's component** from `https://remocn.dev/llms-components.txt`; match the `vibe` tag+ to the brand and budget its `Sequence` per Canvas & timing above.5. **Check the quality bar** — one accent, sentence-case kinetic type, real content, no glow halos, nofeature-list enumeration. See `references/anatomy.md` §3.## Reference+Bundled with this skill — the judgment that does not change per component:+- `references/anatomy.md` — composing a full video: strategy (template/compose/new), the product-demo beats, and the good-vs-slop quality bar.- `references/archetypes/index.md` — router to per-archetype build recipes (product-demo flagship + changelog, feature-announcement, oss-showcase, cli-tool-demo, testimonial-reel, year-in-review, pricing-reveal, logo-bumper): content contract, duration variants, beat→slot map.-- `references/components/index.md` — router table (all components, grouped by category, with `Use for` / `Avoid for`). Open `references/components/<name>.md` for one component's full props, example, and use / don't-use notes.-- `references/design.md` — anti-slop design defaults (do/avoid) + design tokens (palette, fonts, canvas).-- `references/motion-principles.md` — motion-design principles adapted to remocn + Remotion.-- `references/anti-patterns.md` — common generation mistakes and their fixes.++Fetched from remocn.dev — everything that tracks the components:++- `https://remocn.dev/llms-components.txt` — the component index. Always start here.+- `https://remocn.dev/docs/<section>/<name>.md` — one component's full reference.+- `https://remocn.dev/docs/craft/design-defaults.md` — anti-slop defaults and design tokens.+- `https://remocn.dev/docs/craft/motion-principles.md` — motion principles adapted to remocn.+- `https://remocn.dev/docs/craft/anti-patterns.md` — common generation mistakes and their fixes.+- `https://remocn.dev/llms.txt` — index of the whole documentation, if you need something else.diff --git a/skills/remocn/references/anatomy.md b/skills/remocn/references/anatomy.mdindex a9072666..6209cd69 100644--- a/skills/remocn/references/anatomy.md+++ b/skills/remocn/references/anatomy.md@@ -1,7 +1,7 @@# Video Anatomy & Composition StrategyHow to turn "make a product demo with remocn" into a coherent video. Read this before composing.-The component catalog is `components/index.md`; the per-archetype recipes are in `archetypes/` (start at `archetypes/index.md`).+The component catalog is `https://remocn.dev/llms-components.txt`; the per-archetype recipes are in `archetypes/` (start at `archetypes/index.md`).This file has three layers, kept separate:1. **Strategy** — template vs compose vs build-new.@@ -71,10 +71,10 @@ Derived from real reference demos. The good ones (CrowdReply, Flowith, HeyGen, m- **Long videos ride a narrative thread.** If it must run 60s+, carry it with a character / story (good Notion demo: the "Bug Wrangler" agent doing real tasks), never a feature list.### Slop — never do these (each seen in a bad reference)-- **Keep gradients / glow restrained — small and subtle, never large or dominant.** This is about *dosage*, not presence. A small, sparing gradient accent is fine (good_04 React Bits — restrained, not big, not much of it). Slop is a *large, saturated, full-frame* gradient wash (bad_04's hot-pink background) or a soft radial **halo behind headings** (both shadcn promos — the #1 tell). The hook gets life from motion and the accent, not a glow blob. See `design.md`, [no decorative glows].+- **Keep gradients / glow restrained — small and subtle, never large or dominant.** This is about *dosage*, not presence. A small, sparing gradient accent is fine (good_04 React Bits — restrained, not big, not much of it). Slop is a *large, saturated, full-frame* gradient wash (bad_04's hot-pink background) or a soft radial **halo behind headings** (both shadcn promos — the #1 tell). The hook gets life from motion and the accent, not a glow blob. See `https://remocn.dev/docs/craft/design-defaults.md`, [no decorative glows].- **No feature-list / catalog enumeration.** Naming feature after feature ("Row Selection", "Pagination", "Sorting"…) over the same screenshot, or dumping every component in a gallery, is not a video — it has no narrative. Tell one problem → solution → proof story instead.- **No placeholder / lorem content.** "Scene A", "Scene B", "First", "Your UI", "Selected element", `TASK-####` filler. If real content is missing, use honest English placeholders the user will obviously replace — never ship lorem as the final.-- **No ALL-CAPS heavy blocks, no decorative letter-spacing, no gradient text.** (A red ALL-CAPS "VISUAL EDITOR" block is slop.) See `design.md`.+- **No ALL-CAPS heavy blocks, no decorative letter-spacing, no gradient text.** (A red ALL-CAPS "VISUAL EDITOR" block is slop.) See `https://remocn.dev/docs/craft/design-defaults.md`.- **No walls of dense, unreadable text** (tiny terminal dumps filling the frame). Show a few legible lines, not a transcript.- **No monotony.** Don't repeat the same slide/screenshot under different labels. Each beat must advance the story.- **Don't run long by enumerating.** 100s+ of feature-listing drags. If the content is genuinely long, give it a strong repeating rhythmic device (e.g. a question→answer cadence) or split into multiple videos.diff --git a/skills/remocn/references/anti-patterns.md b/skills/remocn/references/anti-patterns.mddeleted file mode 100644index 1373e1a2..00000000--- a/skills/remocn/references/anti-patterns.md+++ /dev/null@@ -1,109 +0,0 @@-# remocn Anti-Patterns--Common mistakes when generating remocn videos. Each is something the model tends to do wrong.--## 1. Clipping a component by under-budgeting its Sequence--Every component has a natural length (the `Length` column in `components/index.md`, and the-`Natural length` meta line in each `components/<name>.md`). Budget the `Sequence` around it.--```tsx-// ❌ blur-out-up needs ~90f, gets cut at 30-<Sequence durationInFrames={30}><BlurOutUp text="Launch" /></Sequence>-// ✅-<Sequence durationInFrames={90}><BlurOutUp text="Launch" /></Sequence>-```--## 2. Mounting a transition as a component--Transitions are presentations for `@remotion/transitions` — pass them to `TransitionSeries.Transition`, never mount them directly.--```tsx-// ❌-<WhipPan />-<SceneB />-// ✅-<TransitionSeries>- <TransitionSeries.Sequence durationInFrames={70}><SceneA /></TransitionSeries.Sequence>- <TransitionSeries.Transition- timing={linearTiming({ durationInFrames: 26 })}- presentation={whipPan()}- />- <TransitionSeries.Sequence durationInFrames={70}><SceneB /></TransitionSeries.Sequence>-</TransitionSeries>-```--## 3. Animation-tier props on a UI Primitive--Primitives (`remocn-ui`) are state-based and have **no `speed`**. Drive them with `state`.--```tsx-// ❌-<Dialog speed={2} />-// ✅-<Dialog state="open" />-```--## 4. Wrong canvas size--The standard composition is `1280×720 @ 30fps`. Components are laid out for it. Don't invent-`1920×1080` and wonder why things are off-center.--## 5. Animating layout properties--Animate `transform` (and individual `translate`/`scale`), never `top`/`left`/`width`/`height` —-layout animation reflows every frame and breaks split layouts.--```tsx-// ❌ left: interpolate(frame, [0,30], [0,200])-// ✅ transform: `translateX(${interpolate(frame,[0,30],[0,200])}px)`-```--## 6. Non-deterministic code--Renders are multi-pass — `Math.random()`, `setInterval`/`setTimeout`, `Date.now()` all produce-flicker or diverging frames.--```tsx-// ❌ const x = Math.random();-// ✅ import { random } from "@remotion/random"; const x = random(`seed-${frame}`);-```--## 7. Mishandling registryDependencies--Dependencies install **automatically** — don't tell the user to add them manually, and don't-inline-copy a dependency's code. Also: don't import deeper than one path segment-(`@/components/remocn/<name>`); the tsconfig glob doesn't resolve `<name>/helpers`.--## 8. Loading fonts mid-render--Load fonts once before render via `@remotion/google-fonts` (`loadFont()`), not inside a component-body per frame. Unloaded fonts flash fallback in the export.--## 9. Hardcoding a background on a component--remocn components render **transparent** — they don't own a background. Set the scene background-with `backdrop` (or your own container), not by hardcoding a fill into the component.--## 10. Slop styling on your own additions--ALL-CAPS + wide tracking + gradient text + glow shadows on text *you* add. See `design.md`.--## 11. Everything enters on one frame--Stagger sibling entrances (3–6f). Landing a whole group simultaneously reads robotic. See-`motion-principles.md` → Follow-Through & Overlapping Action.--## 12. Promoting the wrong layer under a slow zoom--Text under `drift` trembles — glyph rasters snap to whole device pixels while the zoom keeps them-in sub-pixel motion. The fix is one `willChange: "transform"` layer per **text container**. Never-promote per-word/char spans (many small text layers shimmer even at rest) and never `Drift` itself-(borders become resampled texture — 1px lines pulse between sharp and blurry as the scale creeps).-See `components/drift.md` → Text under drift.--```tsx-// ❌ <Drift><div style={{ willChange: "transform" }}>{scene}</div></Drift> — borders pulse-// ❌ chars.map((c) => <span style={{ willChange: "transform" }}>{c}</span>) — shimmer at rest-// ✅ bordered card unpromoted; inner text block gets willChange: "transform"-```diff --git a/skills/remocn/references/archetypes/changelog.md b/skills/remocn/references/archetypes/changelog.mdindex 187ab9d6..42dd7245 100644--- a/skills/remocn/references/archetypes/changelog.md+++ b/skills/remocn/references/archetypes/changelog.md@@ -4,7 +4,7 @@A regular-release recap: show the version number and a human-readable list of changes (Added / Fixed /Changed), close on a footer with a link and date. Calm and legible — the list must read, not dazzle.-Read `../anatomy.md` first; pick components from `../components/index.md`.+Read `../anatomy.md` first; pick components from `https://remocn.dev/llms-components.txt`.## Beatsdiff --git a/skills/remocn/references/archetypes/cli-tool-demo.md b/skills/remocn/references/archetypes/cli-tool-demo.mdindex 49f8bc29..b392d42d 100644--- a/skills/remocn/references/archetypes/cli-tool-demo.md+++ b/skills/remocn/references/archetypes/cli-tool-demo.md@@ -5,7 +5,7 @@Demo a CLI or dev tool by running a real command to a visible result. The terminal is the product surface — show abelievable command typed, output streaming line by line as instant steps, and the final artifact or success state.Two variants: short (social clip, grounded in monid ~18s) and standard (launch / conference ~43s).-Read `../anatomy.md` first; pick components from `../components/index.md`.+Read `../anatomy.md` first; pick components from `https://remocn.dev/llms-components.txt`.## Beatsdiff --git a/skills/remocn/references/archetypes/feature-announcement.md b/skills/remocn/references/archetypes/feature-announcement.mdindex 277436c7..42017402 100644--- a/skills/remocn/references/archetypes/feature-announcement.md+++ b/skills/remocn/references/archetypes/feature-announcement.md@@ -3,7 +3,7 @@**Family:** A. Product & Launch · **Default duration:** ~12s (360f @30fps) · **Format:** 16:9 · **Vibe:** premiumA single-feature reveal: a quiet kicker sets expectation, the feature name arrives at full scale, then one benefit line lands with an accent highlight on the key word. Three beats, one idea — this is "Introducing X" for a tweet or changelog banner, not a feature list.-Read `../anatomy.md` first; pick components from `../components/index.md`.+Read `../anatomy.md` first; pick components from `https://remocn.dev/llms-components.txt`.## Beatsdiff --git a/skills/remocn/references/archetypes/index.md b/skills/remocn/references/archetypes/index.mdindex 9ce796b0..f27924f1 100644--- a/skills/remocn/references/archetypes/index.md+++ b/skills/remocn/references/archetypes/index.md@@ -2,7 +2,7 @@Router for video archetypes. **Pick the archetype that matches the user's ask, then open that`<name>.md`** for its full recipe (beats → slots → contract). Read `../anatomy.md` first for the-strategy, the beat language, and the good-vs-slop bar; pick components from `../components/index.md`.+strategy, the beat language, and the good-vs-slop bar; pick components from `https://remocn.dev/llms-components.txt`.`product-demo` is the fully-worked flagship; the others are compact recipes.| Archetype | Family | Use for | Duration |diff --git a/skills/remocn/references/archetypes/logo-bumper.md b/skills/remocn/references/archetypes/logo-bumper.mdindex f5d1bb5e..1ad8a257 100644--- a/skills/remocn/references/archetypes/logo-bumper.md+++ b/skills/remocn/references/archetypes/logo-bumper.md@@ -3,7 +3,7 @@**Family:** H. Brand & Identity · **Default duration:** ~4.5s (135f @30fps, ±15f with wordmark length) · **Format:** 16:9 · **Vibe:** premiumA brand insert: the wordmark assembles, the mark draws or scales in, the lockup holds. Used as a standalone intro sting, a series opener (with corner brackets and a tagline), or a closing brand card. One mark, one accent, total restraint — this archetype is where over-decoration is most tempting and most wrong.-Read `../anatomy.md` first; pick components from `../components/index.md`.+Read `../anatomy.md` first; pick components from `https://remocn.dev/llms-components.txt`.## Beats@@ -28,7 +28,7 @@ Transitions: none internal — the bumper is atomic. Connect to surrounding cont| Bumper variant: bracket frame + tagline | — | **`bumper-frame`** — corner brackets (strokeDashoffset draw, 4f stagger per corner) + tagline/CTA rows + `mode: 'intro' \| 'outro'` that mirrors choreography || Accent pop (launch bumper only) | `confetti` — one burst on a product-launch sting; skip entirely on a standard brand insert | — |-`logo-enter` ([`../components/logo-enter.md`](../components/logo-enter.md)) renders a brand or partner **chip cluster** ("works with Stripe, GitHub, Vercel"). A single product mark always needs the new `logo-sting` component.+`logo-enter` ([`logo-enter`](https://remocn.dev/docs/social/logo-enter.md)) renders a brand or partner **chip cluster** ("works with Stripe, GitHub, Vercel"). A single product mark always needs the new `logo-sting` component.The two new components are reusable across the entire H family: `logo-sting` is the atomic mark primitive that H1/H3/H4 all share; `bumper-frame` wraps it for series openers and closers.diff --git a/skills/remocn/references/archetypes/oss-showcase.md b/skills/remocn/references/archetypes/oss-showcase.mdindex 34e3caf2..c05e77a9 100644--- a/skills/remocn/references/archetypes/oss-showcase.md+++ b/skills/remocn/references/archetypes/oss-showcase.md@@ -3,7 +3,7 @@**Family:** D. Developer/OSS · **Default duration:** ~13s (390f @30fps, scales with contributor count N) · **Format:** 16:9 · **Vibe:** techAn OSS repo announcement: establish the repo name, count up stars and forks, reveal the contributor community, show the install command, close on a GitHub CTA. The traction numbers are the story spine — they must land with satisfying momentum, not slide by as decoration.-Read `../anatomy.md` first; pick components from `../components/index.md`.+Read `../anatomy.md` first; pick components from `https://remocn.dev/llms-components.txt`.## Beatsdiff --git a/skills/remocn/references/archetypes/pricing-reveal.md b/skills/remocn/references/archetypes/pricing-reveal.mdindex 05528099..8692a702 100644--- a/skills/remocn/references/archetypes/pricing-reveal.md+++ b/skills/remocn/references/archetypes/pricing-reveal.md@@ -3,7 +3,7 @@**Family:** I. Sales & Conversion · **Default duration:** ~12s (360f @30fps) · **Format:** 16:9 · **Vibe:** premiumA sales scene that walks viewers through pricing tiers, elevates the recommended plan, and closes on a CTA. The recommended tier is the single focal point — every other element frames it. Restrained by design: one accent color, one highlighted column, one ask.-Read `../anatomy.md` first; pick components from `../components/index.md`.+Read `../anatomy.md` first; pick components from `https://remocn.dev/llms-components.txt`.## Beatsdiff --git a/skills/remocn/references/archetypes/product-demo.md b/skills/remocn/references/archetypes/product-demo.mdindex 4718a6e4..5a8e456b 100644--- a/skills/remocn/references/archetypes/product-demo.md+++ b/skills/remocn/references/archetypes/product-demo.md@@ -34,7 +34,7 @@ the user only for what's missing, then fall back to honest English placeholders.## Step 3 — map beats to component slots-Pick one slot per beat from these candidates (full props in each `../components/<name>.md`):+Pick one slot per beat from these candidates (full props at `https://remocn.dev/docs/<section>/<name>.md`, linked from the index):| Beat | Slot candidates | Notes ||---|---|---|@@ -47,7 +47,7 @@ Pick one slot per beat from these candidates (full props in each `../components/| **Transitions** | `push-through` (going deeper), `focus-pull` (refined shift), `whip-pan` (energy), or plain `fade()` from `@remotion/transitions/fade` (neutral cut) | pass to `TransitionSeries.Transition` as `presentation`; text-swap components (`fade-through`, `shared-axis-*`) mount inside a scene instead |Budget each `<TransitionSeries.Sequence durationInFrames>` around the component's natural length-(`Length` in `../components/index.md`). Standard ~45s split: Hook 165 · Positioning 120 · Product reveal+(`Length` in `https://remocn.dev/llms-components.txt`). Standard ~45s split: Hook 165 · Positioning 120 · Product reveal150 · Features 450 (across 2–4) · Proof 300 · CTA 171.## Step 4 — assemble (raw `<TransitionSeries>`)diff --git a/skills/remocn/references/archetypes/testimonial-reel.md b/skills/remocn/references/archetypes/testimonial-reel.mdindex df1f42ee..e08ca2ca 100644--- a/skills/remocn/references/archetypes/testimonial-reel.md+++ b/skills/remocn/references/archetypes/testimonial-reel.md@@ -3,7 +3,7 @@**Family:** C. Growth & Social Proof · **Default duration:** ~14s (430f @30fps for N=3, scales with quote count) · **Format:** 16:9 · **Vibe:** cleanCycle real customer quotes one at a time — each card springs in, holds while the quote text plays word-by-word, then fades through to the next. Close on an aggregate proof number ("Join 12,000+ people who found their flow") so the social proof lands on data, not sentiment alone. One accent color throughout; background is a muted `shader-grain-gradient` on a solid dark canvas.-Read `../anatomy.md` first; pick components from `../components/index.md`.+Read `../anatomy.md` first; pick components from `https://remocn.dev/llms-components.txt`.## Beatsdiff --git a/skills/remocn/references/archetypes/year-in-review.md b/skills/remocn/references/archetypes/year-in-review.mdindex 6bf23bd6..949ccd9b 100644--- a/skills/remocn/references/archetypes/year-in-review.md+++ b/skills/remocn/references/archetypes/year-in-review.md@@ -3,7 +3,7 @@**Family:** E. Data & Metrics · **Default duration:** ~20s (600f @30fps, N=4) · **Format:** 16:9 · **Vibe:** data / premiumA mounting sequence of headline numbers — one stat fills the full frame per beat — building urgency as entry stagger compresses, culminating in a RecapWall that shows every figure at once. The rhythm accelerates; the numbers do the talking.-Read `../anatomy.md` first; pick components from `../components/index.md`.+Read `../anatomy.md` first; pick components from `https://remocn.dev/llms-components.txt`.## Beatsdiff --git a/skills/remocn/references/design.md b/skills/remocn/references/design.mddeleted file mode 100644index fc023b22..00000000--- a/skills/remocn/references/design.md+++ /dev/null@@ -1,121 +0,0 @@-# remocn Design Defaults--These are defaults for content **you author** — your own text, scene chrome, cards, and overlays.-They keep output from reading as generic AI-slop. They are **not** retroactive rules for the-prebuilt remocn components.--> **Scope & exception.** Never strip these traits from a component whose essence *is* the effect:-> `tracking-in` is letter-spacing; the shader backdrops and the social cards are-> gradients; some primitives use subtle elevation. The rules govern your additions, not the library.-------## No decorative letter-spacing--Don't widen tracking on text you add. It reads as "designed by AI".--```tsx-// ✅ default tracking-<div style={{ fontSize: 64, fontWeight: 600 }}>Ship faster</div>--// ❌ decorative wide tracking-<div style={{ letterSpacing: "0.3em", textTransform: "uppercase" }}>SHIP FASTER</div>-```--**Exception:** `tracking-in` animates letter-spacing as its whole effect — that's intentional.--## No uppercase / ALL-CAPS defaults--Prefer sentence case. Don't `text-transform: uppercase` and don't write ALL-CAPS string literals-as defaults.--```tsx-// ✅-<BlurOutUp text="Launch week" />--// ❌-<BlurOutUp text="LAUNCH WEEK" />-```--Use ALL-CAPS only when the design genuinely calls for it (e.g. a glitch/tech label), not as a-reflex for emphasis.--## No gradient text-fills or decorative washes--Gradients belong on **backgrounds** that are meant to be gradients — not as text fills or-decorative overlays sprinkled on cards.--```tsx-// ✅ gradient as an intentional background-<ShaderMeshGradient colors={["#0ea5e9", "#9333ea"]} />-<div style={{ color: "#fafafa" }}>Clear, solid text on top</div>--// ❌ gradient-clipped text + decorative wash-<h1 style={{- background: "linear-gradient(90deg,#0ea5e9,#9333ea)",- WebkitBackgroundClip: "text",- color: "transparent",-}}>Slop headline</h1>-```--**Exception:** `shimmer-sweep` uses `background-clip: text` deliberately; social-card cover/avatar-fallbacks render gradients by design.--## No glow / heavy shadows--No colored glows, no large blur radii, no multi-layer drop-shadows. Use a 1px border or a small,-neutral elevation if you need separation.--```tsx-// ✅ subtle elevation-boxShadow: "0 1px 2px rgba(0,0,0,0.08)"-border: "1px solid #e5e5e5"--// ❌ glow / oversized shadow-boxShadow: "0 0 80px 20px rgba(14,165,233,0.6)"-filter: "blur(60px)" // decorative glow blob-```--Threshold to avoid: shadow/`filter` blur `> ~24px`, any `spread`, any colored/glow shadow,-stacked shadow layers. See also: decorative radial-gradient/blur "glow blobs" are never acceptable.--**Exception:** components that intentionally model real UI elevation (cards, modals) keep their-designed shadow — don't flatten them.-------## Design tokens--When you author your own text, surfaces, or chrome, pull from the palette the library already-uses so your additions don't clash with the components.--### Canvas--`1280×720 @ 30fps`. Font weights in use: `400 · 500 · 600 · 700`.--### Palette--| Role | Hex |-|---|---|-| Primary text (on light) | `#171717` |-| Text on dark | `#fafafa` / `#ffffff` |-| Background — near-black | `#0a0a0a` / `#050505` |-| Surface — zinc | `#27272a` |-| Accent — green / success | `#22c55e` |-| Accent — sky | `#0ea5e9` |-| Accent — violet | `#a855f7` / `#7c3aed` |-| Brand — warm (Claude) | `#D97757` |--Stay within this set for your own elements. Brand cards (`claude-*`, `v0`, `chat-gpt`) carry their-own brand hex — don't override it.--### Fonts (`@remotion/google-fonts`)--| Use | Font |-|---|---|-| UI / body | `Inter` |-| Display | `Manrope` |-| Serif display | `Fraunces` |-| Code / mono | `JetBrainsMono` / `GeistMono` |--Load fonts before render (`@remotion/google-fonts/Inter` → `loadFont()`), never mid-frame.diff --git a/skills/remocn/references/motion-principles.md b/skills/remocn/references/motion-principles.mddeleted file mode 100644index 086bef6d..00000000--- a/skills/remocn/references/motion-principles.md+++ /dev/null@@ -1,108 +0,0 @@-# Motion Principles for remocn--The 12 classic animation principles, adapted to **composing Remotion videos from remocn blocks**.-Each entry: the principle → the Remotion mechanic that expresses it → a remocn component that-demonstrates it → do/avoid tuned to remocn's restraint.--- This file is about **which** principle and **when** (intent). For **how** the APIs work- (easing curves, sequencing, spring config), see the `remotion-best-practices` skill.-- Motion must stay restrained — see `design.md`. Where a principle pushes toward boldness- (squash, exaggeration), the cap below always wins.-- Idiom note: remocn components drive motion with `spring()` and `interpolate()` + `Easing`.- Examples here use that same idiom.--The 8 principles below are routinely useful when assembling scenes; the remaining 4 (character--animation territory) are compressed at the end.-------## 2. Anticipation--A short wind-up before the action makes it feel intentional: a drawer dips before it expands.--- **Mechanic:** `spring()` with light overshoot, or a brief reverse `interpolate` (e.g. `−4px`)- for 1–3 frames before the main move.-- **remocn:** `spring-scale-in`.-- **Do/Avoid:** keep the wind-up to 1–3 frames, ≤110% scale. ❌ No bouncy cartoon recoil.--## 3. Staging--Direct the eye: one clear idea per scene. Clear the stage before introducing the next element.--- **Mechanic:** `<Sequence>` / `<Series>` to isolate beats; stagger entrances so only one focal- element moves at a time; dim/scale-down what's leaving.-- **remocn:** most Compositions.-- **Do/Avoid:** one focal action per beat. ❌ Don't enter five elements on the same frame.--## 5. Follow-Through & Overlapping Action--Nothing stops at once; elements arrive staggered. Lighter things lead, heavier lag.--- **Mechanic:** per-element delay offsets (`frame - index * stagger`) on the same animation.-- **remocn:** `staggered-fade-up`, `short-slide-right`.-- **Do/Avoid:** stagger 3–6 frames between siblings. ❌ Don't land a whole group on one frame- (reads robotic) and don't over-stagger (feels sluggish).--## 6. Slow In & Slow Out--Ease into and out of poses — almost nothing should move linearly.--- **Mechanic:** `interpolate(..., { easing: Easing.out(Easing.cubic) })`; sharp curve = snappy,- gentle = graceful.-- **remocn:** transitions (`whip-pan`, `focus-pull`), most text reveals.-- **Do/Avoid:** default to ease-out for entrances. ❌ Linear `interpolate` for visible motion- unless it's a constant drift (e.g. marquee, grid pan).--## 7. Arc--Living motion follows curves, not straight lines — especially cursors and gestures.--- **Mechanic:** drive `x` and `y` from separate eased interpolations, or a bezier path.-- **remocn:** `cursor` + `useCursorPath`, social cards' cursor travel to the Follow button.-- **Do/Avoid:** curve cursor/hand paths. ❌ No straight diagonal cursor jumps.--## 8. Secondary Action--Supporting motion that reinforces the primary action without stealing focus.--- **Mechanic:** a small parallel channel — a cursor ripple on click, a shadow that breathes as a- card opens, a caret blink under typing.-- **remocn:** `x-follow-card` (ripple at click), `typewriter` (`caret` blink).-- **Do/Avoid:** secondary motion stays subtle and on-theme. ❌ Don't add competing animation that- splits attention.--## 9. Timing--Frame counts set weight: fast = light, slow = heavy. Vary timing for contrast.--- **Mechanic:** budget in frames @ fps (remocn defaults to 30fps; component durations run- ~90–300 frames). The `speed` prop scales the animation tier.-- **remocn:** every animation-tier component (`speed`); composition `durationInFrames`.-- **Do/Avoid:** match duration to weight — a heavy hero assemble is slower than a toast. ❌ Don't- reuse one duration for everything (kills rhythm).--## 10. Exaggeration (capped)--Push slightly past literal reality for clarity — but remocn's house style is restraint.--- **Mechanic:** a touch of overshoot on `spring()`, a brief ≤110% scale peak.-- **remocn:** `spring-scale-in`, `micro-scale-fade`.-- **Do/Avoid:** subtle UI exaggeration only (≤110%, gentle overshoot). ❌ No stretched/cartoon- exaggeration — this is the principle most likely to collide with `design.md`; the cap wins.-------## Rarely needed when composing blocks--Character-animation territory — reach for these only when hand-drawing motion, not when-assembling catalog components:--- **1. Squash & Stretch** — at most a 2–4% `scaleX`/`scaleY` volume trade on a hard landing- (`spring-scale-in`, `confetti`); rubber-band squash on text or cards fights `design.md`.-- **4. Straight-Ahead vs Pose-to-Pose** — remocn is pose-to-pose by construction:- `interpolate(frame, [k0, k1, k2], [v0, v1, v2])` keyframes are your poses; straight-ahead- (frame-by-frame) is for hand-drawn organic effects.-- **11. Solid Drawing** — keep one `perspective` / vanishing point per scene when stacking 3D- layers (`push-through`, `perspective-marquee`).-- **12. Appeal** — emergent from staging + timing + restraint, not a knob; more motion ≠ more- appeal.