Skip to content
Back to search

blender-agent-skills

Build game-ready 3D assets and architectural scenes in Blender with Codex, Claude Code, Gemini CLI, or Antigravity. Install with npx skills add.

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/vietlinhh02--blender-agent-skills/badge.svg)](/listings/vietlinhh02--blender-agent-skills)

HTML

<a href="/listings/vietlinhh02--blender-agent-skills"><img src="/api/listings/vietlinhh02--blender-agent-skills/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.

From your project folder, run this and choose the skills and agent you want. The installer pulls the skills directly from this GitHub repo.

npx skills add vietlinhh02/blender-agent-skills

Install all three skills for **Antigravity CLI (AGY)** in one step:

npx skills add vietlinhh02/blender-agent-skills --skill "*" --agent antigravity-cli -y

Use **Node.js 22.20 or later** for the installer. Open a new agent session in your project after installing. To build a scene, give your agent access to Blender through the shell or a compatible Blender integration.

<details> <summary>Install a single skill, target another agent, or install manually</summary>

npx skills add vietlinhh02/blender-agent-skills --list
npx skills add vietlinhh02/blender-agent-skills --skill blender-game-assets --agent codex

Use `claude-code`, `gemini-cli`, or `antigravity-cli` in place of `codex` to choose another client. Add `-g` to install for your user across projects. Install all three if you want the architecture workflow and prompt builder to find their sibling skills.

For manual installation, copy your selections from [skills/](skills/) into `.agents/skills/` for AGY, Codex, or Gemini CLI, or `.claude/skills/` for Claude Code. Keep each skill's folder and resources together.

