# Interior Scene

> Plan an interior architectural visualization scene (room layout, furniture, materials, natural + artificial lighting) before any modeling or render attempt.

- Skill: `thanhnguyxnorg/interior-scene` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx get-skill add thanhnguyxnorg/interior-scene`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thanhnguyxnorg/interior-scene/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ThanhNguyxnOrg (https://skillmd.com/u/thanhnguyxnorg)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/thanhnguyxnorg/interior-scene

---


# interior-scene

## Purpose
Translate an interior architectural visualization intent (room or interior space planned for catalog, brand, or showcase) into a complete, structured room plan with an assumptions register. Distinct from `environment-shot` (outdoor/wide places; an establishing shot of an interior room belongs HERE when furniture and surfaces dominate), `product-hero-scene-planner` (single manufactured product), and `character-portrait` (single subject).

## Quick start
- lock style early and pin room type + plausible room dimensions (never invent dimensions; record any defaults in the assumptions register)
- pin architecture basics (walls, floor, ceiling, windows, doors)
- pin furniture + props + material palette
- pin lighting (natural + artificial mix) + mood + time of day
- pin camera angle + lens
- emit a structured plan with an assumptions register + handoff to `asset-discovery`, `mobile-glb-budget`, `asset-style-check`, and quality checkers

## When to use
- intent is an interior room, space, or venue where furniture and surfaces dominate (including interior establishing shots)
- architectural visualization, catalog, brand showcase, hospitality, or residential room planning
- before any modeling, furniture sourcing, or rendering

## When not to use
<!-- blendops:generated:start exclusions -->
- outdoor establishing → use `../environment-shot/SKILL.md` (use environment-shot)
- single hero product → use `../product-hero-scene-planner/SKILL.md` (use product-hero-scene-planner)
- character portrait → use `../character-portrait/SKILL.md` (use character-portrait)
<!-- blendops:generated:end exclusions -->

## Trigger phrases
<!-- blendops:generated:start triggers -->
- "interior of"
- "living room scene"
- "office showcase"
- "hotel lobby"
- "kitchen showroom"
<!-- blendops:generated:end triggers -->

## Prerequisites / readiness
- brief from `intent-to-3d-brief-writer`
- room type + style known
- aspect / use case known

## Input schema

### Required inputs

| Input | Why it is required |
|---|---|
| Room type + plausible dimensions | Drives layout, scale, and furniture fit (dimensions must be plausible, never invented) |
| Style era / aesthetic | Locked early to drive architecture, material palette, and furniture choices |
| Time of day + mood | Drives natural light direction, intensity, and artificial fixture balance |
| Aspect ratio | Drives camera framing and composition rules |

### Optional inputs

| Input | Use |
|---|---|
| Reference images / boards | Style calibration |
| Brand guidelines | Color, material, and branding alignment |
| Specific furniture requests | Flagged as rows for `asset-discovery` |

### Assumptions to confirm
- Plausible room dimensions explicitly stated or flagged for confirmation (never silently invented).
- Style is locked early and consistent across architecture, furniture, and props (validated via `asset-style-check`).
- Scene scope is realizable within target asset/performance constraints (budget questions routed to `mobile-glb-budget`).
- Camera position, lens, and target are locked before modeling.

## Output schema

### Primary output
A complete interior room plan containing:
- Room (type, plausible dimensions, locked style)
- Architecture (walls, floor, ceiling, windows, doors)
- Furniture + props
- Material palette (key surfaces + finishes)
- Lighting (natural light via windows + artificial fixtures + practical lamps)
- Camera (position, lens, target)
- Mood + time of day
- Assumptions register (all unconfirmed inputs and plausible dimension assumptions)

### Secondary output
- asset rows flagged for `asset-discovery`
- style consistency notes for `asset-style-check`
- budget questions flagged for `mobile-glb-budget`
- validation handoff list for `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`

### Evidence / caveat output

```txt
Runtime status: Not Run | Attempted | Produced | Verified | Failed
Artifact status: Not Produced | Produced | Verified | Failed
Evidence used: <links, paths, logs, or "none">
Limitations: <known gaps>
```

## Required laws
- `../../laws/evidence-before-done.md`
- `../../laws/non-blender-user-language.md`
- `../../laws/no-arbitrary-python-interface.md`
- `../../laws/official-runtime-only.md`

## Official runtime boundary

Planning-only skill — does not model, source furniture, render, or execute Blender. Runtime status stays `Not Run` and artifact status stays `Not Produced` (downgrade-only, never upgrade). Hand off asset sourcing to `asset-discovery`, budget questions to `mobile-glb-budget`, style checks to `asset-style-check`, and validation to `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.

