blender-agents-code-validator

Validate Blender Python code for version compatibility and runtime safety.

30|4|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Impertio-Studio/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package --skill blender-agents-code-validator-impertio-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-agents-code-validator
Source: https://github.com/Impertio-Studio/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package/tree/main/skills/blender/agents/blender-agents-code-validator
Command: npx skills add https://github.com/Impertio-Studio/Blender-Bonsai-ifcOpenshell-Sverchok-Claude-Skill-Package --skill blender-agents-code-validator-impertio-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents Blender Python scripts and addons from failing in production by systematically detecting crashes, API breakage across Blender versions, unsafe context usage, and common addon/registration mistakes before you run them.

Core Features & Use Cases

  • Version-aware validation: Flags missing target Blender version, removed APIs, and version-incorrect patterns (e.g., override behavior, EEVEE identifiers).
  • Context and operator safety checks: Detects restricted-context mutations (UI draw callbacks, handlers, timers, threads) and operator misuse without required prerequisites (poll()/context assumptions).
  • Data and lifecycle correctness: Finds stale bpy.data references, missing object-to-collection linking, unsafe BMesh lifecycle issues, and missing mesh.update() after from_pydata().
  • Addon structure compliance: Verifies registration order, handler @persistent usage, cleanup in unregister(), and dynamic EnumProperty caching to avoid intermittent crashes.

Quick Start

Activate the blender-agents-code-validator to audit your Blender Python code for context safety, version compatibility, threading violations, and addon registration issues.

Frequently Asked Questions about blender-agents-code-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Blender addon code for version compatibility between 3.x, 4.x, and 5.x?

To check Blender addon version compatibility, validate your Python code for missing target versions, removed APIs, and version-incorrect patterns like override behavior and EEVEE identifiers. This prevents version-dependent failures across Blender releases before runtime.

Why does my Blender Python script crash with a context error during UI draw callbacks?

Blender Python scripts crash with context errors when performing restricted-context mutations during UI draw callbacks, handlers, timers, or threads. Validating code detects unsafe operator misuse and missing poll() context assumptions causing these failures.

How do I validate BMesh lifecycle and mesh update logic in Blender Python scripts?

Validate BMesh lifecycle and mesh update logic by checking for missing mesh.update() calls after from_pydata(), unsafe BMesh operations, and stale bpy.data references. This ensures correct data lifecycle management and prevents script crashes.

What causes Blender addon registration issues and handler crashes during unregister?

Blender addon registration issues and handler crashes occur due to incorrect registration order, improper @persistent handler usage, and missing cleanup in unregister(). Validating addon structure compliance verifies registration best practices to avoid crashes.

Can I use automated code review to diagnose Blender threading violations and stale references?

You can use automated Blender Python code review to diagnose threading violations and stale references. The validation process systematically detects unsafe threading patterns and stale bpy.data references to prevent production runtime crashes.