Skip to content
Skills Library
Design & UX · Building & coding

bigbangplanner

/bigbangplanner

Builds and edits an interactive 3D model of a home from its floor plan, measurements and photos, with a first-person walk, a measuring tool, single-room view and a 2D plan with dimensions, in English and Spanish. Use it when someone wants to see their home or a renovation in 3D, furnish it, try another layout, check whether something fits or compare real measurements with the plan's.

Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
7
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Builds and edits an interactive 3D model of a home from its floor plan, measurements and photos, with a first-person walk, a measuring tool, single-room view and a 2D plan with dimensions, in English and Spanish. Use it when someone wants to see their home or a renovation in 3D, furnish it, try another layout, check whether something fits or compare real measurements with the plan's.

Original author description

Builds and edits an interactive 3D model of a home from its floor plan, measurements and photos, with a first-person walk, a measuring tool, single-room view and a 2D plan with dimensions, in English and Spanish. Use it when someone wants to see their home or a renovation in 3D, furnish it, try another layout, check whether something fits or compare real measurements with the plan's.

How it works

  1. Language
  2. How to work with the user
  3. Rules
Original SKILL.md headings · 61 lines, 831 words
SKILL.md preview
---
name: bigbangplanner
description: Builds and edits an interactive 3D model of a home from its floor plan, measurements and photos, with a first-person walk, a measuring tool, single-room view and a 2D plan with dimensions, in English and Spanish. Use it when someone wants to see their home or a renovation in 3D, furnish it, try another layout, check whether something fits or compare real measurements with the plan's.
---

# Big Bang Planner

A kit to turn a home's floor plan into a 3D model you can explore in the browser. The engine (`engine/`) is already done: for each house you only write a data file, `houses/<name>/house.js`, in metres. Nothing needs installing: three.js loads from a CDN.

- Full house format and list of pieces: `docs/FORMAT.md`. **Read it before writing a house.**
- Complete example: `houses/apartment-4a/house.js`.
- The engine is not changed for a particular house. If a piece of furniture is missing, define it as a custom piece inside that `house.js`.

## Language

- **Talk to the user in their language.** The code, file names and data keys are in English whatever the user speaks.
- The viewer's interface is in English and Spanish and follows the browser (`?lang=en|es` forces one). Write the house texts (`name`, `description`, room names and cards, furniture names and cards, labels) as `{ en, es }` when the house will be seen in both languages; if the user only needs one, a plain string is enough. Ask if unsure.

## How to work with the user

### 1. Prepare

- Copy this kit folder to wherever the user's project will live (or work in it if it is already theirs).
- Create `houses/<name>/house.js` (name in lowercase, with hyphens) from the example, emptying walls, rooms and furniture.
- Ask for **the plan** (image or PDF) and **one real, known measurement** of a long wall: that is what sets the scale.

### 2. Scale and origin

- Work out the plan's scale from that measurement (pixels per metre). With a printed scaled plan, check the scale with two measurements, not one.
- Put the origin at the outer north-west corner and convert everything to metres. **Do not store pixels in `house.js`**: the data must read as measurements.
- If the plan does not have north at the top, turn it in your head: in `house.js`, "north" is the top of the drawing.

### 3. Walls, openings and rooms (in this order)

1. **Walls**, outer and partitions, as face-to-face rectangles. Leave no gaps: doors and windows cut them on their own.
2. **Doors and windows.** The opening covers the whole thickness of the wall. For each door, ask or work out from the plan which way it opens and where the hinges are: the arc on the plan shows it.
3. **Rooms** with their interior polygon, floor and a short card.

### 4. Check against reality

- Open the preview (see below) and use the **Plan** button: it gives each room's interior dimensions, wall face to wall face.
- **Ask the user for real measurements** of the important rooms and compare them with the Plan's.
- **When the measurements do not add up**, do not choose for them: say how much is missing or left over, in which stretch, and ask which measurement wins. Often the plan is wrong; sometimes the measurement is.
- Correct in metres. The Plan will tell you whether it is right.

### 5. Furnish

- Room by room, from photos or from what the user tells you. Use the pieces in `docs/FORMAT.md`.
- **Make one change at a time and confirm it** before the next one, especially if the user marks places on a screenshot: put it exactly where they say, without reinterpreting.
- Check in the **Top** view that items do not overlap each other or the swing of the doors.
- If a piece does not exist, create it as a custom piece in `pieces` in `house.js`, with the utilities in `c`.

### 6. Show and publish

- **Local preview:** in the kit folder, `python3 -m http.server 8000`, and open `http://localhost:8000/viewer.html?house=<name>` (add `&lang=en` or `&lang=es` to check each language). Make sure the console has no errors.
- **Publish:** as a claude.ai Artifact, with `viewer.html` as the page and, in `files`, every file in `engine/` and the `houses/<name>/` folder (with its images, if any). Artifacts are private until the user shares them. To open the user's house without `?house=`, change the default house in `viewer.html` (`'apartment-4a'`).
- **Before publishing**, go through what shows with the user: photos of people, real names, the address or anything that identifies the home. Ask before including it.

## Rules

- **Measurements:** the user's real measurements win over the plan. If they do not give them, say in the room's card that they come from the plan or are approximate. Do not invent measurements and present them as real.
- **Do not touch `engine/`** for a particular house. If something general really is missing (a door type, a tool), suggest it to the user as an improvement to the kit.
- **Each house in its own folder.** A house's images (paintings, photos) go in `houses/<name>/` and are referenced with a path relative to `viewer.html`, e.g. `houses/<name>/photo.jpg`.
- **Third-party images:** do not put images or models in the house whose licence does not allow publishing them. The kit's pieces are procedural and do not have that problem.
Files in this package (7)
  • .gitignore 1 KB
  • LICENSE 1 KB
  • README.es.md 4 KB
  • README.md 4 KB
  • SKILL.md 5 KB
  • index.html 27 KB
  • viewer.html 5 KB

Versions

The database has no other skills named bigbangplanner.

Database snapshot: 13.11.2026 · package version 7113a0a6a18e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 1 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100room-from-photos
    Turn a few phone photos of an existing room into a near-photoreal 3D model and plan with furniture layouts to compare and drag around, as a single Three.js HTML file. Use when the user sends photos of a room, with no floor plan, and wants to see it in 3D or work out where…
  • 90product-in-your-room
    Shows one product at real size in the viewer's room: placed on the floor, a table or a wall in AR, with colour or material variants and a single call-to-action button. Use it when the person asks to try a product at home, see furniture, an appliance or decor in a room, view a…
  • 90home-frame
    Use when someone wants their home shown as a live 3D model on a wall photo frame, old tablet or browser, wants to draw or edit a house-control floor plan (rooms, furniture, lamps, ACs, scenes), or wants to link lamps and ACs to Home Assistant so tapping the model switches real lights.
  • 100sg-space-planning
    Use when furnishing or space-planning a Singapore condo, EC or landed unit from its floor plan — seeing which households a layout suits, deciding what a room can hold, making an awkward room work, laying a room out for a particular household (WFH couple, young family,…
  • 90furnish-a-room
    Furnish rooms of a floor plan with the 4Lines connector. Use when the user asks to furnish a plan, or to lay out or redo a kitchen, a bathroom, a bedroom or a living-dining room, or to place, move or resize furniture.
  • 100cad-skill
    Home interior design in a live house designer (2D / 3D / furniture / MEP / ceilings / quote / drawing set) the user can also edit by hand; every model change starts from the user's latest saved version. From an existing floor plan (image, PDF, DXF, CAD) it reconstructs the plan;…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.