## Operating procedure
1. Read brief from `intent-to-3d-brief-writer`; lock style early and pin room type + plausible room dimensions (never invent dimensions; log any unconfirmed values in the assumptions register).
2. Pin architecture basics: walls, floor, ceiling, windows, and doors (see `references/interior-architecture-rules.md`).
3. Plan furniture layout + props (see `references/furniture-layout-rules.md`).
4. Pin material palette and key surfaces matching the locked style.
5. Plan lighting: natural light (windows + sun direction) + artificial light (overhead fixtures + practical lamps).
6. Pin camera position, lens, and target (see `references/interior-camera-rules.md`).
7. Pin mood + time of day.
8. Compile the assumptions register and list asset rows for `asset-discovery`.
9. Emit handoffs to `asset-discovery`, `mobile-glb-budget`, `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.

## Decision tree

```txt
Room dimensions missing or unrealistic for use case (e.g. 100m² home office)?
  → Do not invent dimensions; warn, propose plausible defaults in the assumptions register, and verify intent
Style unclear in brief?
  → Return to intent-to-3d-brief-writer before planning furniture or materials
Style + furniture mismatch (e.g. modern brief + ornate Victorian sofa)?
  → Fail; lock one style early and route to asset-style-check
Performance or polycount budget in question?
  → Route budget questions to mobile-glb-budget
Time of day mid-day but only artificial lighting planned?
  → Warn; natural window light should be accounted for alongside artificial fixtures
Wide-angle 14mm in a small room?
  → Warn; distortion likely; propose 24mm + camera repositioning
```

## Playbooks

### Playbook A: Modern living room hero (16:9 catalog)
24–35mm wide; camera in corner; afternoon natural light through window; sofa + coffee table + rug as primary furniture; minimal palette; soft shadows.

### Playbook B: Hospitality lobby (1:1 social)
35mm; camera centered toward focal art / reception; warm artificial lighting + minimal natural; rich materials.

### Playbook C: Office showroom (wide 2.39:1)
24mm; camera elevated; mix natural + artificial; clean material palette; depth layered (foreground furniture + midground workstations + background views).

## Mode handling

### Text-only mode
Emit the structured room plan, assumptions register, and handoff list. Runtime stays `Not Run`; artifacts stay `Not Produced`.

### Runtime-ready mode
Emit the structured room plan, assumptions register, and downstream handoffs. Do not execute Blender; runtime stays `Not Run` and artifacts stay `Not Produced`.

### Blocked runtime mode
Emit the structured room plan and assumptions register; flag what cannot be confirmed downstream. Runtime stays `Not Run`; artifacts stay `Not Produced`.

## Validation checklist
- [ ] Style locked early
- [ ] Room type + plausible dimensions pinned (never invented)
- [ ] Assumptions register populated
- [ ] Architecture basics (walls, floor, ceiling, windows, doors) pinned
- [ ] Furniture + props listed
- [ ] Material palette + key surfaces listed
- [ ] Lighting plan (natural + artificial) explicit
- [ ] Camera position + lens + target chosen
- [ ] Mood + time of day pinned
- [ ] Asset rows flagged for `asset-discovery`
- [ ] Handoffs named (`mobile-glb-budget`, `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, `scene-readiness`)
- [ ] Runtime status locked to `Not Run` and Artifact status locked to `Not Produced`

## Pass / Warn / Fail rubric

| Verdict | Criteria |
| --- | --- |
| Pass | All room plan sections complete, style locked early, plausible dimensions with assumptions register, natural + artificial lighting planned, assets flagged, handoffs named, truth states set to `Not Run` / `Not Produced`. |
| Warn | Minor ambiguity recorded in assumptions register (e.g. secondary prop finish or exact window orientation pending confirmation). |
| Fail | Invented or implausible room dimensions; missing assumptions register; style + furniture clash; missing lighting or camera plan; truth states upgraded beyond `Not Run` / `Not Produced`. |

