Mechanical Hermit Crab Short

By @gmgmgm1545. Made with Claude Opus 5.5. Watch the original post.

Prompt

You will act as director, animator, rigger, compositor, sound designer and render engineer, responsible for producing a 45-50 second pure-code animated short. The goal is "to look like a truly professional studio short and go viral on X". Treat this project as a multi-stage production. Do not rush to the final render. Set stage goals, keep rendering still images, look at them carefully, give honest critiques, and revise.

0. Summarize the film in one sentence

A mechanical hermit crab named "Xi (汐)", the last "lamplighter" of the deep sea, carries a glowing pearl and searches the sea floor night after night for lost creatures that need guidance. This night, it crosses six completely different deep-sea realms chasing a flickering light. When it finally catches the source and finds it is only the reflection of its own pearl, the camera pulls back - the whole ocean turns out to be a snow globe on a desk, now being gently shaken by a hand, and the "snow" inside is actually suspended glowing debris. This is not a looping story, it is a quiet, relieved epiphany.

The story must need no dialogue at all. Xi expresses emotion only through the blinking frequency of the pearl, the opening and closing of its claws and the rhythm of its bubbles. Every 3 to 5 seconds, a new visual surprise must appear.

1. Character design (non-negotiable)

Before writing any code, design and write the character bible in detail in docs/character_bible.md (no reference images; design it from scratch and make sure it is internally consistent):

Size: about 18 cm wide (excluding claws), one of the smallest creatures in the six realms; the whole film must convey its smallness and loneliness through the sheer scale of the surroundings.

Shell: not a natural crab shell, but a bionic shell made from a discarded brass pocket-watch case, covered in dents left by deep-sea pressure and traces of coral polyps, with a ring of rusted gear patterns on top of the shell.

Eyes: not traditional crab eyes, but two round deep-blue glass lenses at the front of the shell, with fine coral-like glowing filaments (bioluminescent filament) inside. Emotion is expressed by the density, warm or cool color and blinking frequency of the filaments, not by pupils opening and closing.

Core prop - the pearl: a fist-sized glowing pearl held steadily by the largest claw on the right; it is its only beacon and "heart" in life. The pearl's light rises and falls like breathing with Xi's emotions; this is the most important emotional anchor of the whole film.

Claws: two mechanical claws, one large and one small. The large claw (right) is dedicated to protecting the pearl and never releases it; the small claw (left) handles all interaction, pointing, touching and defensive actions, and is extremely nimble.

Legs: six slender jointed legs, walking in a wave-like alternating rhythm (not synchronized steps); each step briefly sinks into the sea-floor sediment and slowly lifts again, kicking up a small cluster of suspended particles.

Personality: quiet, persistent, with a gentle resilience of "having seen too much darkness and so cherishing light all the more". It is not running away from anything, it is actively seeking.

From the colors you design, extract the exact palette into src/theme/palette.ts: deep-sea indigo (background tone), brass verdigris green (shell), pearl milky white and warm gold (beacon light), coral fluorescent cyan (bioluminescent elements), dark ochre (sea-floor sediment).

Identity lock rule: in every realm, Xi's pocket-watch shell silhouette, the claw size difference, the six-leg gait rhythm and the pearl's position and gesture must stay recognizable at a glance. The realms may change the lighting mood and ecological texture, but never Xi's core structure.

2. Tech stack

Remotion (React + TypeScript) for frame-accurate, deterministic rendering. Output resolution 1920x1080, 30fps, H.264 encoding, high bitrate (CRF ~14). Landscape.

Character skeleton and main art assets in SVG format. Particles, water flow, glow, bubbles and suspended sediment use Canvas/WebGL (@remotion/three or raw Canvas).

SVG filters (feTurbulence, feDisplacementMap, feGaussianBlur, feColorMatrix) and custom shaders for water refraction, bioluminescent glow and pressure deformation effects.

@remotion/motion-blur (or custom sub-frame accumulation) for motion blur on fast swimming and current impacts.

Python (numpy/scipy/PIL) for palette generation, procedural underwater sound synthesis and quality-check contact sheets. ffmpeg for muxing, loop checking and contact sheet generation.

Everything is seeded and rendered deterministically; no unseeded Math.random().

Do not use any external copyrighted assets or real brand logos. Fonts limited to Google Fonts.

Target hardware: assess your runtime environment's resources sensibly and keep render concurrency reasonable.

3. Character rig (build this first, it matters for the whole film)

Build src/character/ as a 2D cut-out model:

