open-3d-skills README

项目的 README,来自 github.com/Moh4696/open-3d-skills。合并为一个 markdown 文件: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)

正在搜索数据库…

这是什么?八套智能体技能,用来教 Claude Code、Codex、Cursor、Gemini CLI 等编程智能体搭建 3D 和动画网站:用代码生成的 three.js 场景、随页面滚动逐帧推进的影片、透明背景视频、跟随光标移动的角色、爆炸图,以及浏览器端检查和 60 fps 录制。
这是要导入我网站的库,还是给我的智能体用的工具?主要是后者。每个技能都是一个文件夹,里面有一个 SKILL.md 文件,智能体会把它当作说明来加载;部分技能附带的脚本需要 Node、Python 或 ffmpeg。浏览器端模块是普通的 ES 模块,可以直接使用。
安装前需要准备什么?npx 安装程序和仓库的检查需要 Node 22.20 或更高版本。motion-assets、alpha-cutout、cursor-rig 和 scroll-film 还需要 Python 3.9+、已加入 PATH 的 ffmpeg,以及你自选的图像或视频生成服务。
我一定要用 AI 视频服务吗?只有四个技能需要:motion-assets、alpha-cutout、cursor-rig 和 scroll-film。threejs-scene、exploded-view、site-check 和 frame-capture 不需要,而且这些技能不会把你绑定到某一家服务上。
它支持哪些智能体?Claude Code、Codex、Cursor 和 Gemini CLI,以及 OpenCode、Antigravity 和其他支持 Agent Skills 的智能体。
它会保存我的 API 密钥,或把我的数据发送到别处吗?这些技能不会保存 API 密钥,未经你同意也不会安装任何东西。你为基于 AI 的技能选择的生成服务,自然会收到你的提示词。
我需要下载 3D 模型或贴图吗?不需要。入门示例“展馆”和“电机演示”完全由代码构建,无需下载模型文件或贴图。exploded-view 也可以配合你自己加载的 GLB 文件使用。
它能和 React、Vue 或 Svelte 一起用吗?可以。模块是普通的 ES 模块,技术方案不依赖任何框架,因此可以接入其中任何一个。
为什么要用代码构建 3D,而不是加载模型?用代码构建的场景体积小,任意尺寸下都清晰,不存在授权问题,而且智能体很容易修改。
怎样才能得到我页面流畅的 60 fps 视频?frame-capture 使用虚拟时钟运行页面,以 60 fps 逐帧录制任意页面,还可以生成带标注的左右并排或上下堆叠的前后对比视频。
作者
Moh4696
大小
1.7 MB
星标
418
更新
提交Nov 09
时长
18天
提交 · 90 天