## Failure handling
- Unclear brief or style → hand off to `intent-to-3d-brief-writer`.
- Style mismatch across assets → hand off to `asset-style-check`.
- Unknown asset or performance budget → hand off to `mobile-glb-budget`.
- Composition, lighting, material, or overall scene validation issues → hand off to `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.

## Troubleshooting

| Problem | Resolution |
| --- | --- |
| Room dimensions not supplied by user | Do not invent silently; propose standard plausible dimensions in the assumptions register and request confirmation. |
| Planned layout feels empty or lacks depth | Add foreground/midground prop layers in the plan, place camera in a corner rather than room center, and flag for `composition-quality-checker`. |
| Planned lighting lacks contrast | Balance natural window light direction with warm artificial practical lamps, and flag for `lighting-quality-checker`. |
| Planned materials or furniture clash | Lock the style palette early and route to `asset-style-check` and `material-quality-checker`. |
| Wide-angle lens distortion risk in small room | Plan for a 24–35mm lens with corner camera placement and verify via `composition-quality-checker`. |

## Best practices
- Plan natural + artificial lighting together; they form a system.
- Always provide a camera in corner (not center) for room scenes — center loses depth.
- Lock palette early (3–5 colors max).
- Treat windows as light sources, not decorations.

## Good examples
- "Room: modern minimalist living room, 4×6m, ceiling 2.7m, style locked to warm Scandinavian modern. Architecture: light oak floor, matte white walls, floor-to-ceiling window on south wall, fireplace center back, flush wood door on east wall. Furniture + props: 3-seat neutral fabric sofa facing fireplace, low oak coffee table, woven area rug, single armchair right, ceramic vase on table. Material palette: light oak, matte white plaster, brushed concrete, warm grey linen. Lighting: afternoon natural sunlight through south window (dominant) + 2 recessed ceiling lights + 1 warm floor lamp by armchair. Camera: 35mm lens, north-east corner at eye-level, targeting sofa and fireplace framing. Mood + time of day: calm, warm afternoon (15:00). Assumptions register: 2.7m ceiling height assumed as plausible residential standard pending user confirmation; standard doorway width assumed. Runtime status: Not Run. Artifact status: Not Produced."

## Bad examples
- "Living room scene." — no dims, style, lighting, or camera.

## User-facing response template

```txt
Room: <type / plausible dims / locked style>
Architecture: <walls / floor / ceiling / windows / doors>
Furniture + props: <list>
Material palette: <3-5 dominant finishes>
Key surfaces: <floor / wall / ceiling / furniture fabric>
Lighting: Natural: <window + sun direction + intensity> | Artificial: <ceiling fixtures + practical lamps> | Ambient environment: <sky/exterior bounce if any>
Camera: <focal length> | <position> | <eye-line> | <target>
Mood + time of day: <line>
Assumptions register: <explicitly confirmed vs assumed plausible dimensions, style locks, and constraints>

Assets to discover (for asset-discovery): <list>
Runtime status: Not Run
Artifact status: Not Produced
Evidence used: <brief / inputs or "none">
Limitations: <gaps>
Next: asset-discovery | mobile-glb-budget | asset-style-check | composition-quality-checker | lighting-quality-checker | material-quality-checker | scene-readiness
```

## Anti-patterns
- Center-of-room camera for hero shots (loses depth).
- Skipping window light when natural light is available.
- Mixing style eras without intent.
- Inventing room dimensions.

## Cross-skill handoff
<!-- blendops:generated:start handoffs -->
- [upstream_reference] Upstream brief → `../intent-to-3d-brief-writer/SKILL.md`
- [upstream_reference] Outdoor / wide establishing shot redirect → `../environment-shot/SKILL.md`
- [upstream_reference] Single hero product redirect → `../product-hero-scene-planner/SKILL.md`
- [upstream_reference] Single character portrait redirect → `../character-portrait/SKILL.md`
- [upstream_reference] Asset discovery → `../asset-discovery/SKILL.md`
- [upstream_reference] Performance / polycount budget → `../mobile-glb-budget/SKILL.md`
- [upstream_reference] Style consistency check → `../asset-style-check/SKILL.md`
- [progression] Composition validation → `../composition-quality-checker/SKILL.md`
- [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
- [progression] Material validation → `../material-quality-checker/SKILL.md`
- [progression] Scene quality validation → `../scene-readiness/SKILL.md`
<!-- blendops:generated:end handoffs -->

## Non-goals
- Model the room or geometry.
- Source furniture or download assets (belongs to `asset-discovery`).
- Decide performance or polycount budgets (belongs to `mobile-glb-budget`).
- Audit cross-asset style consistency or validate composition, lighting, materials, or scene quality (belongs to `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`).
- Render or run Blender.

## References
- `references/interior-architecture-rules.md`
- `references/furniture-layout-rules.md`
- `references/interior-camera-rules.md`
- `../../docs/skill-system.md`

