Skip to content
Back to search

coded-video

MarketplaceWorks with Claude CodeGitHub

Coded, not generated: short explainer and demo videos written as HTML/CSS/SVG/JS or real lit 3D, rendered to MP4. Agent Skill and Claude Code plugin.

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/necromancer124--coded-video/badge.svg)](/listings/necromancer124--coded-video)

HTML

<a href="/listings/necromancer124--coded-video"><img src="/api/listings/necromancer124--coded-video/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.

In Claude Code, run:

/plugin install coded-video --marketplace necromancer124/coded-video

On Claude Code older than 2.1.275, use two steps instead:

/plugin marketplace add necromancer124/coded-video
/plugin install coded-video@coded-video

Then start a new session. The skill loads as `coded-video:coded-video`, and Claude picks it up on its own when you ask for an explainer, a demo video or an animation.

**Other assistants:** copy `skills/coded-video/` into your client's skills folder (for example `.claude/skills/` or `.agents/skills/`), or point the assistant at `skills/coded-video/SKILL.md`. It needs file and shell tools to build and render.

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 · 19 lines
  1. {
  2. "name": "coded-video",
  3. "owner": {
  4. "name": "necromancer124"
  5. },
  6. "metadata": {
  7. "description": "coded-video: short explainer and demo videos made with code"
  8. },
  9. "plugins": [
  10. {
  11. "name": "coded-video",
  12. "source": "./",
  13. "description": "Coded, not generated: short explainer and demo videos written as HTML/CSS/SVG/JS or real lit 3D (Three.js) and rendered frame by frame to MP4. Writes a scene-by-scene brief first, builds only after your go.",
  14. "version": "1.0.0",
  15. "license": "MIT",
  16. "category": "design"
  17. }
  18. ]
  19. }
