threejs-architecture-effects
An Agent Skill for building interactive, self-assembling 3D architecture with Three.js. 一个用 Three.js 生成可交互、可动态建造 3D 建筑的 Agent Skill。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/lhlgithub--threejs-architecture-effects)HTML
<a href="/listings/lhlgithub--threejs-architecture-effects"><img src="/api/listings/lhlgithub--threejs-architecture-effects/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.
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:
- Keep the current tower shape and cameras. Only refine eave thickness, timber, and the clock faces. - Turn the template into a two-storey lakeside pavilion. Keep timber and tile assembly. No clocks or lions.
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.
SKILL.md · Manifest · 53 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: threejs-architecture-effects
- description: Build or refine real Three.js architectural construction animations, especially Chinese pavilions, pagodas and clock towers with brick-by-brick growth, timber framing, layered eaves, procedural PBR materials and interactive detail cameras. Use for 3D建筑生长、古建搭建特效、楼台逐层建造、建筑动态组装 or similar architectural miniatures; not for flat image reveals or generic website styling.
- license: MIT
- metadata:
- author: Hailey
- version: "1.0.0"
- requires: "Node.js 22.13+, npm, WebGL2 browser. No API keys."
- ---
- # Three.js Architecture Effects
- Create an actual, orbitable 3D building assembled from solid components. The included clock-tower miniature is a working reference, not a mandatory design or a historical reconstruction.
- Resolve `<this-skill-dir>` from the loaded `SKILL.md`. Do not mix files from a different install of this skill.
- ## References
- | File | Read it when |
- | --- | --- |
- | [references/template-guide.md](references/template-guide.md) | scaffolding a new project or mapping starter files |
- | [references/construction-principles.md](references/construction-principles.md) | geometry, assembly timing, materials, or lighting |
- | [references/verification.md](references/verification.md) | stutter, quality checks, metrics, or handoff |
- ## Choose the starting point
- - **Existing project:** inspect its scene owner, geometry factories, timing, materials, controls, and renderer diagnostics before editing. Preserve its recognizable design, cameras, and interactions unless the user asks to change them. Do not scaffold over it.
- - **New project:** read the template guide, then run `node <this-skill-dir>/scripts/scaffold.mjs <new-project-directory>`. The script refuses an existing destination. It copies a self-contained Vite/React/Three.js starter; it does not install packages or start services.
- - **Reference video or images:** inspect the supplied media as reference only. Identify structural stages and proportions. Do not return the reference video as your work, paste screenshots onto planes, or promise an unsupported similarity percentage.
- ## Method
- 1. Translate the reference into an assembly plan: foundations → load-bearing frame → masonry courses → floor/deck → upper frame/walls → brackets/eaves/tiles → ornament. Distinguish a structural floor from a late-installed decorative roof so higher levels never float.
- 2. Build the stable final silhouette first. Derive adjoining parts from common dimensions and height functions. Check front, three-quarter, and underside views before refining surface detail.
- 3. Give each solid component a start, duration, and travel distance. Drive the whole scene from one normalized progress value shared by color and depth shaders. Seeking backward, pausing, and replaying must remain deterministic.
- 4. Prioritize roof thickness, rafters/purlins, bracket supports, and meaningful joints before increasing ornament count. Then separate brick, plaster, wood, ceramic, stone, and metal through independently authored color, roughness, and micro-height.
- 5. Use restrained deterministic variation. Preserve repeating architectural rhythm while varying UV sampling, tile tint, and small dimensions; do not randomize joints out of alignment.
- 6. Light as a clean architectural miniature: controlled key/fill/rim, grounded contact, legible eave undersides. Do not hide crude geometry with fog, bloom, or excessive brightness.
- 7. Measure the actual scene while assembling, dragging, and viewing close-ups. Preserve or improve the starter's shadow caching and demand rendering. Inspect after any shader or geometry change; a passing build is not a visual test.
- ## Scope
- No external model service, image generation, subscription, proprietary asset, or other skill is required. Procedural geometry is the default; use external assets only when requested or agreed, with their origin and license recorded. The template is silent intentionally; add music only from an authorized source.
- Keep this skill as instructions plus a portable starter. Do not copy the creator's private sessions, local paths, environment files, or acquisition packages into generated output.
- ## What goes wrong
- A screenshot mapped onto a plane · scaling a whole storey instead of laying courses · alpha-fading walls into existence · color and shadow shaders that disagree · upper floors with no supporting deck · fog or bloom used to hide crude joints · claiming museum quality, historical accuracy, a market price, or universal 60 FPS from one screenshot.
- ## Report
- Deliver runnable source, startup and build commands, a short account of changed surfaces, observed test results, and remaining limitations.
README.md · README · 98 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # threejs-architecture-effects
- Portable [Agent Skill](https://agentskills.io) 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。
- [](https://github.com/lhlGitHub/threejs-architecture-effects/blob/main/assets/preview.mp4)
- <p align="center"><a href="https://github.com/lhlGitHub/threejs-architecture-effects/blob/main/assets/preview.mp4">Watch the full 20s demo →</a></p>
- <img src="assets/preview.png" alt="Completed clock-tower miniature" width="100%">
- 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.
- ## What you get
- - A **solid 3D miniature**, not a video on a plane
- - Construction driven by **one 0–1 timeline**: play, pause, scrub backward, replay
- - **Procedural** brick, wood, plaster, tile, stone, bronze — no paid models
- - Orbit, zoom, and detail cameras for eaves and stone lions
- - A Vite + React + Three.js starter you can run with `npm ci && npm run dev`
- The bundled clock tower is a working example, not a historical reconstruction and not the only design this skill can make.
- ## Install
- 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` |
- ```sh
- 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:
- - Keep the current tower shape and cameras. Only refine eave thickness, timber, and the clock faces.
- - Turn the template into a two-storey lakeside pavilion. Keep timber and tile assembly. No clocks or lions.
- ## Run the starter without an agent
- Needs Node.js 22.13+, npm, and a WebGL2 browser.
- ```sh
- 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.
- ## How construction works
- 1. Write an assembly plan: foundations → frame → masonry → decks → upper walls → brackets / eaves / tiles → ornament.
- 2. Model the finished silhouette first so parts share dimensions and nothing floats.
- 3. Give every solid piece a start, duration, and travel. Color and shadow shaders share one progress value, so seeking is deterministic.
- 4. Author materials separately (color, roughness, micro-height). Do not hide crude joints with fog or bloom.
- Details for agents: [SKILL.md](SKILL.md), [construction principles](references/construction-principles.md), [template map](references/template-guide.md), [verification](references/verification.md).
- ## Layout
- ```
- 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
- ```
- ## Limits
- - Procedural geometry only. No paid model service, no background music in the starter.
- - Video export is not included; the template is an interactive site.
- - Desktop-oriented. Do not claim museum quality, historical accuracy, or universal 60 FPS from one machine.
- - npm packages keep their own licenses. This skill does not vendor `node_modules`.
- ## License
- MIT. Copyright (c) 2026 Hailey. See [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.