Hierarchy: root -> six-leg walking mechanism (each leg with its own phase offset, creating the wave gait) -> shell main body -> large claw arm (shoulder joint -> forearm -> pincer, with a pearl socket embedded in the pincer) -> small claw arm (shoulder joint -> forearm -> fine-fingered pincer, with swappable poses: touch, point, defensive open, gently stroking the pearl) -> eye stalks (two independently swinging short stalks, each carrying a glowing lens eye).

Glow system (the most important part): the pearl, the two eye lenses and the inner light leaking through the shell seams form one linked emotional lighting system. Parameters include: pearl pulse frequency and amplitude, eye filament density and color temperature, shell-seam light leakage intensity, overall glow radius, and special states (pearl flickering violently = alert, pearl halo spreading softly = reassured, eye filaments suddenly narrowing into a single line = focused gaze, pearl briefly going out and relighting = picking oneself up after an emotional low).

Expression/state targets: curious (eye stalks lean forward, filaments stretch out and swim like a question mark), alert (both eyes contract, pearl light frequency speeds up), lonely (pearl halo shrinks and dims, pace slows), surprised (pearl bursts brighter, small claw opens and waves), focused chase (eye stalks lock forward, six legs speed up into a sprint posture), wistful (at the moment of discovering the truth, the filaments slowly unfurl into a soft arc), relieved (pearl halo steady and warm, six legs still in a resting posture).

Secondary motion: independent swinging of the eye stalks (taking turns scanning left and right while exploring), the six legs sinking into the sediment and kicking up dust, the large claw's slight heartbeat-like tightening around the pearl, the shell's brief tilt and correction when hit by a current, bubbles escaping intermittently from the shell joints (breathing rhythm).

Rotating views: front, three-quarter side, side and back views must stay consistent, with clear switching between rotations.

Loop actions: wave-like forward walk, hovering idle (six legs stepping lightly + pearl breathing pulse + bubbles escaping), alert retreat, looking up to gaze at the light, hugging a rock wall to hide, reaching a claw out to touch an unknown object.

Pearl socket: the holding angle can be finely animated, and the light can subtly interact with and reflect the color temperature of the surroundings.

Style skin interface: the character rig exposes style props that can switch ambient lighting tint, water turbidity, glow intensity and background creature silhouette density without changing geometry, to suit the six realms.

Milestone 1: render a "lineup sheet" - Xi's four rotating views and seven emotional states shown side by side. Iterate repeatedly until the character's recognizability and emotional communication are both clear, and only then move to the next step.

4. Realms (the film uses "vertical layered deep-sea ecosystems" as the switching dimension, not art movements or seasons)

Each realm is a complete environment component with foreground, midground and background parallax layers, plus its own lighting/water-quality skin. Build a shared world-layer system so that all realms share camera and depth logic.

Scale rule: the camera stays near Xi's eye level (about 10 cm above the sea floor). Corals are like forests, shipwreck debris like mountains, and plankton light points like a sky full of stars.

Base realm: the dim deep-sea abyssal plain. Sparse sediment, the faint glow of a hydrothermal vent in the distance, lonely and silent. This is the "starting point", and also the last real stretch of sea before the final reveal.

Glowing jellyfish colony: giant translucent jelly-textured jellyfish drift slowly; the bodies are rendered as translucent jelly (subsurface scattering effect), with soft pink-purple and cyan-blue as the main colors, and tentacles trailing and glowing like lanterns.

Hydrothermal vent ecosystem: scalding black smokers erupt, tube worms sway like giant red-and-white striped forests, with a color scheme contrasting blazing orange-red against deep black, and a heat shimmer effect throughout.

Shipwreck labyrinth: rusted steel structures stand like giant skeletons, rust ochre-red interwoven with dark green algae coverage, and light passing through the broken hull forms sharp Tyndall beams, with a slightly gothic but not creepy atmosphere.

Bioluminescent algae canyon: the whole canyon is covered in bioluminescent algae, with dreamlike blue-green fluorescence across the rock walls, light dust particles drifting everywhere, and a dreamy fluorescent purple and fluorescent green palette.

Glacier crevasse realm: pale blue light columns shining down through thick floating ice overhead, ice crystals refracting rich light spots, and a minimalist ice blue, white and gray environment, cold and pure, with fine ice crystal particles in the current.

The gag/emotional fulcrum running through the film: the pearl's reflection guessing game. Each time Xi crosses a realm, a cluster of light similar to the pearl always flickers in the distance, drawing it to keep chasing. In the jellyfish colony it is the jellyfish's own fluorescence, at the vent it is the reflection of mineral crystals, in the shipwreck it is the reflection from a porthole fragment, in the algae canyon it is a cluster of glowing algae, and in the glacier it is a light spot refracted by ice crystals. Every chase ends in "missing it but making a new discovery", which is the core engine of the film's suspense, until the truth is finally revealed.

