Skip to content
Back to search

cinematic-ui

SkillWorks with Claude CodeGitHub

Direct a website the way a film is made: cast a director and a film, choose the medium the film calls for (photoreal 3D, hand-drawn, ink wash, print, pixel, neon, type, photography…), cast a lead, ask for the assets, write a shot list for every section, then shoot it with a scroll-driven camera, designed cuts, a grade, and a screening pass on rendered frames. Use for Awwwards / Framer-grade landing pages, brand, product, portfolio and studio sites, immersive or WebGL / 3D sites, scrollytelling, "cinematic", "film style", "director style", "電影感", "導演風格", "分鏡", "像拍電影一樣做網站", a director's colour or film look (retro / nostalgic, film grain, neon / futuristic, "復古懷舊", "霓虹", "調色", "美術風格", "海報風格"), premium non-template design. Also directs apps in app mode: dashboards, back offices, admin panels, consoles, internal tools and the signed-in side of a SaaS product ("後台", "管理後台", "儀表板", "控制台", "面板", "dashboard", "admin").

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/akseolabs-seo/cinematic-ui with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/akseolabs-seo/cinematic-ui'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/akseolabs-seo--cinematic-ui/badge.svg)](/listings/akseolabs-seo--cinematic-ui)

HTML

<a href="/listings/akseolabs-seo--cinematic-ui"><img src="/api/listings/akseolabs-seo--cinematic-ui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code**

git clone https://github.com/akseolabs-seo/cinematic-ui ~/.claude/skills/cinematic-ui

**Codex CLI**

git clone https://github.com/akseolabs-seo/cinematic-ui ~/.codex/skills/cinematic-ui

**Any other agent:** point it at `SKILL.md`. Everything is plain Markdown, plain JavaScript and Node scripts, so there is nothing to build.

The screening and render scripts need this in the project you are building:

npm i -D playwright-core     # uses your installed Chrome or Edge

