The project's README from github.com/lhlGitHub/threejs-architecture-effects. As one markdown file: README.md.
Portable Agent Skill by Hailey. It builds a real, orbitable Three.js building that assembles itself: brick courses, timber frame, dougong, layered eaves, procedural PBR materials, and close-up cameras.
中文:给 Codex / Claude Code / Cursor 用的开源 skill。输出是可运行的三维古建网站,不是贴图揭幕,也不需要 API key。
GitHub README cannot play a repo .mp4 inline, so the motion preview is a GIF. Click it (or the link) to play the full video.
npm ci && npm run devThe bundled clock tower is a working example, not a historical reconstruction and not the only design this skill can make.
Copy this folder into the agent skills directory, then start a new session:
| Runner | Path |
|---|---|
| Codex | ~/.codex/skills/threejs-architecture-effects (or $CODEX_HOME/skills/) |
| Claude Code | ~/.claude/skills/threejs-architecture-effects |
| Cursor | ~/.cursor/skills/threejs-architecture-effects |
git clone https://github.com/lhlGitHub/threejs-architecture-effects.git
cp -R threejs-architecture-effects ~/.cursor/skills/
Then ask:
Use $threejs-architecture-effects to make a Chinese pavilion like the starter: red walls, dark-green tiles, built storey by storey, orbitable, with eave close-ups.
Other useful prompts:
Needs Node.js 22.13+, npm, and a WebGL2 browser.
git clone https://github.com/lhlGitHub/threejs-architecture-effects.git
node threejs-architecture-effects/scripts/scaffold.mjs ./my-building
cd my-building
npm ci
npm run dev
The scaffold copies assets/starter/ into a new directory and refuses to overwrite an existing one. It does not install packages or start a server.
Controls: drag to orbit, scroll to zoom, timeline to scrub, 飞檐细赏 / 石狮近观 for close-ups.
Details for agents: SKILL.md, construction principles, template map, verification.
threejs-architecture-effects/
├── SKILL.md Agent entry
├── LICENSE MIT, Copyright (c) 2026 Hailey
├── agents/openai.yaml Codex UI metadata
├── scripts/scaffold.mjs Copy the starter into a new project
├── references/ Construction, template map, verification
├── assets/preview.gif README motion preview
├── assets/preview.png README still
├── assets/preview.mp4 Full screen recording
└── assets/starter/ Vite + React + Three.js miniature
node_modules.MIT. Copyright (c) 2026 Hailey. See LICENSE.