Skip to content
Back to search

cinematic-skill

MarketplaceWorks with Claude CodeGitHub

An agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, documents, cards and maps, every stamp, highlight and number landing on the narrator's word. Documentaries, product launches, brand stories, explainers.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/moh4696--cinematic-skill/badge.svg)](/listings/moh4696--cinematic-skill)

HTML

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

Install

Install instructions from the README

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

These steps run a script from the network that findsafeskills does not scan.

npx skills add Moh4696/cinematic-skill

That uses the [`npx skills`](https://github.com/vercel-labs/skills) CLI (Node 22.20+). It installs for Claude Code, Codex, Cursor, Gemini CLI, OpenCode and dozens more. Start a new agent session afterwards.

<details> <summary>Claude Code plugin</summary>

/plugin marketplace add Moh4696/cinematic-skill
/plugin install cinematic-skill@cinematic-skill

</details>

<details> <summary>Codex plugin</summary>

codex plugin marketplace add Moh4696/cinematic-skill
codex plugin add cinematic-skill@cinematic-skill

</details>

<details> <summary>Gemini CLI</summary>

gemini extensions install https://github.com/Moh4696/cinematic-skill

</details>

<details> <summary>Without Node: the shell installer</summary>

curl -fsSL https://raw.githubusercontent.com/Moh4696/cinematic-skill/main/install.sh | bash

It clones to `~/.cinematic-skill` and links the skill into every coding agent it finds. Run it again to update. From a clone: `./install.sh --claude --codex`, `./install.sh --dir path/to/skills`, `./install.sh --copy`, `./install.sh --uninstall`.

</details>

Then install what the scripts use:

pip install -r requirements.txt      # skia-python, numpy, pillow (scipy optional)

ffmpeg must be on your PATH. The skill's `check_setup.py` checks everything and says what's missing.

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.

.claude-plugin/marketplace.json · Manifest · 33 lines
  1. {
  2. "name": "cinematic-skill",
  3. "description": "An agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, documents, cards and maps, every stamp, highlight and number landing on the narrator's word. Documentaries, product launches, brand stories, explainers.",
  4. "owner": {
  5. "name": "exploraX",
  6. "url": "https://x.com/exploraX_"
  7. },
  8. "plugins": [
  9. {
  10. "name": "cinematic-skill",
  11. "description": "An agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, documents, cards and maps, every stamp, highlight and number landing on the narrator's word. Documentaries, product launches, brand stories, explainers.",
  12. "version": "1.0.1",
  13. "source": "./",
  14. "author": {
  15. "name": "exploraX",
  16. "url": "https://x.com/exploraX_"
  17. },
  18. "homepage": "https://github.com/Moh4696/cinematic-skill",
  19. "repository": "https://github.com/Moh4696/cinematic-skill",
  20. "license": "MIT",
  21. "keywords": [
  22. "skills",
  23. "video",
  24. "film",
  25. "documentary",
  26. "explainer",
  27. "animation",
  28. "motion-graphics",
  29. "skia"
  30. ]
  31. }
  32. ]
  33. }
README.md · README · 145 lines · 1 finding marked
  1. <h1 align="center">Cinematic Skill</h1>
  2. <p align="center">Narrated cinematic films, built entirely from code, by your coding agent.</p>
  3. <p align="center">
  4. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-24292f?style=flat" alt="MIT License" /></a>
  5. &nbsp;
  6. <img src="https://img.shields.io/badge/agents-Claude%20Code%20%C2%B7%20Codex%20%C2%B7%20Cursor%20%C2%B7%20Gemini%20%C2%B7%20OpenCode-24292f?style=flat" alt="Works with Claude Code, Codex, Cursor, Gemini CLI and OpenCode" />
  7. &nbsp;
  8. <a href="https://github.com/Moh4696/cinematic-skill/actions/workflows/check.yml"><img src="https://github.com/Moh4696/cinematic-skill/actions/workflows/check.yml/badge.svg" alt="Checks" /></a>
  9. </p>
  10. <p align="center">
  11. <img src="examples/film-cold-open.webp" alt="The cold open of a code-built documentary about the first flight: the date set big on a yellow block, the camera pulls back to a map pin on the Outer Banks, then glides to the 1903 first-flight photograph pinned to a cork wall as counters roll up to 12 seconds and 120 feet." width="100%" />
  12. </p>
  13. Ask your agent for "a 90 second documentary about the Wright brothers" and it writes the script, records a voice, finds public-domain photos with their licences, and builds one continuous camera move over a single designed world. Stamps slam, highlighters swipe and numbers roll up on the exact word the narrator says. It finishes with sound effects, an optional score and burned-in captions.
  14. Nothing is generated video. Every frame is drawn by code (Skia, in Python), so the film renders the same every time, changes are cheap, and a new voice re-times the whole film by itself.
  15. <table>
  16. <tr>
  17. <td width="50%"><img src="examples/film-wall.webp" alt="The final pull-back of the documentary: a US map print with Ohio and North Carolina filled, a route from Dayton to Kill Devil Hills, portraits, a typeset letter, Langley's failed machine with two stamps, and the first-flight photo with its counters, all on one cork wall" /></td>
  18. <td width="50%"><img src="examples/film-explainer.webp" alt="The starter explainer in the light studio look: the title From Cherry to Cup over four cards, Grow, Pick, Roast and Brew, joined by arrows, with a 200 degree counter" /></td>
  19. </tr>
  20. </table>
  21. <sub>Left: the final frame of "Twelve Seconds", the 90 second documentary that ships as the worked example, made from seven public-domain photos. Right: the starter explainer that every new project begins as.</sub>
  22. ## Install
  23. ```bash
  24. npx skills add Moh4696/cinematic-skill
  25. ```
  26. That uses the [`npx skills`](https://github.com/vercel-labs/skills) CLI (Node 22.20+). It installs for Claude Code, Codex, Cursor, Gemini CLI, OpenCode and dozens more. Start a new agent session afterwards.
  27. <details>
  28. <summary>Claude Code plugin</summary>
  29. ```
  30. /plugin marketplace add Moh4696/cinematic-skill
  31. /plugin install cinematic-skill@cinematic-skill
  32. ```
  33. </details>
  34. <details>
  35. <summary>Codex plugin</summary>
  36. ```bash
  37. codex plugin marketplace add Moh4696/cinematic-skill
  38. codex plugin add cinematic-skill@cinematic-skill
  39. ```
  40. </details>
  41. <details>
  42. <summary>Gemini CLI</summary>
  43. ```bash
  44. gemini extensions install https://github.com/Moh4696/cinematic-skill
  45. ```
  46. </details>
  47. <details>
  48. <summary>Without Node: the shell installer</summary>
  49. ```bash
  50. curl -fsSL https://raw.githubusercontent.com/Moh4696/cinematic-skill/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 71 on GitHub
  51. ```
  52. It clones to `~/.cinematic-skill` and links the skill into every coding agent it finds. Run it again to update. From a clone: `./install.sh --claude --codex`, `./install.sh --dir path/to/skills`, `./install.sh --copy`, `./install.sh --uninstall`.
  53. </details>
  54. Then install what the scripts use:
  55. ```bash
  56. pip install -r requirements.txt # skia-python, numpy, pillow (scipy optional)
  57. ```
  58. ffmpeg must be on your PATH. The skill's `check_setup.py` checks everything and says what's missing.
  59. ## What it makes
  60. | Kind | Look | Images |
  61. | --- | --- | --- |
  62. | Documentary, history, true crime | Cork evidence wall, slate | Archive photos and documents, black and white |
  63. | Product launch, brand or founder story | Studio, charcoal | Your own product shots and photos, in colour |
  64. | Science, engineering, how it works | Blueprint, paper | Diagrams, archive or AI stills |
  65. | Tech, space, trailers | Night | Screenshots, renders, AI stills |
  66. The items work on every look:
  67. - photos and torn newspaper clippings
  68. - typeset documents with real quotes
  69. - clean cards
  70. - big distressed type and rolling counters
  71. - stamps, pen circles and highlighter swipes
  72. - red string between prints
  73. - maps of any country, with filled regions, routes and markers
  74. A spotlight follows the camera so each line has one hero.
  75. ## How it works
  76. 1. **Story.** The agent researches, fact-checks and writes the script: one idea per line, and time only moves forward after the opening. Each line also says what the camera shows. A beat table with a chronology lint goes to you for approval.
  77. 2. **Voice.** A free scratch voice (macOS `say` or espeak-ng) times the film first. The final voice can be any TTS or a person, recorded one section at a time and split into timed lines automatically. Suspect cuts get flagged.
  78. 3. **Images.** Wikimedia Commons search and download, with each licence recorded. Non-free files are refused. You can also add your own photos or AI stills. `credits.md` is written for you.
  79. 4. **Scene.** A short Python file places items on the voice's timing (`doc.W(line, "word")`) and keys the camera.
  80. 5. **Review.** The agent renders stills and contact strips of every move and checks them for known mistakes before showing you a draft.
  81. 6. **Sound and finish.** It synthesises the sound effects (nothing to license) and mixes them with the voice and an optional score, ducked and loudness-normalised. A memory-aware parallel render follows, then four caption styles and an SRT.
  82. The agent stops for your approval after the beat table, the look, and a 30 second draft.
  83. ## Try the example
  84. ```bash
  85. cd skills/cinematic-film/scripts
  86. python3 new_project.py ~/wright --example
  87. python3 fetch_commons.py get --project ~/wright
  88. python3 make_map.py --project ~/wright && python3 prep_assets.py --project ~/wright
  89. python3 tts_say.py --project ~/wright && python3 split_takes.py --project ~/wright && python3 build_narration.py --project ~/wright
  90. python3 render.py --project ~/wright --size 1280x720 --out out/draft.mp4 --audio audio/narration.m4a
  91. ```
  92. On a 16 GB laptop the 92 second film renders at 1080p in about 6 minutes.
  93. ## Credits
  94. Built from a 5 minute documentary about Al Capone that exploraX made with an agent, then opened up to any subject. The rules and code here were written from what broke along the way. The example film uses public-domain photographs from Wikimedia Commons; see its `photos.json`.
  95. ## Works well with
  96. - [Open 3D Skills](https://github.com/Moh4696/open-3d-skills): three.js scenes, scroll films and frame-exact recording, from the same author. Its `motion-assets` skill plans AI stills.
  97. ## Feedback
  98. Open an issue or a pull request, or find me on X at [@exploraX_](https://x.com/exploraX_).
  99. ## License
  100. [MIT License](LICENSE) · Copyright (c) 2026 exploraX

Ratings and comments

Sign in to rate this skill.

Sign in

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