Skip to content

Production-ready animations, transitions, backgrounds, and scenes for Remotion

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.mdx
index 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, or
when a page recommends a component that does not exist. The catalogue had drifted silently before
this: 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.mdx
index 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-constellat
default: '"#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.mdx
index 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.mdx
index 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 styles
your 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.sh
The 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.
## Prerequisites
diff --git a/lib/docs-meta.test.ts b/lib/docs-meta.test.ts
index 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.md
index 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.
+
## Installation
Prerequisites: 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 d
letter-spacing, ALL-CAPS, gradient text-fills, or glow shadows. Never strip these traits from a
component 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, no
feature-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.md
index a9072666..6209cd69 100644
--- a/skills/remocn/references/anatomy.md
+++ b/skills/remocn/references/anatomy.md
@@ -1,7 +1,7 @@
# Video Anatomy & Composition Strategy
How 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.md
deleted file mode 100644
index 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.md
index 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`.
## Beats
diff --git a/skills/remocn/references/archetypes/cli-tool-demo.md b/skills/remocn/references/archetypes/cli-tool-demo.md
index 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 a
believable 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`.
## Beats
diff --git a/skills/remocn/references/archetypes/feature-announcement.md b/skills/remocn/references/archetypes/feature-announcement.md
index 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:** premium
A 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`.
## Beats
diff --git a/skills/remocn/references/archetypes/index.md b/skills/remocn/references/archetypes/index.md
index 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.md
index 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:** premium
A 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.md
index 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:** tech
An 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`.
## Beats
diff --git a/skills/remocn/references/archetypes/pricing-reveal.md b/skills/remocn/references/archetypes/pricing-reveal.md
index 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:** premium
A 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`.
## Beats
diff --git a/skills/remocn/references/archetypes/product-demo.md b/skills/remocn/references/archetypes/product-demo.md
index 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 reveal
150 · 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.md
index 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:** clean
Cycle 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`.
## Beats
diff --git a/skills/remocn/references/archetypes/year-in-review.md b/skills/remocn/references/archetypes/year-in-review.md
index 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 / premium
A 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`.
## Beats
diff --git a/skills/remocn/references/design.md b/skills/remocn/references/design.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.