Agent skill

Nodetool 3D Scene

by nodetool-ai in nodetool-ai/nodetool

Build, edit, validate or render a NodeTool 3D model: glTF objects, transforms, lights, materials, and headless Blender renders.

AGPL-3.0Auto-check passedGame Development

Install Nodetool 3D Scene

skills CLI
$ npx skills add nodetool-ai/nodetool --skill nodetool-3d-scene -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nodetool-ai/nodetool nodetool-3d-scene --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/system-skills/nodetool-3d-scene .claude/skills/nodetool-3d-scene && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nodetool-3d-scene
GitHub stars
560
Token cost
~1.1k tokens
SKILL.md length
621 words
Files
1
Skills in repo
127
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Build, edit, validate or render a NodeTool 3D model: glTF objects, transforms, lights, materials, and headless Blender renders.

  • Works in 5 steps: Find it. list_model3ds returns asset id,… → Read it. get_model3d {model_id} lists… → Edit. edit_model3d {model_id, ops:… → …
  • Tasks that involve 3D graphics and WebGL
  • SKILL.md covers The loop, edit_model3d ops, No camera headlessly and What validate_model3d catches, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Nodetool 3D Scene is an agent skill from nodetool-ai/nodetool. Build, edit, validate or render a NodeTool 3D model: glTF objects, transforms, lights, materials, and headless Blender renders.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development, covering 3D graphics and WebGL. It works with Blender. The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve 3D graphics and WebGL

Example prompts

  • “/nodetool-3d-scene”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Find it. list_model3ds returns asset id, name, content type and size.
  2. Read it. get_model3d {model_id} lists every object with its uuid, name,
  3. Edit. edit_model3d {model_id, ops: [...]}. Operations run in order.
  4. Validate. validate_model3d {model_id | document}.
  5. Render, when a picture is asked for. render_model3d goes through

What it can do on your machine

Read from SKILL.md and the folder at commit 339f069. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nodetool 3D Scene loads about 1.1k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 621 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nodetool-ai/nodetool at commit 339f069, republished under its AGPL-3.0 licence (© nodetool-ai). 621 words, ~1,091 tokens.

Download SKILL.mdSave it as .claude/skills/nodetool-3d-scene/SKILL.md (or your agent's skills folder).
name
nodetool-3d-scene
description
Build, edit, validate or render a NodeTool 3D model: glTF objects, transforms, lights, materials, and headless Blender renders.
featured
true

Work a NodeTool 3D model

A 3D model is a .glb or .gltf asset, addressed by its asset id. The capabilities edit the stored glTF in place and save it back over the same asset, so the id stays valid and an open editor reloads it.

For a 2D game, use native-game. The built-in game engine will add 3D scene support later. For a 3D clip inside a cut, build the model here and place it on a timeline.

The loop

  1. Find it. list_model3ds returns asset id, name, content type and size. Nothing to start from: create_model3d {name, ops?} makes an empty glTF scene and can apply the whole scene in the same call.
  2. Read it. get_model3d {model_id} lists every object with its uuid, name, type, visibility, transform and material color, plus the scene's world-space bounds. Call this before editing, for the uuids.
  3. Edit. edit_model3d {model_id, ops: [...]}. Operations run in order. Anything they do not name — meshes, textures, skins, animations — is kept, so an imported model survives an edit.
  4. Validate. validate_model3d {model_id | document}.
  5. Render, when a picture is asked for. render_model3d goes through headless Blender (EEVEE or Cycles), honors scene cameras and lights, and stores a PNG asset. It needs Blender on the server.

edit_model3d ops

OpFields
add_objectkind: box, sphere, plane, cylinder, torus, directionalLight, pointLight. Optional name
delete_objecttarget
set_transformposition, rotation (Euler degrees), scale, each [x, y, z]
set_visibilityvisible
rename_objecttarget, name
set_material_colorcolor as a CSS hex string, meshes only
select_objecttarget, or null to clear

target is a uuid or a name. Object ids are stamped into node.extras.nodetool_id, because glTF addresses nodes by array index and a delete renumbers them. Duplicate names make addressing ambiguous, which validate_model3d warns about.

delete_object keeps the file valid: an animation left with no channels is removed, and so is a skin that lost a joint, which leaves its mesh in the bind pose. set_material_color recolors only the named object, copying a material or mesh it shares with another object first.

These are the ui_3d_* verbs with no editor open. The operations, the units and the addressing live in @nodetool-ai/model3d, shared with the browser editor, so a model built headlessly opens there unchanged.

Show full SKILL.md (252 more words)Show less

No camera headlessly

ui_3d_frame_scene and ui_3d_capture_view need a WebGL context. Without one, get_model3d's world-space bounds are what answer "how big is this and where is it". Use render_model3d when an actual picture is required.

What validate_model3d catches

The glTF version, references that resolve to nothing (node, mesh, accessor, material, buffer, skin, camera, skin joint, animation target and sampler), a node with two parents, a cycle in the node hierarchy, a node carrying both a matrix and TRS fields, an accessor with an unknown type or reading past its buffer view, a buffer view reading past its buffer, an undeclared light, and an extension this build cannot honor. It warns on an empty scene, geometry with no light, and duplicate names. It only reads the document, and it handles hierarchies of any depth.

On a timeline

A model3d layer is the one kind preview_timeline_frame cannot draw on its own canvas. The preview pass collects every 3D layer across the requested instants, groups them by glTF plus the options that fix a renderer, and hands each group to one headless Chromium page. Two fields on the layer's report say what the pixels do not: camera (the pose it was drawn with, authored camera folded with the animated channels) and animation_time_sec (the glTF animation's own clock, not timeline time). With no Chrome on the host the group is left out and reported as a model3d_unavailable degradation.

Reference

In a NodeTool checkout, these repository sources go further:

  • docs/harnesses.md § 3D scene tools
  • docs/harnesses.md § 3D clips in preview_timeline_frame

© nodetool-ai, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/system-skills/nodetool-3d-scene of nodetool-ai/nodetool.

Open the folder on GitHubat commit 339f069

Compare with similar skills

Nodetool 3D Scene next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nodetool 3D Scene compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nodetool 3D Scene this skillnodetool-ai/nodetool560—~1.1kAutomated safety check: PassAGPL-3.0
Threejs World Generationcalesthio/OpenMontage66k—~2kAutomated safety check: PassAGPL-3.0
3Dviz Pro Max Scene Builderviettranx/3dviz-pro-max709—~2.8kAutomated safety check: PassMIT
Asset Pipelinerehan-remade/universal-modder6.1k—~2kAutomated safety check: PassMIT
Blender Image To 3Dmajidmanzarpour/blender-game-skills135—~5.7kAutomated safety check: PassMIT
Text To 3D AssetLaurentiuGabriel/unreal-game-assets-creation-skill148—~2.1kAutomated safety check: PassNone

Similar skills

  • Threejs World Generation

    calesthio/OpenMontage

    Build deterministic, editable, free-viewpoint Three.js worlds from text or structured briefs.

    66k GitHub stars~2k tokensUpdated 7 days ago
    Game DevelopmentAuto-check passed
  • 3Dviz Pro Max Scene Builder

    viettranx/3dviz-pro-max

    Guides building an expressive 3D scene in Three.js or Blender by reasoning through intent, object construction and scientific grounding before using a catalog of recipes and kits.

    709 GitHub stars~2.8k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed
  • Asset Pipeline

    rehan-remade/universal-modder

    Turn generated or hand-made art into exactly what a game engine loads.

    6.1k GitHub stars~2k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Blender Image To 3D

    majidmanzarpour/blender-game-skills

    Build a game-ready 3D asset in Blender from reference images (concept art, photos, turnarounds, sketches, screenshots) for any category, including characters, creatures, architecture, vehicles…

    135 GitHub stars~5.7k tokensUpdated 17 days ago
    Game DevelopmentAuto-check passed
  • Text To 3D Asset

    LaurentiuGabriel/unreal-game-assets-creation-skill

    Generate a game-ready 3D asset by running the local AI pipeline sequentially: Fooocus (SDXL text-to-image) - Hunyuan3D-2 (image-to-textured-GLB) - optional Blender FBX convert + Unreal import.

    148 GitHub stars~2.1k tokensUpdated 2 mo ago
    Game DevelopmentAuto-check passed
  • Turns a finished CraftBot building model into cut lists, stick orders and full-scale printable sheets for building a physical scale model by hand.

    154 GitHub stars~2.8k tokensUpdated 10 days ago
    Game DevelopmentAuto-check passed

More from nodetool-ai/nodetool

All 127 skills in this repo
  • Beat Sync Editing

    nodetool-ai/nodetool

    Cut a NodeTool timeline to music and shape its pacing — detect the beat grid, place cuts on phrases, pick a cut type, build speed ramps with time remap, and give the piece an arc.

    560 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Caption Titles

    nodetool-ai/nodetool

    Add and animate a consistent text layer on an existing NodeTool timeline.

    560 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Color Motion

    nodetool-ai/nodetool

    Choose and animate colour on a NodeTool timeline, including shape and text gradients, colour grades, 3D LUTs, and dither.

    560 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Commercial Beat Sheet

    nodetool-ai/nodetool

    Write a shootable, precisely timed commercial beat sheet and store it as a NodeTool storyboard, with a consistent entity roster behind every shot.

    560 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Elevenlabs Audio Prompting

    nodetool-ai/nodetool

    Direct ElevenLabs speech, dialogue, sound effects and music — the bracketed audio tags v3 acts on and why the voice decides whether a tag lands, stability as the delivery dial, punctuation instead…

    560 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Frame Composition

    nodetool-ai/nodetool

    Stage the frame on a NodeTool timeline — grids, focal placement, safe areas per aspect ratio, depth layers and parallax, camera moves, and where elements enter and leave.

    560 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Nodetool 3D Scene

What does Nodetool 3D Scene do?

Build, edit, validate or render a NodeTool 3D model: glTF objects, transforms, lights, materials, and headless Blender renders. Nodetool 3D Scene is an agent skill from nodetool-ai/nodetool. Build, edit, validate or render a NodeTool 3D model: glTF objects, transforms, lights, materials, and headless Blender renders.

When should I use Nodetool 3D Scene?

Nodetool 3D Scene fits situations like: tasks that involve 3D graphics and WebGL.

How do I install Nodetool 3D Scene in Claude Code?

Run `npx skills add nodetool-ai/nodetool --skill nodetool-3d-scene -a claude-code`. Or copy the skill folder (packages/system-skills/nodetool-3d-scene in nodetool-ai/nodetool) into .claude/skills/nodetool-3d-scene in your project. Claude Code loads it when a task matches its description.

How do I install Nodetool 3D Scene in Codex?

Run `npx skills add nodetool-ai/nodetool --skill nodetool-3d-scene -a codex`. Or copy the skill folder (packages/system-skills/nodetool-3d-scene in nodetool-ai/nodetool) into .agents/skills/nodetool-3d-scene in your project. Codex loads it when a task matches its description.

Can I use Nodetool 3D Scene in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nodetool-ai/nodetool --skill nodetool-3d-scene -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nodetool-3d-scene, .gemini/skills/nodetool-3d-scene, .github/skills/nodetool-3d-scene and .opencode/skills/nodetool-3d-scene in your project.

What does Nodetool 3D Scene need to run?

SKILL.md names no scripts, command-line tools or credentials: Nodetool 3D Scene is instructions for the agent only.

Does Nodetool 3D Scene access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nodetool 3D Scene safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nodetool 3D Scene use?

Nodetool 3D Scene is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nodetool 3D Scene use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nodetool 3D Scene?

Skills that share tags, products or a category with Nodetool 3D Scene: Threejs World Generation (calesthio/OpenMontage, 66k stars), 3Dviz Pro Max Scene Builder (viettranx/3dviz-pro-max, 709 stars), Asset Pipeline (rehan-remade/universal-modder, 6.1k stars) and Blender Image To 3D (majidmanzarpour/blender-game-skills, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nodetool 3D Scene?

nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 560 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on October 10, 2026.

Source: nodetool-ai/nodetool on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.