pjt222/agent-almanac/create-3d-scene

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Set up a Blender scene programmatically via Python (bpy) with objects, materials, lighting, camera, and environment configuration. Use when creating reproducible 3D visualization scenes, automating product or architectural rendering setup, generating multiple scene variations programmatically, building template scenes for batch rendering workflows, or integrating 3D visualization into data pipelines.

Install

npx vskill@latest install pjt222/agent-almanac/create-3d-scene

SKILL.md

Create 3D Scene

Blender scene via bpy: objects + materials + lights + camera + env.

Use When

  • Repro 3D viz scenes from scratch
  • Auto product / architectural render
  • Gen multi scene variations
  • Template scenes for batch render
  • Prototype layouts pre-manual
  • 3D viz → data pipelines / reports

In

InTypeDescExample
Scene specConfigObjects, mats, lightsProduct dims, colors, lights
Out reqsParamsRes, engine, quality1920x1080, Cycles, 128 samples
Asset pathsPathsModels, textures, HDRIs/path/to/hdri.exr, product_model.obj
CameraParamsPos, rot, focal, DOFlocation=(7,-7,5), lens=50mm
EnvConfigWorld shader, BG, ambientHDRI, solid, gradient

Do

1. Script Struct
python
#!/usr/bin/env python3
"""
Scene setup script for Blender.
Usage: blender --background --python setup_scene.py
"""
import bpy
import math
import os
from pathlib import Path
def clear_scene():
    """Remove all objects from the scene."""
    bpy.ops.object.select_all(action='SELECT')
    bpy.ops.object.delete(use_global=False)
    # Clear orphaned data
    for block in bpy.data.meshes:
        if block.users == 0:
            bpy.data.meshes.remove(block)
    for block in bpy.data.materials:
        if block.users == 0:
            bpy.data.materials.remove(block)
def main():
    clear_scene()
    # Scene setup steps follow
if __name__ == "__main__":
    main()

Got: Script w/ clear_scene() + main() If err: Python syntax, bpy import in Blender env

2. Mesh Objects
python
def add_objects():
    """Add mesh objects to scene."""
    # Add cube
    bpy.ops.mesh.primitive_cube_add(
        size=2.0,
        location=(0, 0, 1)
    )
    cube = bpy.context.active_object
    cube.name = "Product_Base"
    # Add sphere
    bpy.ops.mesh.primitive_uv_sphere_add(
        radius=1.0,
        segments=32,
        ring_count=16,
        location=(3, 0, 1)
    )
    sphere = bpy.context.active_object
    sphere.name = "Detail_Sphere"
    # Import external model (optional)
    # bpy.ops.import_scene.obj(filepath="model.obj")
    return cube, sphere

Got: Objects in scene w/ names + pos If err: Op syntax, coords, no name conflicts

3. Node Materials (PBR)
python
def create_material(name, base_color, metallic=0.0, roughness=0.5):
    """Create a PBR material with node setup."""
    # Create material
    mat = bpy.data.materials.new(name=name)
    mat.use_nodes = True
    nodes = mat.node_tree.nodes
    links = mat.node_tree.links
    # Clear default nodes
    nodes.clear()
    # Add Principled BSDF
    node_bsdf = nodes.new(type='ShaderNodeBsdfPrincipled')
    node_bsdf.location = (0, 0)
    node_bsdf.inputs['Base Color'].default_value = base_color + (1.0,)  # Add alpha
    node_bsdf.inputs['Metallic'].default_value = metallic
    node_bsdf.inputs['Roughness'].default_value = roughness
    # Add Material Output
    node_output = nodes.new(type='ShaderNodeOutputMaterial')
    node_output.location = (300, 0)
    # Link nodes
    links.new(node_bsdf.outputs['BSDF'], node_output.inputs['Surface'])
    return mat
def apply_materials(cube, sphere):
    """Apply materials to objects."""
    # Create materials
    mat_red = create_material("RedPlastic", (0.8, 0.1, 0.1), metallic=0.0, roughness=0.4)
    mat_metal = create_material("Metal", (0.8, 0.8, 0.8), metallic=1.0, roughness=0.2)
    # Assign to objects
    if cube.data.materials:
        cube.data.materials[0] = mat_red
    else:
        cube.data.materials.append(mat_red)
    if sphere.data.materials:
        sphere.data.materials[0] = mat_metal
    else:
        sphere.data.materials.append(mat_metal)

Got: Mats visible in shader editor If err: Node types, link syntax, color [0,1]

4. Lighting
python
def setup_lighting():
    """Add lights to scene."""
    # Sun light
    bpy.ops.object.light_add(
        type='SUN',
        location=(5, 5, 10)
    )
    sun = bpy.context.active_object
    sun.name = "KeyLight"
    sun.data.energy = 3.0
    sun.rotation_euler = (math.radians(45), 0, math.radians(45))
    # Area light (fill light)
    bpy.ops.object.light_add(
        type='AREA',
        location=(-4, -4, 6)
    )
    area = bpy.context.active_object
    area.name = "FillLight"
    area.data.energy = 200.0
    area.data.size = 5.0
    area.rotation_euler = (math.radians(60), 0, math.radians(-135))
    # Point light (rim light)
    bpy.ops.object.light_add(
        type='POINT',
        location=(2, -5, 3)
    )
    point = bpy.context.active_object
    point.name = "RimLight"
    point.data.energy = 500.0