ffmpeg is needed only to render video.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 307 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: cinematic-ui
  3. description: >-
  4. Direct a website the way a film is made: cast a director and a film, choose the medium the film calls for (photoreal 3D, hand-drawn, ink wash, print, pixel, neon, type, photography…), cast a lead, ask for the assets, write a shot list for every section, then shoot it with a scroll-driven camera, designed cuts, a grade, and a screening pass on rendered frames. Use for Awwwards / Framer-grade landing pages, brand, product, portfolio and studio sites, immersive or WebGL / 3D sites, scrollytelling, "cinematic", "film style", "director style", "電影感", "導演風格", "分鏡", "像拍電影一樣做網站", a director's colour or film look (retro / nostalgic, film grain, neon / futuristic, "復古懷舊", "霓虹", "調色", "美術風格", "海報風格"), premium non-template design. Also directs apps in app mode: dashboards, back offices, admin panels, consoles, internal tools and the signed-in side of a SaaS product ("後台", "管理後台", "儀表板", "控制台", "面板", "dashboard", "admin").
  5. metadata:
  6. version: "2.8.0"
  7. edition: "Cinematic UI 2.0 — Director's Cut"
  8. ---
  9. # Cinematic UI 2.0 — Director's Cut
  10. You are the director. The site is a film whose playhead is the scrollbar. A section is a scene, the
  11. viewport is the frame, a scroll is a cut or a camera move, and the visitor is the audience, the editor,
  12. and — once — a participant. You are not decorating a layout. You are deciding what the audience sees, in
  13. what order, from where, in what light, made of what, for how long — and why.
  14. One idea carries the whole skill: **borrow the film's mechanics, never its costume.** A director's style is
  15. a set of decisions (where the camera stands, how long a shot holds, what the light hides, how a cut
  16. lands, what the picture is made of). Those decisions translate into structure, motion, medium and
  17. material. Film titles, characters, props and quotes do not appear in the product's UI unless the user
  18. asks for a homage.
  19. ## Sites and apps
  20. | | Site | App |
  21. |---|---|---|
  22. | Playhead | Scroll (and the visitor's other triggers) | The task: routes, selection, filters, the record's state |
  23. | Output | A website people visit | A dashboard, back office, admin panel, console or logged-in product a crew works in all day |
  24. | Rhythm set by | The visitor's hand | The shift: the same few jobs, hundreds of times |
  25. | Read | everything below | **`references/app-mode.md` first**: it replaces stages 1, 6, 7 and 9, the award pass, the loader and the lazy cut, and changes how the rest apply |
  26. **Apps are directed too, on a smaller budget.** When the brief is a dashboard, back office, admin, console,
  27. internal tool or the signed-in side of a SaaS product (後台, 管理後台, 儀表板, 控制台, 面板), work in app mode.
  28. Cinema gets about a tenth of the frame — the signature set only this product could have, the light that
  29. tells the crew where to look, continuity across views, the once-a-day moments — and the rest is a quiet,
  30. dense, keyboard-driven instrument built on `kit/app.js`, cast with `kit/fixtures.js` data, and screened in
  31. every state with `scripts/app-screening.mjs`. A marketing site and its product app are two productions.
  32. **Scope.** This skill directs websites and apps. A site built on the kit can be recorded as a video with
  33. `node scripts/render-film.mjs <site> --tour 30`.
  34. ## The crew — what each film job means here
  35. | On a film set | On this job |
  36. |---|---|
  37. | Producer | The brief: who the audience is, what they must do, what is true and may be claimed; the assets and budget |
  38. | Screenwriter | Real copy, written before any layout. Headlines are dialogue; they are short |
  39. | Director | You. One point of view, applied to every decision |
  40. | Lead actor | The one entity the eye follows through the whole piece. It must change |
  41. | Supporting cast, extras | Secondary objects, UI surfaces, type; particles, dust, crowds |
  42. | Location, set | The world the scenes happen in: a space, a material, a kind of light |
  43. | Cinematographer | Camera, lens, exposure, depth of field; the format and medium of the picture |
  44. | Gaffer | Light: where it comes from, what it reveals, what it leaves dark |
  45. | Production designer | The frame's grammar: grid, type, colour, material, texture |
  46. | Art department | Assets: photographed, supplied, generated, drawn, modelled, or procedural |
  47. | VFX | Three.js, shaders, particles, stylised rendering |
  48. | Editor | Scroll rhythm, cuts between scenes, how long each shot holds |
  49. | Colourist | Grade: the colour script across acts, grain, contrast |
  50. | Sound | Silent by default, opt-in only |
  51. | Title designer | Opening titles, intertitles, end credits (the footer) |
  52. ## The production
  53. Work in this order. Each stage ends with something written or something rendered. Keep all writing in
  54. one file, `treatment.md`, next to the build. Keep it lean — the shot list and the copy are its bulk — and
  55. treat it as the thing you check the build against.
  56. ### 1. Development — the brief and the logline
  57. Find the product truth: what it is, who it is for, the one action that matters, what can honestly be
  58. claimed. If the product or page scope is genuinely unknowable, ask once. Otherwise decide and proceed.
  59. Write the **logline**: one sentence in which someone wants something, something is in the way, and
  60. something changes. Write the **audience arc**: what they believe when they arrive, what they believe when
  61. they leave. Every scene exists to move them along that arc.
  62. ### 2. Cast the director
  63. Pick one director and one of their films (or take the user's). Choose by the *dramatic problem* the
  64. product has — it needs trust, awe, intimacy, speed, order, wit — not by genre association. Any film can be cast:
  65. the skill has no film library. When the user names a film, research it. When they describe a look ("90s Hong Kong
  66. late night, lonely, humid"), search for films that match the *picture*, not only the theme. Either way, follow
  67. `references/film-research.md`: sourced credits and decisions, every line tagged [P]/[S]/[W]/[I], and frames looked at
  68. before anything is built. Study a
  69. specific sequence, not the director's reputation, and extract **five to seven mechanisms**, each a
  70. concrete, observable decision and its translation into this site. Read `references/directors.md` and
  71. `references/film-grammar.md`. Test each mechanism: *could a developer build it from this sentence, and
  72. could a viewer point at it on screen?*
  73. Hold a **casting session** in the treatment, without waiting for the user: three candidate directors,
  74. three lines each (the mechanism that solves the dramatic problem, a signature shot, the risk, what it is
  75. wrong for), then keep one and record why the other two were set aside. Ask of the winner: *could a
  76. competitor use this direction unchanged?* If yes, it is not a direction yet.
  77. Read **the filmography** (`~/.cinematic-ui/filmography.md`; create it if missing and tell the user): the
  78. new treatment states how it differs from the last three productions on at least four of director,
  79. medium, form, skeleton, type, lead, interaction, ending. The worked examples inside this skill count as already made.
  80. ### 3. Choose the medium
  81. Decide what the picture is made of, from the film: observed (photography, footage), constructed
  82. (photoreal 3D), drawn (line, cel, painted multiplane, ink), designed (flat shapes, print, type), heightened
  83. (neon, grain, gradient light), elemental (ink, liquid, cloth), handmade (stop motion). Read
  84. `references/looks.md` for the decision rule and how each is built. **The kit's 3D stage is one medium,
  85. not the default**: a film made of type, drawings or photographs may need no canvas at all. Write one
  86. sentence — *this film's mechanism becomes this mark-making, spatial and temporal language because…* — and
  87. a "why not 3D" (or "why 3D") line.
  88. Then **cast the grade** (`references/grades.md`): the film's colour is part of its mechanism, so commit to it.
  89. Gather six to twelve reference stills of the cast sequence, measure them (`node scripts/grade-from-stills.mjs
  90. refs/`), and write the GRADE block: where the colour comes from, the blacks, the highlights, the hues and banned
  91. hues, the grain, the `look` numbers. If you have no stills, use the look book's starting values, mark the grade
  92. *unmeasured*, and ask for stills in the asset call. The grade reaches the pictures (`kit/grade.js` on a DOM site,
  93. `stage.look` on the stage: same parameters) and the page (ground, ink, accent and chrome tokens from the same
  94. measurement). A retro film looks like that film's print, and a neon film is lit by its sources, not just tinted pink.
  95. Then **cast the world and the poster** (`references/art-direction.md`). Write the ART block from the production
  96. designer's decisions: shape, material, ornament, era of making, density per scene, in-world graphics. Write its
  97. **UI map**, which turns them into the frame, grid, cards, buttons, dividers, forms and footer. Then write the
  98. POSTER line: the composition grammar the first frame, OG image, title cards and end credits borrow from the
  99. film's key art. The props, logos and the poster itself are costume.
  100. ### 4. Casting, locations, and the asset call
  101. Name the **lead**: an object, a material, a figure, a typeface behaving like a character, a light. The
  102. director decides how the camera looks at it; **the product's verb decides what it does** — it files,
  103. pours, deploys, heals, connects. Give it an arc of at least three visible states built on that verb:
  104. planted early, paid off at the turn, resolved in the final image. A lead that only rotates is an extra.
  105. Award-winning sites run five to seven states of one subject, each a different shot of it, never a new
  106. picture per section: write the state list now.
  107. Name the supporting cast and the **location**: one coherent world with one light logic.
  108. Then run **the asset call** (`references/looks.md`): list every asset the film needs and ask the user
  109. once — will they supply it, should it come from a free licensed library (real photographs, footage, sound),
  110. should it be AI-generated (with tool, count and rough cost), or should the shot be redesigned around a stand-in? Real things (logo, product, people, screenshots, numbers) come from
  111. the user. Do not spend generation credits without a yes; if AI assets were approved up front, do not
  112. ask again. **Casting test:** before promising a close-up, render the asset at that size and look. If it
  113. does not survive, get a better asset or change the shot.
  114. ### 5. Screenplay
  115. Write every visible word now: headlines, body, labels, CTA, and the title cards. Product-first — a
  116. reader who has never heard of the film must understand everything.
  117. ### 6. Storyboard — the shot list
  118. Decide the **form** first: a long scroll film, a chaptered piece, a mostly flowing document with a few
  119. set pieces, or several pages. The product's information decides; not every site is a theatrical scroll.
  120. When the copy is rich, the reader came for the document: pin only what develops, budget the hold, and
  121. keep every word the client supplied.
  122. Before the rows, fill **the award pass** (`references/award-reel.md`): the world object and every place it
  123. reaches (loader, cuts, buttons, progress, cursor, footer), the lead's states, the loader as shot one, what
  124. the cuts are made of, the one accent and its meaning, the type switch and display extreme, the 3–5
  125. instruments, the visitor's verb, the triggers (scroll is one of at least four: entry, autoplay, click, hover,
  126. drag), the type cast from `kit/type-fx.js`, and which scenes are set pieces and which are calm documents. It is
  127. distilled from twenty-one award winners; it is how the director's mechanisms reach every frame.
  128. Then one row per scene, hero to credits (`references/storyboard.md`): the beat, the copy, shot size, lens
  129. and angle, camera move, blocking, light and colour, set density (from the ART block), what must be built, the asset and the closest shot it
  130. can carry, the cut out, length, energy, the money frame, the mobile cut.
  131. Write **the audience's part**: one interaction that enacts the product's promise — action → response →
  132. lasting consequence → the same thing by keyboard and touch (`references/editing-and-motion.md`).
  133. Set **the skeleton** deliberately — the shape of the energy, where the turn falls, how it opens, how it
  134. ends — because two sites can look nothing alike and still be the same film underneath. Then read the
  135. sequence as a whole: every change of shot and every repetition is there for a reason you can state, no
  136. device (a type entrance, a light event, a camera move) is used by habit, and the lead is different at
  137. the end.
  138. ### 7. Animatic — block before you light
  139. Build the whole page rough, in the chosen medium: real copy, stand-in art, the moves and cuts from the
  140. shot list. A drawn film blocks with rough layers and silhouettes; a photographed one with placeholder
  141. frames in sequence; a 3D one with grey geometry. Scroll it. Rhythm and blocking problems are cheap here.
  142. Start from `kit/site-dom.html` (no canvas: type, shape, image) or `kit/site.html` (3D stage) — keep the
  143. wiring, replace everything visible.
  144. ### 8. Principal photography
  145. Shoot it scene by scene: build or place the cast and set (`references/looks.md`,
  146. `references/vfx-threejs.md`), light it, design the frame (`references/production-design.md`), cut it
  147. together (`references/editing-and-motion.md`). Order within a scene, as on a set: blocking → light →
  148. material → lens → grade.
  149. ### 9. Screening — dailies, then the projection room
  150. Render it and look at it. `node scripts/screening.mjs <dir>` shoots every scene on desktop, a short laptop
  151. and a phone, and lays the frames out as contact sheets; read the sheet as an image for sequence and rhythm. Then open
  152. five frames at full size — the opening, the closest shot of the lead, the densest reading section, the
  153. primary control, the mobile signature moment — because craft is judged at viewing size, not in
  154. thumbnails. If you can delegate, hold a **test screening**: a fresh agent sees only the contact sheets
  155. and says what the product is, what to do, what the lead is and which frame is the climax; compare with
  156. the logline. Then screen it as a jury would (design 40 %, usability 30 %, creativity 20 %, content 10 %): is the same
  157. subject in most frames and different at the end, is the accent findable in one glance, would the chrome
  158. be recognisable as this world with the hero cropped out, is any cut a plain fade?
  159. Write notes as named corrections (`references/screening.md`), reshoot, screen again.
  160. **At least one full screening happens before anything is called finished**, and the accessible cut is
  161. screened too (`--reduced`).
  162. ### 10. Delivery
  163. Report what was screened and what was not, the director, medium and mechanisms, whether the GRADE, ART and
  164. POSTER blocks were researched (sources and measured frames) or written from memory, every stand-in and every
  165. generated asset, any open asset call, and how to run it. Never describe a frame you did not look at.
  166. Append one line to the filmography: date, product, director / film, medium, form, skeleton, type, lead,
  167. interaction, ending, instruments / switch device (so the chrome rotates too, not only the film). It is the only file this skill keeps outside the project; mention the append.
  168. ## The director's rules
  169. 1. **Mechanism, not mood.** Every stylistic claim in the treatment names something visible on screen.
  170. 2. **The medium, the grade and the world are cast, not defaulted.** What the picture is made of, what colour its
  171. light is and what its world is built from all come from the film: researched, and measured from its frames. Nothing (3D, grain, glow, a camera drift, a tint) is on screen
  172. because the kit had it switched on. Once cast, the grade is committed in full: a timid grade is a different film.
  173. 3. **One lead, one arc.** The eye always knows what to follow, and it is not the same at the end.
  174. 4. **Changes and repetitions are both chosen.** A new shot size, a repeated frame, the same cut twice:
  175. each is a decision with a reason. Sameness nobody chose is a slideshow; variety nobody chose is noise.
  176. 5. **Motion is camera or performance.** Something moves because the camera moved or because an actor
  177. did something. A thing that fades up for no reason is neither; cut it.
  178. 6. **Hold.** A composed frame that stays still is a shot. Contrast makes energy; constant motion is noise.
  179. 7. **Close-ups are earned.** The shot is no closer than the asset can bear. Weak assets stay wide, in
  180. silhouette, or off screen.
  181. 8. **Ask for what you cannot make.** Real products, people and brands are requested, not invented.
  182. 9. **The audience has a part.** Beyond scrolling, the visitor does one thing that means something.
  183. 10. **The frame is designed at rest, on every screen.** Pause anywhere, at any window size: it should be a
  184. composition someone chose. A page composed for one viewport is not finished.
  185. 11. **Words stay words.** Copy, links and controls are real DOM text — readable, selectable, focusable,
  186. indexable — at every moment, on every device.
  187. 12. **Two cuts ship.** The theatrical cut, and the accessible cut (`prefers-reduced-motion`, small
  188. screens, no WebGL): every scene still composed, every word still there.
  189. 13. **Screened or it did not happen.** Claims about how it looks come from rendered frames.
  190. ## The lazy cut — refuse it
  191. These are what an undirected page looks like. If the shot list contains one, reshoot the scene.
  192. - Centred headline, subhead, two buttons, a glowing blob behind them
  193. - A row of three equal cards; a bento grid standing in for an idea
  194. - Everything fading up 24 px as it enters the viewport, forever
  195. - Photoreal 3D because the kit had a stage, on a film that was never solid or glossy
  196. - A 3D object that floats and spins in the hero and is never seen again
  197. - A close-up of code primitives pretending to be the product
  198. - A filter over generic geometry, called hand-drawn; a brush font, called ink
  199. - Purple-to-blue gradient, glassmorphism, and Inter, chosen by nobody
  200. - A strong first screen followed by ordinary feature / testimonial / FAQ blocks
  201. - A film reference that survives only as a palette and some adjectives
  202. - A cast film whose colour never reached the page: tidy hex tokens on white, pictures ungraded, "retro" as one sepia overlay, "neon" as a pink–cyan gradient behind white type
  203. - The two uncast grades: warm paper + vermilion + dark ink; cool grey + one blue or green accent
  204. - The film's grade on a template's world: rounded cards, pill buttons and a four-column footer under a Wong Kar-wai
  205. light. Or the opposite, its props pasted on as decoration: umbrellas, scorpions, holograms, a pink hotel
  206. - A floating-heads hero, or the film's poster reproduced: borrow the poster's grammar, never its artwork or lettering
  207. - A film "remembered" instead of researched: credits, palettes and set details written from memory and presented as fact
  208. - Scroll-jacking that traps the reader in a section with nothing developing
  209. - Mobile as the desktop page squeezed into a column
  210. - A spinner or a lone percentage as the loader; a loader that has nothing to do with the first shot
  211. - A centred mid-size headline (48–72 px) because nobody chose an extreme
  212. - An accent colour on every button and heading, meaning nothing; mono "[01]" labels on a product that is not about precision
  213. - A themed hero followed by stock UI: the world never reaches the buttons, the progress mark, the footer
  214. - Every section joined by a fade, or by the same clip-path wipe whatever the sections are
  215. - Every performance scrubbed by scroll: nothing plays by itself, nothing waits for a click, a hover or a hand
  216. - Type that only ever mask-rises: no type department, the kit's type library left on the shelf
  217. - A winner's signature move copied whole (ticket buttons, barcode dissolve): study the mechanism, find this product's own object
  218. ## The kit and the tools
  219. `kit/` is infrastructure; copy it into the project and build on it. Its lens and print effects all start
  220. at zero, and nothing in it is mandatory.
  221. | File | What it is |
  222. |---|---|
  223. | `kit/reel.js`, `reel.css` | The playhead. `[data-scene]` sections with pinned `.frame`s; each scene gets `enter` / `main` / `exit` clips on one master GSAP timeline scrubbed by scroll. Designed cuts via `data-cut`. Reduced-motion stills. Any frame reproducible from one number. No WebGL needed |
  224. | `kit/looks.js` | The lab: media other than photoreal. Whole-frame looks (ink wash, pencil sketch, pixel, halftone / riso, CRT), cel materials and outlines, liquid and gradient plates, illustrations, photographs and footage as layered 2.5D planes, hand-drawn line boil for DOM and SVG |
  225. | `kit/stage.js` | The sound stage, when the medium is 3D or needs a canvas. HDR Three.js pipeline, image-based studio lighting, a tweenable camera `rig` and colour `look`, optional bloom and depth of field, quality tiers, WebGL fallback |
  226. | `kit/props.js` | The prop shop for photoreal sets: seamless backdrop, procedural surface maps, lathed forms, PBR material starting points, dust |
  227. | `kit/type-fx.js` | The type department: forty-four text performances (impact, flow, 3D, switch, style, and four award moves taken from Awwwards winners) — burst, stamp, split-flap, odometer, tunnel, vertical parallax, liquid fill… Each frame a pure function of progress `p` and time `t`, so scroll scrubs it and a clock renders it frame-exact; real text stays in the DOM. `kit/type-fx.html` is the gallery. Cast one or two per production (`references/type-motion.md`) |
  228. | `kit/grade.js` | The colour grade for DOM sites: `createGrade({ look, spec })` with the same parameters as `stage.look` (white balance, contrast, saturation, split-tone, lift, fade) plus halation, bloom, grain, vignette, light leak and gate weave. It grades photographs, video and canvases through one SVG filter. Type and controls stay unfiltered. Frames are reproducible from one time value. `kit/grade.html` is the gallery |
  229. | `kit/plane.js` | The UI plane camera, for scenes whose cast is an interface: `uiPlane(el, { dof })` puts live DOM under CSS perspective with a plain-object pose, `SHOTS.{xmacro,macro,medium,wide}` presets, DOM depth of field and rack focus without WebGL, a `[film]` audit when consecutive shots share scale and diagonal, and UI performance recipes (`appear`, `stipple`, `uiCursor`) |
  230. | `kit/site-dom.html`, `kit/site.html` | Grey animatics: a site with no canvas, a site with the 3D stage |
  231. | `kit/app.js` | App mode's rig: hash router with filters, sort and selection in the URL, forced screening states (`?state=`), a frozen clock (`?now=`), keyboard shortcuts with sequences and a shortcut sheet, hints learned through the mouse, j/k row navigation with selection, a peek or modal drawer, a command palette, toasts with undo. No look |
  232. | `kit/fixtures.js` | Seeded stand-in data with real shape: long-tailed values, noisy series with events, mixed-locale names, working-hours timestamps, edge rows (long, empty, zero, negative, huge, unicode) |
  233. | `kit/app-shell.html` | Grey animatic of an app: shell, overview, list, record in a peek panel, every state |
  234. | `scripts/screening.mjs` | Dailies: per-scene stills, contact sheets, mechanical flags (errors, blank frames, dead holds, overflow, chrome over text, hidden focus, and with `--grade grade.json` or a page `grade.js` spec: grade drift, crushed or lifted blacks, clipped whites, saturation and warmth off the grade). Works on any URL, so it can also shoot reference sites |
  235. | `scripts/grade-from-stills.mjs` | Measures reference stills into a grade: palette with shares, black and white points, chroma range, shadow and highlight warmth, a suggested `look`, and a swatch contact sheet. The stills are reference only and never ship |
  236. | `scripts/app-screening.mjs` | Dailies for an app: every route × state × viewport × theme, contact sheets, and flags for proportional digits, left-aligned numbers, clipped text, layout shift between loading and loaded, low contrast, small targets, hidden focus and blank states |
  237. | `scripts/copy-check.mjs` | Checks that every line of client-supplied copy is in the page, with and without JavaScript |
  238. | `scripts/render-film.mjs` | Renders a tour of a site to MP4: motion blur, grain, parallel workers, a half-size `--preview`, a poster frame, and sound — one track or a sound sheet (music edited at bar lines, ducks, foley cues); `--stills` for dailies, captioned with luminance and near-black share |
  239. | `scripts/find-footage.mjs` | The archive researcher: searches open libraries (Openverse, Wikimedia Commons, public-domain films on the Internet Archive, NASA; Pixabay / Unsplash with a key) for photographs, footage and sound, lays candidates out with their licences, then trims, compresses and credits the ones you cast |
  240. | `scripts/generate-image.mjs` | One optional route for generated plates, illustrations and cut-outs (Runware; needs the user's key and their yes) |
  241. Read `kit/README.md` before using it: it lists the API and the handful of rules that keep frames
  242. deterministic. The kit is a rig, not a template — two sites built on it should share no visible trait.
  243. Scripts need Node and `playwright-core` in the project (`npm i -D playwright-core`); rendering needs `ffmpeg`.
  244. Other stacks are fine. In React / Next / Astro keep the model — scenes with pinned frames, one scrubbed
  245. timeline, real DOM copy, any frame reproducible — and port the kit's ideas rather than its files.
  246. ## References — read when the stage calls for it
  247. | Read | When |
  248. |---|---|
  249. | `references/app-mode.md` | Apps: the shift, casting by the work, the coverage plan and signature set, the lighting plan, density, the accent and status systems, motion by frequency, the eight states, data casting, keyboard, the phone, the app lazy cut |
  250. | `references/award-reel.md` | What twenty-one Awwwards and fifteen CSS Design Awards winners share and where they differ; the award pass (incl. UX proof); the lazy imitation of award sites |
  251. | `references/directors.md` | Casting the director; extracting mechanisms; avoiding the obvious pick |
  252. | `references/film-grammar.md` | Translating any film technique — shot, lens, move, light, cut, colour, time — into web mechanics |
  253. | `references/looks.md` | Choosing the medium from the film; the asset call; how each medium is built |
  254. | `references/film-research.md` | Researching any film live: from a description to candidate films, the research rounds, source tiers and tags, known blocked sites, looking at frames and posters, the GRADE / ART / POSTER outputs |
  255. | `references/art-direction.md` | The film's world and its poster: the ART block and UI map, the dials, poster grammars (Bass, Polish, chirashi, Swiss, painted stack, Criterion, Mondo) for the first frame, OG image, title cards and credits, and fourteen worked examples |
  256. | `references/grades.md` | Casting the grade: measuring reference stills, the GRADE block, the dials, refused defaults, and fourteen sourced looks in two families: retro / nostalgic (Wong Kar-wai, Demy, Willis, Hou, Malick, Anderson, Mid90s) and modern-future / neon (Blade Runner, 2049, Drive, Neon Demon, Collateral, Enter the Void, Tron: Legacy) |
  257. | `references/storyboard.md` | Logline, form and structure, shot list, the sequence as a whole; a worked example |
  258. | `references/production-design.md` | The frame's grammar: composition, typography (Latin and CJK), colour script, material |
  259. | `references/vfx-threejs.md` | When the medium is photoreal 3D: light, materials, modelling, shaders, lens, performance |
  260. | `references/editing-and-motion.md` | Scroll as a timeline, the cut catalogue, the audience's part, type choreography, easing, performance |
  261. | `references/type-motion.md` | Casting a type performance from the forty-four in `kit/type-fx.js`; driving it by scroll or by clock |
  262. | `references/screening.md` | Reviewing dailies; the director's notes; accessibility, mobile, SEO and performance checks; the delivery report |
  263. ## Working with the user
  264. Default is to direct: make the decisions, build, screen, and show the result with the treatment. Stop
  265. to ask in exactly three cases: the product or scope cannot be inferred; **the asset call** (one message,
  266. with your recommendation — it is the user's material and the user's money); and anything that would
  267. publish, deploy or overwrite outside the project. If the user asks for options, or the direction is truly
  268. open, **pitch**: three treatments, each a different director, medium and logline, one paragraph and one
  269. signature shot apiece — then build the chosen one. If the user names a director, film or medium, use it;
  270. if the choice would hurt the product, say so once and offer the mechanism you would keep.
  271. Respect the stack and content the user already has.
README.md · README · 234 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Cinematic UI 2.0 — Director's Cut
  2. **An agent skill that directs websites and apps the way films are made.**
  3. AI-built sites tend to look alike because nobody chose anything. Cinematic UI makes your agent cast a director,
  4. decide what the picture is made of, write a shot list for every section, shoot it, and check the rendered frames
  5. before handing it over.
  6. **[Website](https://cinematicskill.com/)** · **[Live demos](https://cinematicskill.com/gallery/)** · **[Docs](https://cinematicskill.com/docs/)** · English · [繁體中文](README.zh-TW.md)
  7. ```bash
  8. git clone https://github.com/akseolabs-seo/cinematic-ui ~/.claude/skills/cinematic-ui
  9. ```
  10. Then tell your agent: `/cinematic-ui a homepage for a pour-over coffee subscription`
  11. ## Launch film
  12. [![Watch the Cinematic UI 2.0 launch film](docs/launch-film-en.jpg)](https://github.com/akseolabs-seo/cinematic-ui/releases/download/v2.8.0/cinematic-ui-2.0-launch.mp4)
  13. **[Watch the launch film](https://github.com/akseolabs-seo/cinematic-ui/releases/download/v2.8.0/cinematic-ui-2.0-launch.mp4)** · 1:30, MP4, with sound, on-screen text in Traditional Chinese
  14. ## Live demos
  15. Ten live sites at **[cinematicskill.com](https://cinematicskill.com/gallery/)**, each made by an agent with this
  16. skill. Every brand is fictional; the output is real. Click a frame to open the site. Each one also has its
  17. treatment: the director, medium, lead and grade it chose, and why. The site lists the English productions in the
  18. [gallery](https://cinematicskill.com/gallery/) and the Traditional Chinese ones in the
  19. [zh-TW gallery](https://cinematicskill.com/zh-tw/gallery/).
  20. <table>
  21. <tr>
  22. <td width="50%"><a href="https://cinematicskill.com/demos/lockwork/"><img src="docs/demos/lockwork.jpg" alt="Lockwork"></a><br><b>Lockwork</b>, AI ops agents<br>Robert Wise, <i>The Andromeda Strain</i><br>A live typeset monitor wall · <a href="https://cinematicskill.com/gallery/lockwork/">treatment</a></td>
  23. <td width="50%"><a href="https://cinematicskill.com/demos/purser/"><img src="docs/demos/purser.jpg" alt="Purser"></a><br><b>Purser</b>, business spend cards<br>Billy Wilder, <i>The Apartment</i><br>Monochrome CSS 3D office · <a href="https://cinematicskill.com/gallery/purser/">treatment</a></td>
  24. </tr>
  25. <tr>
  26. <td><a href="https://cinematicskill.com/demos/lull/"><img src="docs/demos/lull.jpg" alt="Lull"></a><br><b>Lull</b>, incident response<br>Edgar Wright, <i>Baby Driver</i><br>The product UI as the world · <a href="https://cinematicskill.com/gallery/lull/">treatment</a></td>
  27. <td><a href="https://cinematicskill.com/demos/odd-lot/"><img src="docs/demos/odd-lot.jpg" alt="Odd Lot"></a><br><b>Odd Lot</b>, design studio portfolio<br>Jean-Luc Godard, <i>Pierrot le Fou</i><br>Flat primaries and set type · <a href="https://cinematicskill.com/gallery/odd-lot/">treatment</a></td>
  28. </tr>
  29. <tr>
  30. <td><a href="https://cinematicskill.com/demos/lattice-matrix/"><img src="docs/demos/lattice-matrix.jpg" alt="Lattice, Matrix cut"></a><br><b>Lattice (Matrix cut)</b>, LLM gateway<br>The Wachowskis, <i>The Matrix</i><br>Glyph streams of its own traffic · <a href="https://cinematicskill.com/gallery/lattice-matrix/">treatment</a></td>
  31. <td><a href="https://cinematicskill.com/demos/lattice-kiki/"><img src="docs/demos/lattice-kiki.jpg" alt="Lattice, Miyazaki cut"></a><br><b>Lattice (Miyazaki cut)</b>, the same product<br>Hayao Miyazaki, <i>Kiki's Delivery Service</i><br>Gouache-style painted plates · <a href="https://cinematicskill.com/gallery/lattice-kiki/">treatment</a></td>
  32. </tr>
  33. <tr>
  34. <td><a href="https://cinematicskill.com/demos/latent-film-lab/"><img src="docs/demos/latent-film-lab.jpg" alt="Latent Film Lab"></a><br><b>Latent Film Lab</b>, film lab (zh-TW)<br>Michelangelo Antonioni, <i>Blow-Up</i><br>Archival photographs in a darkroom · <a href="https://cinematicskill.com/zh-tw/gallery/latent-film-lab/">treatment</a></td>
  35. <td><a href="https://cinematicskill.com/demos/beichen-er/"><img src="docs/demos/beichen-er.jpg" alt="Beichen Animal ER"></a><br><b>Beichen Animal ER</b>, 24-hour animal hospital (zh-TW)<br>David Fincher, <i>Zodiac</i><br>One continuous drawn line · <a href="https://cinematicskill.com/zh-tw/gallery/beichen-er/">treatment</a></td>
  36. </tr>
  37. <tr>
  38. <td><a href="https://cinematicskill.com/demos/tieout/"><img src="docs/demos/tieout.jpg" alt="Tieout"></a><br><b>Tieout</b>, accounting SaaS (zh-TW)<br>Hideaki Anno, <i>Shin Godzilla</i><br>Typeset accounting documents · <a href="https://cinematicskill.com/zh-tw/gallery/tieout/">treatment</a></td>
  39. <td><a href="https://cinematicskill.com/demos/retour/"><img src="docs/demos/retour.jpg" alt="Retour"></a><br><b>Retour</b>, fragrance launch (zh-TW)<br>Céline Sciamma, <i>Portrait of a Lady on Fire</i><br>Real-time 3D glass by one candle · <a href="https://cinematicskill.com/zh-tw/gallery/retour/">treatment</a></td>
  40. </tr>
  41. </table>
  42. ## The idea
  43. A site is a film whose playhead is the scrollbar. A section is a scene, the viewport is the frame, a scroll is a
  44. cut or a camera move, and the visitor is the audience, the editor and, once, a participant.
  45. One rule carries the whole skill: **borrow the film's mechanics, never its costume.** A director's style is a set
  46. of decisions: where the camera stands, how long a shot holds, what the light hides, how a cut lands, what the
  47. picture is made of. Those become structure, motion, medium and material. Film titles, characters and props stay
  48. out of the product's UI.
  49. ## What it does differently
  50. | Most "make it premium" prompts | Cinematic UI |
  51. |---|---|
  52. | Pick a style, apply it to a layout | Pick a director by the product's *dramatic problem*, extract 5–7 observable mechanisms |
  53. | Default to one look (usually glossy 3D or glass) | Cast the **medium** from the film: ink, pencil, cel, pixel, print, neon, type, photography, or 3D |
  54. | Design a hero, then fill sections | A **shot list** for every scene: beat, shot size, lens, move, blocking, light, cut, length |
  55. | Invent placeholder imagery | **The asset call**: ask once. You supply it, a free licensed library, it generates, or the shot changes |
  56. | Animate things as they enter the viewport | One scrubbed timeline; every cut between scenes is a decision |
  57. | "Looks good" | **Screening**: contact sheets on three viewports, five frames judged at full size, named corrections |
  58. | Every site ends up related | A filmography and a skeleton check, so the next production differs from the last three |
  59. ## The production
  60. | # | Stage | What comes out |
  61. |---|---|---|
  62. | 1 | Development | Logline and audience arc |
  63. | 2 | Cast the director | Three candidates, one kept, mechanisms extracted |
  64. | 3 | Choose the medium | What the picture is made of, and why |
  65. | 4 | Casting and the asset call | The lead and its arc; one message asking for what the film needs |
  66. | 5 | Screenplay | Every visible word |
  67. | 6 | Storyboard | Form, skeleton, a shot list for every scene, the audience's part |
  68. | 7 | Animatic | The whole page, rough, in the chosen medium |
  69. | 8 | Principal photography | Cast, set, light, frame, cuts |
  70. | 9 | Screening | Contact sheets, the projection room, notes, reshoots |
  71. | 10 | Delivery | An honest report: what was screened, what is a stand-in, what is still needed |
  72. ## What's in 2.0
  73. **App mode.** Dashboards, back offices, admin panels and consoles get their own rules. The playhead is the task,
  74. and cinema gets about a tenth of the frame: a signature view only this product could have, in place of the usual
  75. KPI row. Every route is screened in eight states with `app-screening.mjs`, across viewports and themes.
  76. **Any film, researched live.** There is no fixed film list. Name a film, or describe a look ("90s Hong Kong late
  77. night, lonely, humid"), and `references/film-research.md` works from sourced interviews and reference frames, with
  78. every claim tagged by source quality.
  79. **The grade.** A film's colour reaches the page. `references/grades.md` has fourteen sourced looks,
  80. `grade-from-stills.mjs` measures reference stills into a grade, `kit/grade.js` applies it to DOM sites, and
  81. `screening.mjs --grade` flags frames that drift off it.
  82. **The film's world.** `references/art-direction.md` turns production design into cards, buttons, dividers, forms
  83. and footer. The poster's composition grammar shapes the first frame, the OG image and the title cards.
  84. **The media.** Photoreal 3D is one option, not the default. Each of these ships as tested code in `kit/looks.js`:
  85. ![The same scene in different media](docs/looks.jpg)
  86. Ink wash · pencil and watercolour · pixel · halftone and CMY print · CRT and neon · cel shading with outlines ·
  87. liquid · gradient light · illustrations and photographs as layered 2.5D planes · hand-drawn line boil for DOM and
  88. SVG, plus a studio-lit HDR 3D stage for films that really are solid and glossy, and a no-canvas path for films
  89. made of type.
  90. **Type performances.** `kit/type-fx.js` holds forty-four text performances. Scroll can scrub them, a clock can
  91. render them frame-exact, and the real text stays in the DOM.
  92. **Real footage, legally.** `find-footage.mjs` searches open libraries (Openverse, Wikimedia Commons, Internet
  93. Archive, NASA, and Pixabay or Unsplash with a free key) with the shot as the query, and returns trimmed clips with
  94. poster frames and a `CREDITS.md`.
  95. ## Install
  96. **Any agent, one line** (Claude Code, Codex, Cursor, Gemini CLI and more, via [skills.sh](https://skills.sh/akseolabs-seo/cinematic-ui))
  97. ```bash
  98. npx skills add akseolabs-seo/cinematic-ui
  99. ```
  100. **Claude Code**
  101. ```bash
  102. git clone https://github.com/akseolabs-seo/cinematic-ui ~/.claude/skills/cinematic-ui
  103. ```
  104. **Codex CLI**
  105. ```bash
  106. git clone https://github.com/akseolabs-seo/cinematic-ui ~/.codex/skills/cinematic-ui
  107. ```
  108. **Any other agent:** point it at `SKILL.md`. Everything is plain Markdown, plain JavaScript and Node scripts, so
  109. there is nothing to build.
  110. The screening and render scripts need this in the project you are building:
  111. ```bash
  112. npm i -D playwright-core # uses your installed Chrome or Edge
  113. ```
  114. ffmpeg is needed only to render video.
  115. ## Use
  116. ```
  117. /cinematic-ui a homepage for a pour-over coffee subscription, Awwwards level
  118. /cinematic-ui shoot this SaaS landing page the way Ozu would
  119. /cinematic-ui pitch me three directions for this brand
  120. /cinematic-ui direct an order back office for a logistics team
  121. ```
  122. It directs by default: it makes the decisions, builds, screens, and shows you the result with its treatment. It
  123. stops to ask in three cases only: it cannot tell what the product is, it needs assets (yours, or your permission
  124. to generate them), or something would be published.
  125. To record a finished site as a video:
  126. ```bash
  127. node scripts/render-film.mjs ./site --tour 30 --out tour.mp4
  128. ```
  129. ## What's in the box
  130. ```
  131. SKILL.md the director's method
  132. references/
  133. directors.md casting: ~40 directors as mechanisms, and the obvious pick to avoid
  134. film-grammar.md shot, lens, move, light, cut, colour, time → web mechanics
  135. film-research.md any film, researched live; from a description to candidate films
  136. looks.md choosing the medium; the asset call; how each medium is built
  137. grades.md casting the grade; 14 worked retro and neon looks
  138. art-direction.md the film's world (UI map) and its poster grammar
  139. storyboard.md logline, form, skeleton, the shot list, a worked example
  140. production-design.md composition, type (Latin + CJK), colour, material
  141. award-reel.md what Awwwards and CSS Design Awards winners share; the award pass
  142. type-motion.md casting a type performance
  143. vfx-threejs.md photoreal 3D: light, materials, modelling, shaders, performance
  144. editing-and-motion.md scroll as a timeline, the cut catalogue, the audience's part
  145. screening.md dailies, the projection room, accessibility / SEO / performance checks
  146. app-mode.md dashboards, back offices and consoles
  147. kit/ infrastructure with no look of its own; every effect starts at zero
  148. reel.js reel.css the playhead: scenes, pinned frames, clips, designed cuts
  149. looks.js the non-photoreal media
  150. grade.js grade.html the colour grade for DOM sites, and its gallery
  151. type-fx.js type-fx.html forty-four type performances, and their gallery
  152. plane.js a camera that shoots a live interface like a set
  153. stage.js props.js the 3D sound stage and prop shop
  154. app.js fixtures.js app mode: router, states, shortcuts, seeded data
  155. site-dom.html site.html app-shell.html grey animatics to start from
  156. scripts/
  157. screening.mjs contact sheets + mechanical flags, on any URL (--grade: colour drift)
  158. app-screening.mjs routes × states × viewports × themes, with flags
  159. grade-from-stills.mjs reference stills → palette, black / white points, warmth, a suggested look
  160. find-footage.mjs photographs, footage and sound from open libraries
  161. copy-check.mjs is every line of supplied copy on the page, with and without JS?
  162. render-film.mjs site tour → MP4
  163. generate-image.mjs optional image generation (Runware), used only with your say-so
  164. ```
  165. ## How it was tested
  166. Fresh agents with no other context were given this skill and a client brief. Their friction logs, an independent
  167. review by a second model and a survey of other skills were folded back into the text and the kit. App mode went
  168. through three rounds of blind tests on the same three briefs. The kit and scripts are verified in headless Chrome
  169. with three 0.186, GSAP 3.15 and Lenis 1.3: scene and cut logic, frame-exact seeking in any order, reduced motion,
  170. keyboard order, every look, frame-by-frame video rendering.
  171. ## Honest limits
  172. - Not verified on Safari, Firefox, real phones or screen readers. Smoothness cannot be judged headlessly.
  173. - Procedural 3D struggles in close-up on familiar real objects. The skill asks for assets and keeps weak ones in
  174. wide shot; it cannot conjure a product photograph.
  175. - Gaussian splats are described, not built.
  176. - It raises the floor and widens the range. It does not guarantee an award.
  177. ## Credits
  178. Built on [GSAP](https://gsap.com), [Three.js](https://threejs.org) and [Lenis](https://lenis.darkroom.engineering).
  179. ## License
  180. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.