HuberyLL/ponlai / skills/building-cinematic-stylised-realism
building-cinematic-stylised-realism
VerifiedBuilds or fixes a stylised-realism rendered image on a physically based renderer, and decides where a change to the look belongs, when grass reads too dark, a frame looks flat or grey, a colour cast covers everything, the distance is too clear or too milky, or a new material does not sit with the rest. Keeps materials at physically plausible values, puts the style in three places only (the content chosen, global lighting parameters per weather and time of day, post-processing), works in the order content, materials, lighting, atmosphere, exposure, tone mapping, colour grading, and sends a wrong look to the earliest layer that can cause it. Use with three.js WebGPU renderers, or any physically based renderer, whenever a material, the lighting, the haze or fog, the exposure, the tone mapping or the colour grade is changed to improve or fix the look.
Building a stylised-realism rendered image
A physically based base carries the rendered image: materials authored with physically plausible values, lit by a physically based lighting model. The style sits on top of it, in three places only. This skill places a change in the right layer, finds and checks material values, and hands parameter values that need fitting to reference images to another skill.
Rules most often broken without notice
- Never tune a material to make up for the lighting, the atmosphere or post-processing. Doing so bakes the lighting's error into the albedo, and the material breaks again each time the lighting changes.
- When something downstream looks wrong (a dark surface, a colour cast, a flat frame), check the layers upstream of the material first, in the order below. Change a material last, and only when its values lie outside the real range or its shading model lacks something the real surface does.
- When something upstream changes (content, a material, the lighting), check everything downstream of it again: the atmosphere, the exposure, the tone mapping and the colour grade were set for the old input.
- Make a departure from physically plausible values for a whole class of things or for the whole world at once. Record a departure for one material by name, with its reason.
- A change of style is a global parameter that changes everything together, never a fix on one object.
- Never fit a material to a finished frame. Reference images may set lighting, atmosphere and
post-processing parameters (the skill
fitting-a-look-to-reference-images); content is chosen by eye against them. - Judge the whole frame first, at the main view, weather and time of day. Crops and region statistics find causes; they do not judge.
The model
The base is physical: materials with physically plausible values, one lighting model for every surface, and exposure from a physically based camera. The style goes in three places:
- Content: what is in the rendered image, chosen and simplified. Few kinds of plant per place, quiet textures with little noise, pushed colour, and leaves that let more light through, each decided for a whole class of things at once.
- Lighting: the lighting departs from physical correctness globally, per weather and time of day (the ambient balance, the sky's brightness, the bounce light, the haze).
- Post-processing: exposure, tone mapping, colour grading and the night treatment.
The order of the layers is content, materials, lighting, atmosphere (haze, fog), exposure, tone mapping, colour grading. It is arranged by dependency: each layer takes the one before it as input. The order is this skill's own, not a published standard. It rests on two established practices: physically based rendering with materials kept separate from lighting, and film look development in neutral lighting before shot lighting. The look is built over many rounds in this order, never in one pass from zero. The reasons and the sources are in background.md. This renderer's parameters, layer by layer, are in look-parameters.md.
The project's facts: the binding
Steps marked "(binding: X)" need facts about the project: where its look is described, its kept
weathers and main view, where measured look values live, its named departures, and its tools for
the rendered image. Read section X of docs/bindings/building-cinematic-stylised-realism.md when
you reach the step. If the project's AGENTS.md or CLAUDE.md names another file for this skill,
that file wins.
If there is no binding, find each fact in the project (its art direction or style guide, its README, the look's tables or settings, its capture tools) and ask the user for what you cannot find. When the work ends, offer to write what you found as the binding, one section per step.
Workflow
Copy this checklist and keep it up to date:
- [ ] 1. Say what is wrong and place it
- [ ] 2. Content
- [ ] 3. Materials
- [ ] 4. Lighting and atmosphere
- [ ] 5. Exposure, tone mapping and colour grading
- [ ] 6. Check downstream and judge the whole frame
- [ ] 7. Record
Do only the steps the change needs, in this order. Work on the main weather and time of day first (a clear day at noon is the usual one), then the others.
1. Say what is wrong and place it (binding: Look)
- Write what is wrong in one sentence, in on-screen terms: what, where, in which weather and at which time of day, compared with what (the project's described look, a reference image, an earlier capture).
- Read the project's look description for what is intended there. An intended look is not a bug.
- Find the first layer to check in this table, and check the layers in its order. Stop at the first cause you find.
| What looks wrong | Check first | Then | Last |
|---|---|---|---|
| The whole frame too dark or too bright; a grey card off its expected value | Exposure: its key value and what it meters | The tone curve's mid grey | Never the albedos |
| One kind of surface too dark (the grass in sun) | Exposure, then the key light against the ambient light | The material's shading model: does it lack light transmitted through the leaf? | Its values, only if outside the real range |
| Shadowed areas too dark or too bright against sunlit ones | The ambient light: sky brightness, bounce light, ambient grade | Occlusion strength; local tone mapping, shadow contrast | Not the albedos |
| A colour cast over everything | White balance; the key light's and the sky's colour | The colour grade | Not the materials |
| One hue off across the whole frame (every green too yellow) | The lighting's colour; the colour grade's hue band for that hue | The class's values, together, within the real range | Never one material alone |
| The distance too clear, too milky or the wrong colour | The atmosphere: haze or fog density, height, colour | Exposure | Not the far materials |
| Highlights clip; the sky burns out | The exposure's highlight limit; the tone curve's shoulder | Bloom | Not the sky's own brightness alone |
| The frame flat or grey | Tone curve contrast; local tone mapping | Ambient light against key light | Not the materials' contrast |
| The frame busy, noisy, hard to read | Content: fewer kinds, quieter textures | Colour grade contrast | Not a blur or a filter |
| The night looks like a darker day | The night treatment: night exposure, the Purkinje shift, the night white balance | The night lighting | Not the materials |
| Right at noon, wrong at one time of day or in one weather | The parameter keyframed by that time of day or weather | Never the materials | |
| One material wrong while all others are right in the same lighting | The material's shading model (transmitted light, fuzz, a wet film) | Its values against the real range |
2. Content (binding: Look)
Choose and simplify what is in the rendered image, by eye, with the project's look description and any reference images beside you. Decide for a whole class at once: which kinds of plant stand in a place, how quiet a texture is, and how far a class's colour is pushed within what the real thing could be. Content is chosen, not fitted to a number.
3. Materials (binding: Materials)
- Find the real values: the albedo (diffuse colour, linear), the roughness and, for leaves and thin things, how much light passes through. Take them from a scan of the real material, from a photograph in even daylight with a colour chart in frame (white-balanced and exposed on the chart's grey patches, read in linear values), or from a published measurement, credited.
- Write the values and their source beside the material.
- Check them against the range that real examples of that kind cover, and against the neighbouring materials. A value outside the range is a mistake in the source or a departure (see the rules above); never leave it in silently.
- Look at the material first under neutral, known lighting: a scene whose lighting you know, with an 18 % grey card, a grey ball, a chrome ball and a colour chart beside it, and post-processing with no style (neutral exposure, no grade). The grey card must land where the lighting says it should.
- Then place it in the main view at the main weather and time of day, then in the other kept weathers and times of day. Build it on the shared lighting model, so the same light reaches it as every other surface. The look's values come from the look's tables and are never written into the material.
4. Lighting and atmosphere (binding: Lighting and atmosphere)
Set the lighting parameters per weather and time of day: the key light against the ambient light, the sky's brightness and colour, the ground's bounce light, and the occlusion's strength. Then set the atmosphere: haze and fog density, height and colour. Each parameter changes every material together. This renderer's parameters are in look-parameters.md, Lighting and Atmosphere.
5. Exposure, tone mapping and colour grading (binding: Post-processing)
Set the exposure (what it meters and where its key value lands), then the tone mapping (the curve and local tone mapping), then the colour grade (white balance, lookup tables, hue bands), then the night treatment. The parameters are in look-parameters.md, Post-processing.
When the question becomes "what value should this lighting, atmosphere or post-processing
parameter have" and you have reference images, go to the skill
fitting-a-look-to-reference-images. Material values never go there.
6. Check downstream and judge the whole frame (binding: Check)
- Capture the views the change affects before and after it, at the main weather and time of day, then at the others the project keeps.
- Judge the whole frame first: does it read as the described look? Then measure what changed with crops and region statistics, and report the measured differences.
- Every layer downstream of the change was set for the old input: look at each one again.
7. Record (binding: Record)
- A departure from plausible values: its class or material, the value, the real range, the reason and its measured effect, recorded where the project keeps its art decisions.
- A measured look value worth keeping (a grey card's level, a lighting ratio): recorded where the project keeps measured values.
Scope
This skill covers surface values, lighting and post-processing. It does not cover form, texture detail or modelling.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |