open-3d-skills README

The project's README from github.com/Moh4696/open-3d-skills. As one markdown file: README.md.

Open 3D Skills, for coding agents. three.js worlds, scroll films, transparent video, cursor rigs, exploded views. One command.

MIT License   8 skills   Works with Claude Code, Codex, Cursor, Gemini CLI and OpenCode   Checks

Open 3D Skills are eight agent skills for building 3D and animated websites: real-time three.js scenes built from code, scroll-scrubbed films, transparent video that plays in Safari, characters that follow the cursor, exploded views of machines, and the AI image and video work behind them. They also teach the agent to check its work in real browsers and to record it as a smooth 60 fps video.

Every technique here was used to build a real site first, and every script was run on real footage before it went in.

A code-built electric motor taking itself apart: the housing lifts, the end shields, fan and rotor slide out along the shaft, the casing turns to x-ray, then it all goes back together. Recorded frame by frame with frame-capture.

A round classical pavilion on a lawn at golden hour, with long shadows and trees The same pavilion at night under stars, lit from within by a lantern, with lamp posts glowing along the path
The motor fully exploded, each part labelled at the side of the screen with leader lines The motor assembled with its casing cut away, showing copper windings and the rotor inside

The pavilion is the starter scene in threejs-scene; the motor is the demo in exploded-view. Both are built entirely from code: no model files, no textures to download.

Install

npx skills add Moh4696/open-3d-skills

That installs with the npx skills CLI, the open installer for agent skills. It asks which of the eight skills you want, which agents to install them for (Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Antigravity and dozens more) and whether they are for this project or every project. Start a new agent session afterwards.

npx skills add Moh4696/open-3d-skills -g -y                       # all skills, all your agents, every project, no questions
npx skills add Moh4696/open-3d-skills --skill threejs-scene       # just one skill
npx skills update                                                  # pull new versions later

npx skills needs Node 22.20 or newer.

Claude Code plugin

Inside Claude Code:

/plugin marketplace add Moh4696/open-3d-skills
/plugin install open-3d-skills@open-3d-skills

The skills are namespaced as open-3d-skills:threejs-scene and so on, so they never collide with other skills. /plugin update upgrades them.

Codex plugin
codex plugin marketplace add Moh4696/open-3d-skills
codex plugin add open-3d-skills@open-3d-skills

Start a new Codex session afterwards.

Cursor

The one-line installer links the skills into ~/.cursor/skills, where Cursor finds personal skills. To use the repo as a Cursor plugin instead, clone it into ~/.cursor/plugins/local/open-3d-skills and run Developer: Reload Window. Teams can import the repo URL as a marketplace under Dashboard → Plugins & MCPs → Add Marketplace.

Gemini CLI
gemini extensions install https://github.com/Moh4696/open-3d-skills

gemini extensions update pulls new versions.

Without Node: the shell installer
curl -fsSL https://raw.githubusercontent.com/Moh4696/open-3d-skills/main/install.sh | bash

