blendersql

Connect to a Blender .blend file over SQL and bootstrap a session. Use when starting work, choosing CLI vs HTTP vs the in-Blender add-on, or routing to a domain skill.

The 5.1 layered Action tree (actions → slots/layers/strips/channelbags → fcurves → keyframes), animation_data, and drivers. Use to inspect or edit keyframes, fcurves, and drivers.

The 'everything else' grab-bag — images, sounds, clips, fonts, curves, lights, cameras, armatures/bones, shape keys, vertex groups, palettes, worlds, brushes, masks, text font-curves, custom properties. Use to inspect or edit these datablocks.

Grease Pencil v3: datablocks → layer groups → layers → frames → drawings → strokes → points. Use to inspect GP, edit layer properties, delete strokes, or build new layers/frames/strokes.

Materials, GP material settings, and the unified node-tree model (node_trees/nodes/node_inputs/node_outputs/node_links/node_tree_interface). Use to inspect or edit shaders, recolor BSDFs, or build node graphs.

Meshes and their geometry — the 5.x attribute system, vertices/edges/polygons/loops/uvs. Use to inspect mesh topology or attributes. Mostly read; these are the heaviest tables on big files.

Object modifiers and constraints. Use to inspect, add, edit, or delete modifiers/constraints; query type-specific fields via params_json.

Scenes, collections, objects, the parent/child hierarchy, transforms. Use to inspect or edit objects — move/rotate/scale/parent/rename, add EMPTYs, delete objects.

The Video Sequence Editor — vse_strips plus the per-type side tables (sound/movie/image/scene/text/color). Use to inspect a sequencer timeline or add strips.

Complete catalog of BlenderSQL's SQL functions — signatures, arguments, return shape, and an example for each. The reference skill; use for signature lookup.

The escape hatches — bpy_eval (eval an expression → JSON), bpy_exec (run code → {stdout,result,error}), bpy_op (run any bpy.ops.* operator), and the session_log audit table. Use when the vtables and typed verbs don't cover what you need.

Triage and audit a .blend file — orientation, most-referenced and orphaned datablocks, heaviest meshes/GP, name search, cross-file comparison. The 'where do I start' skill.