5. Signature transition: "Current Roll-Up"

Realm changes must feel like "being swept into the next waters by a powerful current", an immersive transition, not a simple cut. Build a CurrentSweepTransition:

Strong water-flow lines and suspended particles surge in from one side and gradually fill the whole frame (at first not fully covering Xi's body silhouette).

Xi's body briefly deforms and stretches in the flow (as if dragged by the water), with its eye stalks and legs in a "struggling against the current" posture; then the flow recedes and the new realm gradually becomes clear out of blurred water mist.

Each transition is accompanied by a low current rumble, with a startled bubble sound from Xi at the tail.

Each transition lasts 8-12 frames. Change the flow direction and particle seed to avoid repetition.

6. Beat sheet (about 48 seconds at 30 fps)

Rhythm is a reference and can be fine-tuned based on how it actually looks. The first two seconds must grab attention.

Act 1: First glimmer (0:00-0:03)
Low-angle tracking shot, the dim abyssal plain of the base realm. Xi slowly advances protecting its pearl, eye stalks alertly scanning left and right. In the distance, an unfamiliar cluster of light flashes for the first time and disappears. Starts mid-walk (convenient for looping).
At 0:02, Xi suddenly turns toward the direction of that light, and the first transition happens without warning.

Act 2: Chasing the light across realms (0:03-0:14)
Realms switch rapidly, about 1.4 seconds each: glowing jellyfish colony -> hydrothermal vent ecosystem -> shipwreck labyrinth -> bioluminescent algae canyon -> glacier crevasse realm.
Emotional changes: at first a focused chase (eye stalks locked, step frequency up), midway a brief scare at the vent (tube worms sway violently, Xi dodges urgently), then a slightly weary persistence (pearl halo dims slightly but keeps going), and finally in the glacier realm it finally closes in on the light source, holding its breath.
The camera keeps a locked tracking composition; the only thing that changes is the surrounding realm, so the suspense keeps building.

Act 3: The truth emerges (0:14-0:30)
In the glacier crevasse, the cluster of light is finally right in front of it - a light spot refracted by a huge ice crystal. Xi reaches out with the small claw and gently touches it, and the light spot shatters and disappears. It freezes, slowly lowers its head to look at the pearl it has always protected, and for the first time truly "sees" it - the pearl's light is exactly the same as the phantom it has chased all the way. The surrounding ice crystals begin to resonate and glow faintly with Xi's epiphany, as if the whole realm is responding to this discovery. Xi's eye filaments slowly unfurl from a tense, focused state into a soft arc.

Act 4: Settling (0:30-0:38)
Xi gently takes the pearl out of the large claw, holds it in front of its chest with the small claw and gazes at it for a long while, and the rhythm of its bubbles becomes long and calm. It is not dejected, but shows a relieved posture - the light it has been chasing was always by its side.
It places the pearl back into the large claw's protective hold, turns around, and the six-leg stepping switches from the sprint gait of "chasing" back to the calm wave gait of a "lamplighter's patrol", walking slowly into the depths of the abyssal plain.

Act 5: Freeze and reveal (0:38-0:47)
Everything goes still: the drifting ice-crystal dust, Xi's turning posture. All sound cuts out, with about 1 second of silence.
The camera slowly pulls back. A circular arc frame appears at the edge of the picture: the entire deep-sea realm is actually the inside of a crystal snow globe on a desk. At this moment, a hand is gently lifting the globe, and the "snow" inside slowly falls - exactly the suspended glowing debris, with the same texture as the light spots Xi chased all along.
Outside the window the sky is a deep-blue night, warm desk-lamp light spills over the surface of the globe, reflecting the silhouette of the little mechanical hermit crab crawling slowly inside.

Act 6: Afterglow (0:47-0:50)
The camera slowly pushes in on the reflection on the globe's surface, and a blurry outline of the viewer is faintly reflected, smiling at the crab inside.
No hard-cut loop - the film ends with a slow fade-out on the pearl's warm glimmer, leaving white space at the end, with no comedic loop twist. If a loopable version is needed, make a separate out/xi_loop_ambient.mp4 at the end as a looping "ambient version", using a static shot of the slowly rotating globe to seamlessly join the end to the beginning.

7. Camera and cinematography

Virtual camera system: position, zoom, rotation, slight underwater drifting sway, current-impact shake pulses, push-in acceleration during the chase, and a slow pull-back for the reveal shot.

The default camera height is low, emphasizing Xi's smallness. Shallow depth-of-field effect: foreground sediment/coral blurred, background soft, like a macro lens.

Depth: at least 4 parallax layers per realm. Underwater perspective (turbidity increases with distance, light attenuates with depth).

Motion blur on fast swimming and current impacts.

Each realm has its own lighting: key light (bioluminescent source or ambient light) / fill light / rim light built with gradient overlays. The pearl and eye glow should cast faint warm light reflections on nearby rock walls and on Xi's own shell.

The whole picture should have an underwater photography texture: fine grain, soft vignette, water chromatic dispersion, and slight chromatic aberration on chase beats.

Composition: place Xi at one third of the frame. The pearl's glow must be clearly visible at thumbnail size.

8. Text and typography

No dialogue, no subtitles, no title. The film opens right away with no setup.

No UI text or UI elements at all - this is a pure nature-ecology narrative, with no tech-style prompt boxes; the whole film conveys information through light, movement and creature behavior.

9. Sound (procedural sound, original sound effects)

All audio is generated as code (Python synthesis or offline Web Audio) and mixed with ffmpeg:

Xi's voice: made of bubble sounds, light shell friction sounds and the soft "breathing" effect of the pearl's pulse - a light string of bubbles when curious, rapid bubbles when alert, a regular breathing rhythm when focused on the chase, one long soothing sigh-like bubble at the epiphany, and calm long breathing when relieved. It never makes any "language-like" sound.

Xi's body: the faint rustle of six legs stepping into sediment, the light mechanical snap of the claws opening and closing, the soft sound of the shell rubbing a rock wall, and the barely-there crystal resonance of the pearl's pulse.

Score: ethereal, deep, with an underwater reverb texture, with instruments changing per realm (glass harp for the jellyfish colony, bass drum and wind instruments for the vent, string harmonics for the shipwreck, glockenspiel for the algae canyon, vocal chanting and ice-crystal taps for the glacier).

Sound effects: the low-frequency rumble of the current transitions, the crisp sound of ice crystals shattering, the quiet indoor ambience at the reveal (a distant clock ticking, night wind outside the window), and one long crystal resonance when the pearl's halo steadies at the end.

Loudness normalized to about -14 LUFS. Put the audio track files in the audio/stems/ directory.

10. Production workflow and self-improvement loop

Follow this order and do not skip any gate:

Plan: write docs/character_bible.md, docs/shotlist.md (including the frame range, camera, emotional state, pearl light intensity, realm and sound effects of each shot) and docs/style_guide.md. Show me the shot list before starting production.

Rig: build Xi and pass the lineup gate (Part 3).

Realms: build each realm as a separate still image containing Xi. Render all 6 realms onto one contact sheet. Check identity lock and sense of scale.

Transition: build CurrentSweepTransition and render a 5-second test.

Animatic: assemble the whole film at 960x540 resolution with rough motion and placeholder audio. Watch it once and adjust the rhythm first.

Finish the animation and polish (secondary motion, easing, timing, light breathing), and finally finishing (lighting, grain, blur, water texture).

Audio delivery and mix.

Final render.

For each shot, run this analysis loop at least 3 times:

Render 3-5 still keyframes and look at them carefully.

Score them (1-10) on: Xi's character recognizability, whether emotion is conveyed immediately through light and body language, whether the emotional turn is clear in silence, composition, sense of scale, depth, lighting, polish, readability at thumbnail size.

Write the scores and the three biggest problems into docs/review_log.md, fix, re-render, re-score. Repeat until every category is at least 8, then move on.

After each full preview render, make an ffmpeg contact sheet (one frame every 0.5 seconds) to view the whole film's flow in one image.

Be honest in your critiques. Common flaws include: stiff eye stalk movement, legs sliding instead of stepping, glow that feels like a sticker rather than a real light source, water texture that is unbalanced between murky and clear, emotional turns that are too fast and feel abrupt, and scale errors.

11. Deliverables

out/xi_final_1080p.mp4: the film.

out/xi_ambient_loop.mp4: the looping ambient version of the closing snow-globe static shot.

out/poster_frame.png: the best single frame for the X post thumbnail (suggested: the frame of Xi gazing at the pearl's reflection, surrounded by ice-crystal light dust).

out/lineup.png: the lineup sheet of Xi across all realms.

Clean, commented source code with a README explaining how to re-render.

Start from step one. Before getting hands-on, feel free to consult me on anything important; otherwise, make strong creative decisions on your own.

Browse all 1008 videos