Got: 3 lights w/ intensity + pos If err: Tune energy (Cycles vs EEVEE), rot fmt

5. Camera
python
def setup_camera():
    """Add and configure camera."""
    bpy.ops.object.camera_add(
        location=(7, -7, 5)
    )
    camera = bpy.context.active_object
    camera.name = "MainCamera"
    # Point camera at origin
    direction = (0, 0, 1) - camera.location
    rot_quat = direction.to_track_quat('-Z', 'Y')
    camera.rotation_euler = rot_quat.to_euler()
    # Camera settings
    camera.data.lens = 50  # Focal length in mm
    camera.data.dof.use_dof = True
    camera.data.dof.focus_distance = 10.0
    camera.data.dof.aperture_fstop = 2.8
    # Set as active camera
    bpy.context.scene.camera = camera

Got: Camera w/ focal + DOF If err: Simpler rot if track_to fails, lens units

6. World Env
python
def setup_world():
    """Configure world environment."""
    world = bpy.data.worlds['World']
    world.use_nodes = True
    nodes = world.node_tree.nodes
    links = world.node_tree.links
    # Clear default nodes
    nodes.clear()
    # Add Environment Texture (for HDRI)
    node_env = nodes.new(type='ShaderNodeTexEnvironment')
    node_env.location = (-300, 0)
    # Load HDRI if available
    hdri_path = "/path/to/hdri.exr"
    if os.path.exists(hdri_path):
        node_env.image = bpy.data.images.load(hdri_path)
    # Add Background shader
    node_bg = nodes.new(type='ShaderNodeBackground')
    node_bg.location = (0, 0)
    node_bg.inputs['Strength'].default_value = 1.0
    # Add World Output
    node_output = nodes.new(type='ShaderNodeOutputWorld')
    node_output.location = (300, 0)
    # Link nodes
    links.new(node_env.outputs['Color'], node_bg.inputs['Color'])
    links.new(node_bg.outputs['Background'], node_output.inputs['Surface'])

Got: World w/ HDRI / solid BG If err: Skip HDRI if missing → BG node + color

7. Render Settings
python
def setup_render_settings():
    """Configure render settings."""
    scene = bpy.context.scene
    # Render engine
    scene.render.engine = 'CYCLES'  # or 'BLENDER_EEVEE'
    scene.cycles.samples = 128
    scene.cycles.use_denoising = True
    # Output settings
    scene.render.resolution_x = 1920
    scene.render.resolution_y = 1080
    scene.render.resolution_percentage = 100
    # File format
    scene.render.image_settings.file_format = 'PNG'
    scene.render.image_settings.color_mode = 'RGBA'
    scene.render.image_settings.color_depth = '16'
    scene.render.filepath = "/tmp/render_"

Got: Render ready If err: Engine spell, res = pos ints

8. Collections
python
def organize_collections():
    """Organize objects into collections."""
    # Create collections
    col_geometry = bpy.data.collections.new("Geometry")
    col_lights = bpy.data.collections.new("Lights")
    col_cameras = bpy.data.collections.new("Cameras")
    # Link to scene
    bpy.context.scene.collection.children.link(col_geometry)
    bpy.context.scene.collection.children.link(col_lights)
    bpy.context.scene.collection.children.link(col_cameras)
    # Move objects to collections
    for obj in bpy.data.objects:
        # Unlink from main collection
        bpy.context.scene.collection.objects.unlink(obj)
        # Link to appropriate collection
        if obj.type == 'MESH':
            col_geometry.objects.link(obj)
        elif obj.type == 'LIGHT':
            col_lights.objects.link(obj)
        elif obj.type == 'CAMERA':
            col_cameras.objects.link(obj)

Got: Named collections If err: Check exists before create, handle orphans

Check

  • [ ] Script runs no err in BG mode
  • [ ] Objects in outliner
  • [ ] Mat colors + props in shader editor
  • [ ] Camera frames objects
  • [ ] Lights adequate (test render)
  • [ ] World env loads
  • [ ] Render settings fit out reqs
  • [ ] Collections logical
  • [ ] No orphan data blocks
  • [ ] clear_scene() for repro

Traps

  1. Name conflicts: Unique names, check existing
  2. Color fmt: Tuples (r,g,b,a) [0,1]
  3. Missing alpha: (r, g, b, 1.0)
  4. Node conn err: Verify I/O before link
  5. Camera not active: bpy.context.scene.camera = camera_object
  6. Rel vs abs paths: Use abs / Path() cross-platform
  7. Units: Blender=meters, lens=mm
  8. Rot fmt: math.radians() for deg→rad
  9. Engine diff: EEVEE vs Cycles features
  10. Mem leak: Clear orphans in batch

→

  • [script-blender-automation](../script-blender-automation/SKILL.md): Procedural + batch
  • [render-blender-output](../render-blender-output/SKILL.md): Render pipeline + exec
  • [create-2d-composition](../../visualization/create-2d-composition/SKILL.md): 2D variant

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
21
Repository forks
2
7-day trend score
15

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/pjt222/agent-almanac/create-3d-scene/badge)](https://verified-skill.com/skills/pjt222/agent-almanac/create-3d-scene)

Something wrong with this skill or its page? Tell us.