README.md · README · 99 lines
  1. # coded-video
  2. **Coded, not generated.** Short explainer and demo videos that your AI assistant writes as code and renders to MP4.
  3. coded-video is an [Agent Skill](https://agentskills.io/specification) and Claude Code plugin. Your assistant first writes a scene-by-scene brief. Once you say go, it builds the animation as HTML, CSS, SVG and JavaScript (or real, lit 3D with the bundled Three.js), then renders it frame by frame into an MP4.
  4. <!-- SHOWCASE -->
  5. ### Showcase
  6. **A 15-second 3D product tutorial**, made by a fresh Claude Opus session from one phone photo of a supermarket shelf: brief first, then lit 3D (three.js), camera moves, pinned fact cards and step captions. The brand is made up for this demo.
  7. ![3D tutorial: a noodle cup is opened, filled from a kettle, closed, timed and stirred](docs/noodle-tutorial-3d.gif)
  8. **Engineering diagrams in motion**: a few seconds from a longer coded explainer, showing what the skill can draw: isometric 3D parts that assemble themselves, labelled callouts, camera cones sweeping a scene, laser beams and live readouts that update every frame.
  9. ![Coded explainer clips: parts assemble with labels, camera cones sweep, lasers align while readouts update](docs/align-highlights.gif)
  10. **The two starters** that ship with the skill, rendered as they are:
  11. | 3D starter (`template-3d.html`) | 2D starter (`template.html`) |
  12. | --- | --- |
  13. | ![3D starter: a lit product on a turntable with a pinned callout](docs/starter-3d.gif) | ![2D starter: title, bar chart and counter](docs/starter-2d.gif) |
  14. No image or video model is involved. Every shape, number and word on screen is exactly what's in the source file, so you can read it, fix a typo and render again.
  15. ## What it's for
  16. - Product and feature demos
  17. - Technical explainers and process walkthroughs
  18. - Animated diagrams and data stories
  19. - Title cards, logo reveals, intros and outros
  20. - Short 2D, isometric and 3D animations for decks, READMEs and social posts
  21. - 3D product shots: packaging, devices and mechanisms, with real lighting and soft shadows
  22. ## What it's not for
  23. Realistic people, faces, places or camera-style footage. For that you need a generative video tool. coded-video makes clean motion graphics: precise, editable and repeatable, but drawn, not filmed.
  24. ## Install as a Claude Code plugin
  25. In Claude Code, run:
  26. ```
  27. /plugin install coded-video --marketplace necromancer124/coded-video
  28. ```
  29. On Claude Code older than 2.1.275, use two steps instead:
  30. ```
  31. /plugin marketplace add necromancer124/coded-video
  32. /plugin install coded-video@coded-video
  33. ```
  34. Then start a new session. The skill loads as `coded-video:coded-video`, and Claude picks it up on its own when you ask for an explainer, a demo video or an animation.
  35. **Other assistants:** copy `skills/coded-video/` into your client's skills folder (for example `.claude/skills/` or `.agents/skills/`), or point the assistant at `skills/coded-video/SKILL.md`. It needs file and shell tools to build and render.
  36. ## Requirements for rendering
  37. - Python 3.10+
  38. - Playwright with a browser:
  39. ```sh
  40. python -m pip install playwright
  41. python -m playwright install chromium
  42. ```
  43. Or use an installed Chrome or Edge with `--browser chrome` or `--browser msedge`.
  44. - ffmpeg on PATH: `winget install Gyan.FFmpeg`, `brew install ffmpeg` or `sudo apt install ffmpeg`.
  45. Nothing is installed automatically.
  46. ## How it works
  47. 1. **Brief.** You describe the video. The assistant writes `brief.md`: goal, length, style, and a numbered scene list with exact times, on-screen text and motion. Then it **stops and waits for your go**.
  48. 2. **Build.** After your go, it writes one HTML page that defines `window.VIDEO` (size, fps, length) and `window.renderAt(t)`, a function that draws the frame at time `t`. Open the page in a browser to preview and scrub it.
  49. 3. **Render.** `render.py` draws every frame at its exact time, captures it with a headless browser and pipes it to ffmpeg.
  50. 4. **Check.** It grabs stills from each scene and inspects them before calling the video done.
  51. Try the included 5-second starters, one 2D and one 3D:
  52. ```sh
  53. python skills/coded-video/scripts/render.py skills/coded-video/assets/template.html --output output/starter.mp4
  54. python skills/coded-video/scripts/render.py skills/coded-video/assets/template-3d.html --output output/starter-3d.mp4 --sheet output/starter-3d-sheet.png
  55. ```
  56. Useful flags: `--sheet sheet.png` for a one-frame-per-second contact sheet, `--stills 1.5,4.9` for single frames, `--scale 0.5` for a half-size draft, `--start`/`--end` to render one section, `--fps` to override the page, `--audio track.mp3` to add a soundtrack, `--gl swiftshader` for software-only 3D that looks the same on any machine (the default uses the GPU and is 3–4× faster). The script prints the frame count, duration and size measured from the finished file.
  57. The renderer serves the page's own folder on a private local address and blocks every other host unless you pass `--allow-network`, so bundle fonts, images and models locally. **Render trusted HTML only:** blocking the network is not a sandbox.
  58. ## Is it "AI-generated"?
  59. It's made by an AI assistant writing code. It's not synthetic footage: no model invents pixels, and the renderer adds no watermark. If you publish it, check the disclosure rules of the platform you post on. They differ by platform and change over time.
  60. ## Check the package
  61. ```sh
  62. python -m pip install -r requirements-dev.txt
  63. python -m playwright install chromium
  64. python -m unittest discover -s tests -v
  65. ```
  66. The tests check the skill metadata, the plugin manifests and a real render: frame count, size, duration, and that the same time always gives the same frame.
  67. ## License
  68. MIT. See [LICENSE](LICENSE). Bundled three.js 0.187.0 is MIT-licensed by the three.js authors; see `skills/coded-video/assets/vendor/three/LICENSE`.

Ratings and comments

Sign in to rate this skill.

Sign in

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