Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lhlgithub--threejs-architecture-effects/badge.svg)](/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

i

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)

  1. ---
  2. name: threejs-architecture-effects
  3. 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.
  4. license: MIT
  5. metadata:
  6. author: Hailey
  7. version: "1.0.0"
  8. requires: "Node.js 22.13+, npm, WebGL2 browser. No API keys."
  9. ---
  10. # Three.js Architecture Effects
  11. 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.
  12. Resolve `<this-skill-dir>` from the loaded `SKILL.md`. Do not mix files from a different install of this skill.
  13. ## References
  14. | File | Read it when |
  15. | --- | --- |
  16. | [references/template-guide.md](references/template-guide.md) | scaffolding a new project or mapping starter files |
  17. | [references/construction-principles.md](references/construction-principles.md) | geometry, assembly timing, materials, or lighting |
  18. | [references/verification.md](references/verification.md) | stutter, quality checks, metrics, or handoff |
  19. ## Choose the starting point
  20. - **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.
  21. - **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.
  22. - **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.
  23. ## Method
  24. 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.
  25. 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.
  26. 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.
  27. 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.
  28. 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.
  29. 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.
  30. 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.
  31. ## Scope
  32. 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.
  33. 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.
  34. ## What goes wrong
  35. 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.
  36. ## Report
  37. 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)

  1. # threejs-architecture-effects
  2. 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.
  3. 中文:给 Codex / Claude Code / Cursor 用的开源 skill。输出是可运行的三维古建网站,不是贴图揭幕,也不需要 API key。
  4. [![Brick-by-brick construction of a Chinese clock tower](assets/preview.gif)](https://github.com/lhlGitHub/threejs-architecture-effects/blob/main/assets/preview.mp4)
  5. <p align="center"><a href="https://github.com/lhlGitHub/threejs-architecture-effects/blob/main/assets/preview.mp4">Watch the full 20s demo →</a></p>
  6. <img src="assets/preview.png" alt="Completed clock-tower miniature" width="100%">
  7. 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.
  8. ## What you get
  9. - A **solid 3D miniature**, not a video on a plane
  10. - Construction driven by **one 0–1 timeline**: play, pause, scrub backward, replay
  11. - **Procedural** brick, wood, plaster, tile, stone, bronze — no paid models
  12. - Orbit, zoom, and detail cameras for eaves and stone lions
  13. - A Vite + React + Three.js starter you can run with `npm ci && npm run dev`
  14. The bundled clock tower is a working example, not a historical reconstruction and not the only design this skill can make.
  15. ## Install
  16. Copy this folder into the agent skills directory, then start a new session:
  17. | Runner | Path |
  18. | --- | --- |
  19. | Codex | `~/.codex/skills/threejs-architecture-effects` (or `$CODEX_HOME/skills/`) |
  20. | Claude Code | `~/.claude/skills/threejs-architecture-effects` |
  21. | Cursor | `~/.cursor/skills/threejs-architecture-effects` |
  22. ```sh
  23. git clone https://github.com/lhlGitHub/threejs-architecture-effects.git
  24. cp -R threejs-architecture-effects ~/.cursor/skills/
  25. ```
  26. Then ask:
  27. > 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.
  28. Other useful prompts:
  29. - Keep the current tower shape and cameras. Only refine eave thickness, timber, and the clock faces.
  30. - Turn the template into a two-storey lakeside pavilion. Keep timber and tile assembly. No clocks or lions.
  31. ## Run the starter without an agent
  32. Needs Node.js 22.13+, npm, and a WebGL2 browser.
  33. ```sh
  34. git clone https://github.com/lhlGitHub/threejs-architecture-effects.git
  35. node threejs-architecture-effects/scripts/scaffold.mjs ./my-building
  36. cd my-building
  37. npm ci
  38. npm run dev
  39. ```
  40. 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.
  41. Controls: drag to orbit, scroll to zoom, timeline to scrub, **飞檐细赏** / **石狮近观** for close-ups.
  42. ## How construction works
  43. 1. Write an assembly plan: foundations → frame → masonry → decks → upper walls → brackets / eaves / tiles → ornament.
  44. 2. Model the finished silhouette first so parts share dimensions and nothing floats.
  45. 3. Give every solid piece a start, duration, and travel. Color and shadow shaders share one progress value, so seeking is deterministic.
  46. 4. Author materials separately (color, roughness, micro-height). Do not hide crude joints with fog or bloom.
  47. Details for agents: [SKILL.md](SKILL.md), [construction principles](references/construction-principles.md), [template map](references/template-guide.md), [verification](references/verification.md).
  48. ## Layout
  49. ```
  50. threejs-architecture-effects/
  51. ├── SKILL.md Agent entry
  52. ├── LICENSE MIT, Copyright (c) 2026 Hailey
  53. ├── agents/openai.yaml Codex UI metadata
  54. ├── scripts/scaffold.mjs Copy the starter into a new project
  55. ├── references/ Construction, template map, verification
  56. ├── assets/preview.gif README motion preview
  57. ├── assets/preview.png README still
  58. ├── assets/preview.mp4 Full screen recording
  59. └── assets/starter/ Vite + React + Three.js miniature
  60. ```
  61. ## Limits
  62. - Procedural geometry only. No paid model service, no background music in the starter.
  63. - Video export is not included; the template is an interactive site.
  64. - Desktop-oriented. Do not claim museum quality, historical accuracy, or universal 60 FPS from one machine.
  65. - npm packages keep their own licenses. This skill does not vendor `node_modules`.
  66. ## License
  67. MIT. Copyright (c) 2026 Hailey. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.