[Installer documentation](https://github.com/vercel-labs/skills)

</details>

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.

README.md · README · 216 lines
  1. <p align="center">
  2. <img src="docs/images/blender-agent-skills-logo.svg" width="92" height="92" alt="Blender Agent Skills logo, a layered isometric cube">
  3. </p>
  4. # Blender Agent Skills
  5. Build game assets and architectural scenes in Blender with your AI agent.
  6. [**Install**](#install-in-a-project) · [**Previews**](#previews) · [**Copy a prompt**](#copy-ready-prompts) · [**Original bus prompt**](#original-bus-prompt) · [**Bus case study**](docs/case-studies/sugi-no-eki/README.md)
  7. ## Install in a project
  8. From your project folder, run this and choose the skills and agent you want. The installer pulls the skills directly from this GitHub repo.
  9. ```sh
  10. npx skills add vietlinhh02/blender-agent-skills
  11. ```
  12. Install all three skills for **Antigravity CLI (AGY)** in one step:
  13. ```sh
  14. npx skills add vietlinhh02/blender-agent-skills --skill "*" --agent antigravity-cli -y
  15. ```
  16. Use **Node.js 22.20 or later** for the installer. Open a new agent session in your project after installing. To build a scene, give your agent access to Blender through the shell or a compatible Blender integration.
  17. <details>
  18. <summary>Install a single skill, target another agent, or install manually</summary>
  19. ```sh
  20. npx skills add vietlinhh02/blender-agent-skills --list
  21. npx skills add vietlinhh02/blender-agent-skills --skill blender-game-assets --agent codex
  22. ```
  23. Use `claude-code`, `gemini-cli`, or `antigravity-cli` in place of `codex` to choose another client. Add `-g` to install for your user across projects. Install all three if you want the architecture workflow and prompt builder to find their sibling skills.
  24. For manual installation, copy your selections from [skills/](skills/) into `.agents/skills/` for AGY, Codex, or Gemini CLI, or `.claude/skills/` for Claude Code. Keep each skill's folder and resources together.
  25. [Installer documentation](https://github.com/vercel-labs/skills)
  26. </details>
  27. ## Previews
  28. ### Stylized game workshop
  29. <img src="docs/images/skill-preview.png" alt="Stylized workshop, utility truck, and robot in Blender" width="520">
  30. Built with Codex following the game asset skill.
  31. ### Sugi no Eki bus terminal
  32. | Exterior | Station interior |
  33. | :--- | :--- |
  34. | [![Green and cream bus in front of the terminal](docs/case-studies/sugi-no-eki/images/bus-hero.webp)](docs/case-studies/sugi-no-eki/images/bus-hero.webp) | [![Timber station interior with warm window light](docs/case-studies/sugi-no-eki/images/bus-interior.webp)](docs/case-studies/sugi-no-eki/images/bus-interior.webp) |
  35. | Aerial view | Eye-level view |
  36. | :--- | :--- |
  37. | [![Aerial view of the terminal, cedar trees, and road](docs/case-studies/sugi-no-eki/images/bus-aerial.webp)](docs/case-studies/sugi-no-eki/images/bus-aerial.webp) | [![Eye-level view of the bus at the station entrance](docs/case-studies/sugi-no-eki/images/bus-front.webp)](docs/case-studies/sugi-no-eki/images/bus-front.webp) |
  38. | Bus detail | Section A-A |
  39. | :--- | :--- |
  40. | [![Close-up on the bus grille, headlights, and bumper](docs/case-studies/sugi-no-eki/images/bus-detail.webp)](docs/case-studies/sugi-no-eki/images/bus-detail.webp) | [![Sectional cutaway through the bus terminal](docs/case-studies/sugi-no-eki/images/bus-cutaway.webp)](docs/case-studies/sugi-no-eki/images/bus-cutaway.webp) |
  41. **12-second bus animation**
  42. https://github.com/user-attachments/assets/71eddd3d-d921-4d5f-a772-aa949c4d3848
  43. [Download the original MP4](https://github.com/vietlinhh02/blender-agent-skills/releases/download/bus-case-study/sugi-no-eki-bus-stunt-12s.mp4) · [See the case study and token trace](docs/case-studies/sugi-no-eki/README.md)
  44. ## Pick a workflow
  45. | Skill | Use it for |
  46. | :--- | :--- |
  47. | [**Blender Game Assets**](skills/blender-game-assets/SKILL.md) | Props, vehicles, rigged characters, creatures, and modular levels. Defaults to one agent, one small preview, and editable `.blend` plus engine export. |
  48. | [**Architectural Environment Production**](skills/architectural-environment-production/SKILL.md) | Metric site plans, CAD/BIM or an orthographic fallback, six camera views, a cutaway, and a before/after sheet. |
  49. | [**Blender Technical Prompt Builder**](skills/architectural-prompt-builder/SKILL.md) | Expand Blender ideas into technical prompts for game assets, creatures, vehicles, levels, and architectural scenes. The existing install name is architectural-prompt-builder. |
  50. The architecture studio workflow was written for AGY and uses Blender MCP, image generation, and subagents. On another client, use equivalent tools when available.
  51. A short request such as `Build a little repair rover for my exploration game` starts with a brief. The agent fills in scale, camera view, moving parts, and export checks, states assumptions, and builds. Ask for `brief only` or `prompt only` when you want to review or reuse the plan first. The technical prompt builder also gives existing prompts clearer art direction and checks. See the [expanded rover example](skills/architectural-prompt-builder/references/rover-example.md).
  52. ## Copy-ready prompts
  53. Copy a block into a session with its matching skill. Each example includes a concrete asset and deliverable so you can change the brief and reuse the rest.
  54. ### Utility rover
  55. ```text
  56. Use blender-game-assets to build a stylized four-wheel maintenance rover for a top-down
  57. exploration game. Keep the chassis, four wheels, two front steering pivots, and rear hatch
  58. separate. Place pivots on the axles and on the hatch hinge. Add hatch_open and hatch_close
  59. clips, then check the pivots and clip playback after exporting to .glb. Save the .blend
  60. and provide one preview from the game camera. Leave driving behavior to the engine.
  61. ```
  62. ### Modular ruin kit
  63. ```text
  64. Use blender-game-assets in blockout mode. Build a reusable ruin kit with one straight
  65. wall, corner, doorway, floor tile, stair, and column. Snap everything to a 2 m grid and
  66. use consistent origins. Assemble a small playable room in another collection to verify
  67. the seams, doorway clearance, and stairs. Save the .blend with separate module and demo
  68. collections and include one solid-view preview. Use flat colors for this pass.
  69. ```
  70. <details>
  71. <summary>Five more prompts for props, characters, creatures, and architecture</summary>
  72. ### Compact prop
  73. ```text
  74. Use blender-game-assets to create a low-poly field radio for an isometric adventure game.
  75. Give it a clear silhouette, a hinged battery cover, and a rubber antenna. Keep the body
  76. under 1,500 triangles, use up to three material slots, and place the origin at the center
  77. of its base. Keep the cover separate with its pivot on the hinge. Export one .blend and
  78. one .glb, check that the cover can open without clipping, and show one gameplay-angle preview.
  79. ```
  80. ### Service robot
  81. ```text
  82. Use blender-game-assets to create a knee-high stylized service robot with broad feet,
  83. elbow joints, and a readable face. Use an armature with named bones and rigid weights
  84. for the hard parts. Add loopable idle and walk clips plus a short wave. Check the poses
  85. from the gameplay angle and re-import the .glb to verify the three clips. Deliver the
  86. editable .blend, the .glb, and one preview.
  87. ```
  88. ### Cave beetle
  89. ```text
  90. Use blender-game-assets to create an original, low-poly cave beetle companion for an
  91. isometric game. Use six articulated legs, a rounded shell, and a bright marking that reads
  92. against dark terrain. Rig the legs and flexible antennae. Make two 24 fps clips, idle and
  93. scuttle, with clean loops and stable foot contact. Export .blend and .glb and provide one
  94. preview from the gameplay camera.
  95. ```
  96. ### Courtyard conservatory
  97. ```text
  98. Use architectural-environment-production and its full studio workflow to reconstruct a
  99. botanical conservatory in Blender at 1 BU = 1 m. Include a glass entry vestibule, a 10 m by
  100. 16 m greenhouse, and a planted courtyard. Lock the structural grid, path widths, and roof
  101. datums before massing. Use the skill's CAD/BIM pipeline or orthographic fallback, set
  102. light direction for late-afternoon sun, and show the relationship between structural bays
  103. and the glazing in Section A-A. Deliver the packed .blend, six camera views, and a
  104. before/after progression sheet.
  105. ```
  106. ### Lighthouse brief
  107. ```text
  108. Use architectural-prompt-builder to write a copy-ready master prompt for a compact
  109. coastal lighthouse scene with a keeper's cottage, an exterior stair, and a rocky landing.
  110. Use wet stone, white limewash, and an overcast blue-hour palette. Specify the zones and
  111. camera priorities. Keep the output to the master prompt, ready to paste into
  112. architectural-environment-production.
  113. ```
  114. </details>
  115. ### Original bus prompt
  116. This is the complete prompt used for the Sugi no Eki project. If you installed from this repo, replace `architectural_environment_production` with `architectural-environment-production` after copying. The full workflow uses four specialists and a shared Blender session.
  117. ```text
  118. Build a complete multi-zone 3D architectural reconstruction of bus model in Blender
  119. using the `architectural_environment_production` skill (OpenBIM + CAD Hybrid pipeline + Mandatory Studio Polish).
  120. Create a working folder `./arch_build_[slug]/` and follow all 6 stages strictly in metric scale (1 BU = 1m):
  121. 0. **Stage 00 & 01 (OpenBIM + CAD Hybrid Blueprints & 1:1 BMesh Compilation)**:
  122. - Author `00_blueprints/spec.json` locking exact zone coordinates, real-world dimensions, structural grid, and Z-datum elevations.
  123. - Compile single-source-of-truth structural solids (`Manifold3D` + `IfcOpenShell` `.ifc` + `ezdxf` 4-panel ANSI31 section-hatched CAD blueprint `.dxf`/`.svg`/`.png` if installed, or pure Blender
  124. orthographic 4-panel fallback) and build 1:1 into organized Blender collections with `bmesh.ops.bisect_plane` horizontal Z-datum imprinting and `UVMap_Metric_1m` box projection.
  125. - Inspect solid massing and grounding (`get_scene_info` + `look`) before moving on.
  126. 1. **Stage 02 (4-Tile Photorealistic Reference Contact Sheet & 5-Channel PBR Datums)**:
  127. - Generate a `16:9` 2x2 4-tile photorealistic reference contact sheet (`01_references/reference_contact_sheet_2x2.png`) matching the blueprint from 4 angles: (TL) Hero 3/4 exterior, (TR) Aerial site
  128. overview, (BL) Eye-level threshold/detail, (BR) Atmospheric courtyard/interior.
  129. - Inspect the contact sheet to lock proportions, silhouettes, lighting mood ([golden hour late afternoon sunlight filtering through cedar foliage]), and source 5-channel PBR textures mapped to
  130. `UVMap_Metric_1m`.
  131. 2. **Stage 03 (4-Subagent Specialist Gauntlet Loop)**:
  132. - Spawn 4 parallel specialist subagents (`Model="inherit"`, one per reference domain: 1. Primary Architecture & Joinery, 2. Site Terrain & Hardscape, 3. Threshold Details, Props & Foliage, 4.
  133. LookDev, Studio Polish, Lighting & Cameras).
  134. - Each specialist must write an independent, idempotent zone Python script (`03_scripts/zone_01..04.py`) without calling `execute_blender_code` concurrently; the Master Orchestrator executes scripts
  135. sequentially in Blender and saves checkpoints.
  136. 3. **Stage 04 (Adversarial Visual Critique Loop)**:
  137. - Capture "Before" baseline renders first (`04_renders/before_*.png`).
  138. - Run iterative critique passes comparing live Blender renders against `01_references/reference_contact_sheet_2x2.png`, fixing proportion, recessed opening depth, scale, grounding, and material
  139. contrast until reaching >= 8.5/10.
  140. 4. **Mandatory Studio Polish (All 5 Blender-Native Visual Strengths)**:
  141. - Execute all 5 imperfection layers: (1) `Light_Gobo_Canopy` overhead dappled cutout + `light.use_nodes = True` procedural Emission noise (`Scale = 6.0`) on Area/Spot lights; (2) Roughness stacking
  142. (`ShaderNodeMix` `LINEAR_LIGHT`, `Factor = 0.28`) + `Pointiness` edge-wear & `AmbientOcclusion` crevice dirt; (3) Full-Frame 35mm physical cameras with DoF (`f/1.8?f/2.8`) & Focus Empties; (4)
  143. Micro-bevels + `ObjectInfo.Random` per-instance macro-variation; (5) Bounded `VolumeScatter` haze, `AgX` color management, and subtle Compositor `FOG_GLOW` + lens dispersion.
  144. 5. **Stage 05 (6-Camera Cycles Showcase, World-Space BMesh Section A-A Cutaway & Progression Matrix)**:
  145. - Render 6 physical cameras (`Cam_01_Hero_3Q` through `Cam_06_Section_AA_Cutaway`) in Cycles, including a non-destructive world-space `bmesh.ops.bisect_plane` Section A-A cutaway with capped ANSI31
  146. 45-degree hatched cut faces.
  147. - Stitch `05_deliverables/progression_matrix.png` (Before vs. After) and `05_deliverables/showcase_6cam_sheet.png`, visually verify both sheets, and save the final `.blend`.
  148. ```
  149. [Bus prompt on its own page](docs/prompts/sugi-no-eki-original.md) ? [All prompts on their own page](docs/prompts/README.md)
  150. ---
  151. Created by **[vietlinhh02](https://github.com/vietlinhh02)** ? [Preview watermark](skills/blender-game-assets/scripts/watermark_preview.py) ? [AGY trace helper](skills/blender-game-assets/references/agy-trace.md)
  152. ## License
  153. The skills and project documentation are licensed under the [Apache License 2.0](LICENSE). Copyright 2026 vietlinhh02.

Ratings and comments

Sign in to rate this skill.

Sign in

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