It installs all eight skills for every coding agent it finds (Claude Code, Codex, Cursor, Gemini CLI, and OpenCode, which also reads Claude Code's folder). It clones the repo to ~/.open-3d-skills and links the skills from there, so running it again updates them. From a clone you can choose:

git clone https://github.com/Moh4696/open-3d-skills && cd open-3d-skills
./install.sh --claude --codex          # only these agents (also --cursor --gemini --opencode --agents)
./install.sh --dir path/to/skills      # any agent that reads a skills folder
./install.sh threejs-scene frame-capture   # only some skills
./install.sh --copy                    # copy instead of symlink (Windows, synced folders)
./install.sh --uninstall               # remove what it installed

Each skill is a plain folder with a SKILL.md, so any agent that supports Agent Skills can load it.

The skills

Skill What it does Ships with
threejs-scene Real-time 3D sites built from code: buildings, vehicles, machines, landscapes. Sky and sun presets that blend, soft fitted shadows, ambient occlusion, bloom, instancing, profile sweeps, shader patches, camera flights, quality tiers A complete 60 fps starter scene, and notes on lighting, geometry, shaders and performance
scroll-film Scroll-scrubbed films from generated clips: chained with start and end frames, holds for captions, phone versions, loading order, reduced motion scroll-film.js engine, a prep script for frames or scrub-ready video, a seam checker
motion-assets Planning and generating AI images and clips without wasting money: asset lists with prompts and costs up front, one look across assets, model choice by capability, rate limits, logging A loop checker that finds and fixes loop points, and a paste-back tool for outpainted images
alpha-cutout Transparent video from clips shot on a key plate: per-frame plate measurement, edge unmixing, outputs for every browser including Safari Plate builder, keyer (stacked-alpha MP4, VP9 alpha, WebP frames), WebGL alpha video player
cursor-rig A painted character whose head follows the cursor, built as a grid of poses on one fixed body, with live blinks Rig builder (alignment, even steps, flow in-betweens) and a spring-driven canvas player
exploded-view Interactive explainers of how machines work: staged explode, x-ray, section cut, labels with leader lines, picking explode.js and the motor demo above
site-check Checks a 3D or animated page in headless Chromium and WebKit at three sizes: frame time, draw calls, errors, blank canvases, overflow, reduced motion A checker that writes a report and a contact sheet, and a Range-capable local server
frame-capture Frame-exact 60 fps video of any page by running it on a virtual clock; labelled side-by-side or stacked comparisons Recorder, comparison builder, local server

How they work together

  1. Plan. motion-assets writes the concept, the asset list, every prompt and the cost, and waits for a yes before spending anything.
  2. Make. threejs-scene builds what should be real-time. scroll-film, alpha-cutout and cursor-rig turn generated clips into page motion. exploded-view takes a machine apart.
  3. Check. site-check shoots every state in real browsers and fails on errors, blank canvases and broken phone layouts.
  4. Show it. frame-capture records the result as a smooth video for X, YouTube or a client, and builds before-and-after comparisons.

Requirements

The skills are instructions; their scripts need:

Nothing is installed behind your back and no API keys are stored by the skills.

Common questions

Do I need a particular AI video service? No. The skills describe what a model must be able to do (start and end frames, image editing that holds framing) and how to check its output. They were built with Higgsfield, MiniMax, Kling, Seedance and Nano Banana, and say so where a behaviour was observed.

Why build 3D from code instead of loading models? Code-built scenes are small, sharp at any size, free of licensing questions and easy for an agent to change. exploded-view works on loaded GLB files too.

Does it work with React, Vue or Svelte? Yes. The modules are plain ES modules and the techniques are framework-free.

Can I install just one skill? Yes: npx skills add Moh4696/open-3d-skills --skill scroll-film. Skills mention each other by name where they work together, but each one works alone.

Works well with

Feedback

Open an issue or a pull request, or find me on X at @exploraX_.

License

MIT License · Copyright (c) 2026 exploraX

open-3d-skills (Moh4696/open-3d-skills)

Searching Database…

What is this?Eight agent skills that teach coding agents such as Claude Code, Codex, Cursor and Gemini CLI to build 3D and animated websites: three.js scenes from code, scroll-scrubbed films, transparent video, cursor-following characters, exploded views, plus browser checks and 60 fps recording.
Is it a library I import into my site, or tools for my agent?Mostly the second. Each skill is a folder with a SKILL.md file that an agent loads as instructions, and some skills ship scripts that need Node, Python or ffmpeg. The browser modules are plain ES modules you can use directly.
What do I need before installing?Node 22.20 or newer for the npx installer and the repo's checks. motion-assets, alpha-cutout, cursor-rig and scroll-film also need Python 3.9+, ffmpeg on your PATH, and an image or video generation service of your choice.
Do I need an AI video service?Only for four skills: motion-assets, alpha-cutout, cursor-rig and scroll-film. threejs-scene, exploded-view, site-check and frame-capture work without one, and the skills don't lock you to a particular service.
Which agents does it work with?Claude Code, Codex, Cursor and Gemini CLI, plus OpenCode, Antigravity and other agents that support Agent Skills.
Does it store my API keys or send my data anywhere?The skills don't store API keys, and nothing is installed without your say-so. Any generation service you pick for the AI-based skills will of course receive your prompts.
Do I need to download 3D models or textures?No. The starter pavilion and the motor demo are built entirely from code, with no model files or textures to download. exploded-view can also work with GLB files you load yourself.
Does it work with React, Vue or Svelte?Yes. The modules are plain ES modules and the techniques are framework-free, so they fit into any of them.
Why build 3D from code instead of loading models?Code-built scenes are small, sharp at any size, free of licensing questions and easy for an agent to change.
How do I get a smooth 60 fps video of my page?frame-capture records any page frame by frame at 60 fps by running it on a virtual clock, and can build labelled side-by-side or stacked before-and-after comparisons.
Creator
Moh4696
Size
1.7 MB
Stars
418
Updated
CommitNov 09
Age
18d
Commits · 90 Days