Moh4696/open-3d-skills

项目介绍

Open 3D Skills 把八项技能打包给 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等编码智能体。每项技能是一个带 SKILL.md 的普通目录加配套脚本，支持 Agent Skills 的智能体都能加载。技能覆盖：用代码构建 three.js 实时场景、滚动驱动的影片、可播放的透明视频、跟随光标的人物、机器爆炸视图、AI 动效素材的规划、浏览器检查，以及逐帧 60 fps 录屏。README 称每项技术都先在真实网站中使用过，每个脚本都在真实素材上跑过才收入仓库。

实际价值在于智能体拿到的是操作流程、起始场景和小工具，而不是靠猜 WebGL 与浏览器兼容细节。示例中的凉亭场景和电动机演示完全由代码构建，不依赖模型文件或下载贴图。

安装与首次使用

前置条件：npx skills 和仓库自带检查需要 Node 22.20 以上；Python 3.9 以上并安装 requirements.txt 中的依赖（Playwright、Pillow、NumPy、OpenCV），再执行 python3 -m playwright install chromium webkit；ffmpeg 需在 PATH 中。图像和视频生成类技能还需要一个图像/视频生成服务；threejs-scene、exploded-view、site-check 和 frame-capture 不需要。

用开放的 npx skills 命令行安装 npx skills add Moh4696/open-3d-skills：

npx skills add Moh4696/open-3d-skills

安装器会询问要哪几项技能、装给哪些智能体、作用于当前项目还是所有项目。装完后新开一个智能体会话。非交互和单技能写法：

npx skills add Moh4696/open-3d-skills -g -y
npx skills add Moh4696/open-3d-skills --skill threejs-scene
npx skills update

Claude Code 用户也可以添加市场并安装插件：/plugin marketplace add Moh4696/open-3d-skills 和 /plugin install open-3d-skills@open-3d-skills Claude Code 插件安装。Codex、Cursor、Gemini CLI 各有对应安装方式，没有 Node 的系统可使用 shell 安装器 shell 安装器。

典型流程：用 motion-assets 规划素材与成本，用 threejs-scene 做实时内容，用滚动/透明视频/光标技能加入页面动效，用 site-check 在无头 Chromium 和 WebKit 里验证，再用 frame-capture 录出 60 fps 视频。

使用约束

浏览器代码没有构建步骤，模块是普通 ES 模块，可以和 React、Vue、Svelte 一起用。依赖生成的技能需要外部模型服务，但不限定具体厂商；README 提到开发时用过 Higgsfield、MiniMax、Kling、Seedance 和 Nano Banana。这些技能是说明加脚本，不是托管服务；README 声明不保存 API 密钥、不在后台偷偷安装东西。

通过 npx skills 或 shell 安装器安装会执行第三方安装代码，使用前应查看安装器；若想检查并控制链接到哪些智能体和技能，优先用克隆后 ./install.sh 的带参写法。项目采用 MIT 许可证。

HotRepo 点评

仓库创建于 2026-10-31，到 2026-11-01 已有 112 个 Star 和 20 个 Fork，并在 JavaScript 新项目榜的约两小时统计窗口内新增 7 个 Star。记录时间很短，不足以说明持续热度。技术上的亮点是范围：它把智能体当作会规划、构建、在真实浏览器里检查并录制成果的协作方，而不只是生成 three.js 片段。对要上线 3D 落地页的人来说，site-check 验证和 frame-capture 可复现录屏最实用；生成类素材的效果则取决于所选的外部模型服务。