Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Nauka i wyjaśnianie

blender

/blender

Praktyczna wiedza o Blenderze: modelowanie postaci, SubD, booleany, rzeźbienie, materiały, malowanie tekstur, animacja z kształtów i rigi z rozciąganiem.

Repozytorium
blendpro-mcp ↗
Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

85/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność17 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena13 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
20
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Praktyczna wiedza o Blenderze: modelowanie postaci, SubD, booleany, rzeźbienie, materiały, malowanie tekstur, animacja z kształtów i rigi z rozciąganiem.

Oryginalny opis (EN)

Practical Blender know-how — modeling (character blockouts, SubD, shrinkwrap, eye/beak tricks), boolean cleanup and quad retopology of boolean seams, sculpting (voxel remesh, brushes, masking, face sets, sculpt vertex paint), materials and texture painting, Thin Wall transparency, modeling from reference images (measure, overlay, silhouette scoring), cute 2D face expressions with blinks, squash & stretch rigs (Stretch To, Bendy Bones), step-by-step project walkthroughs (car from blueprints, jet with guide-mesh panels, realistic donut, procedural sushi, cloth sofa, plus quick props: flower, flo

Jak działa

  1. Rule: always model from reference
  2. Reference index
  3. How to answer
  4. Driving Blender: BlendPro MCP (preferred)
  5. Running Blender from Claude Code without the MCP (bpy)
  6. Extending this skill
Sekcje z nagłówków SKILL.md, w oryginale · 174 linii, 2 315 słów
Podgląd SKILL.md
---
name: blender
description: Practical Blender know-how — modeling (character blockouts, SubD, shrinkwrap, eye/beak tricks), boolean cleanup and quad retopology of boolean seams, sculpting (voxel remesh, brushes, masking, face sets, sculpt vertex paint), materials and texture painting, Thin Wall transparency, modeling from reference images (measure, overlay, silhouette scoring), cute 2D face expressions with blinks, squash & stretch rigs (Stretch To, Bendy Bones), step-by-step project walkthroughs (car from blueprints, jet with guide-mesh panels, realistic donut, procedural sushi, cloth sofa, plus quick props: flower, flower pot, fur/hair, gift box, puffy chair, roof tiles, vase, tennis ball), Geometry Nodes (stylized fur/feathers, custom normals, instance animation), stylized Eevee rendering, free add-on recommendations, and running Blender headlessly with Python (bpy). Use whenever the user asks how to do something in Blender, wants a Blender workflow, node setup, modifier stack, render settings, or add-on suggestion, or wants a bpy script written or run — even if they only mention a .blend file, Eevee, Cycles, Geometry Nodes, or "3D model" without naming Blender.
---

# Blender

Curated, workflow-level Blender knowledge. Read only the reference file(s) that match the question — each is short and self-contained.

## Rule: always model from reference

Before modeling **any** object (prop, food, vehicle, character, furniture), generate separate orthographic reference images:
- **Always:** front, left, right, top and bottom.
- **Add back** when the front and back differ (cars, characters, chairs).

Generate one image per view, never a combined sheet. Use GPT image generation through Codex CLI, piping the prompt on stdin. Pass the first finished view with `-i` so every view shows the same object. If image generation isn't available, give the user the prompts to paste into ChatGPT.

Then follow `references/modeling/reference-pipeline.md`:
1. `reference_measure` each view at real size. If the generated proportions are off, correct each axis to known real dimensions.
2. `reference_image_setup` each view as an overlay.
3. Model from the measured numbers.
4. Score every view with `reference_compare`.

Never block out from imagination alone.

## Reference index

| Topic | File | Covers |
|---|---|---|
| Character modeling | `references/modeling/character-modeling.md` | SubD blockout from a cube, Shrinkwrap + Solidify for wings/armor, "eye pancake" trick, Tangent Normal Project, cylinders instead of cones under SubD |
| Boolean cleanup | `references/modeling/boolean-cleanup.md` | Bool Tool workflow, Merge by Distance, knife retopo of boolean seams, n-gon → quads, stepping edge density down (24→12), Grid Fill, bevel weights + Bevel modifier (Weight limit, Arc miter), SubD check, Symmetrize, LoopTools Relax |
| Sculpting (beginner, stylized) | `references/sculpting/sculpting-for-beginners.md` | Tablet/navigation prefs, ortho-only reference images, apply scale before sculpting, voxel remesh (`R` / `Ctrl R`), core brushes (Grab, Clay Strips, Scrape, Draw Sharp, Pinch), masking and Face Sets, sculpt-mode vertex painting with cavity auto-masking |
| Texture painting | `references/materials/texture-painting.md` | Face-selection masking, gradient fill, non-destructive line-art layer via second Image Texture + Mix Color |
| Thin Wall transparency | `references/materials/thin-wall-transparency.md` | Principled BSDF Thin Wall for windows, leaves, bubbles, paper; replaces Solidify hacks |
| Stylized fur & feathers (Geo Nodes) | `references/geometry-nodes/stylized-fur-feathers.md` | Scatter/instance on surface, borrowing a sphere's normals via Sample Nearest Surface + Set Mesh Normal, Scene Time noise wind animation, per-instance random color attribute |
| Stylized Eevee rendering | `references/rendering/stylized-eevee.md` | Ray tracing off for toon looks, soft "fast GI" values, Fresnel/Layer Weight rim light in the shader |
| Reference-image pipeline | `references/modeling/reference-pipeline.md` | GPT-image orthographic view prompts (front/left/top, +right/back/bottom for complex objects), measure silhouette/profile/palette as text, real-size Image empties, drips/coatings/sprinkle variants with real tools, IoU scoring per view |
| Cute 2D face expressions | `references/rigging/face-expressions.md` | 50 bundled kawaii faces (happy, angry, uwu, star_eyes...), texture-atlas face decal on the head driven by one `expression` property, set by name, CONSTANT keys, auto-blink partners, GPT-image sheets → new faces in the same layout, Unity/WebXR UV offsets |
| Project: car from blueprints (Bugatti, JOYCE 3D) | `references/projects/car-modeling-bugatti.md` | Vertex-outline tracing on blueprints, inset+boundary wheel arches, knife cut-through (`Z`), panel rip/split, Mirror → weighted Bevel → SubD stack, radial spoke array, collection-instanced wheels |
| Project: hard-surface vehicle panels (Private Jet, Blender Guru) | `references/projects/private-jet-guide-mesh.md` | Real-scale blueprints, half hull + Mirror, **guide-mesh Shrinkwrap** (SubD → Shrinkwrap → Solidify → Bevel) for pinch-free panel cuts, `Y` split panels, Thin Wall glass, livery UVs, Track-To camera, Glare/lens compositing |
| Project: realistic donut (Bro 3D) | `references/projects/realistic-donut.md` | Multires + Clay Strips dough, Quick Liquid icing drips + voxel remesh, real-scale SSS, gradient/displacement dough, coat sheen, weight-painted GN sprinkles (and the procedural, sim-free alternative) |
| Project: procedural sushi (Bad Normals) | `references/projects/procedural-sushi-geonodes.md` | Volume point scatter of rice instances, XY-masked noise shaping, nori band, Mesh Boolean fillings, exposed Group Input parameters |
| Project: 1-minute cloth sofa (BlenderVitals) | `references/projects/cloth-sofa.md` | Cloth Pressure 2.0 + zero gravity to inflate cushions, apply at a frame, duplicate into a sofa, Cloth sculpt brush wrinkles, headless-safe Python steps |
| Quick projects (8 short-form props) | `references/projects/quick-projects.md` | Flower (traced petals, particle pollen), flower pot (grid-fill soil, particle leaves), fur/hair dynamics, gift box (Bezier bow, Shift R), puffy office chair (Face Sets + Cloth Filter Inflate), roof tiles (double Array), vase (Spin + Node Wrangler PBR), tennis ball (rotate-and-weld seam, fuzz) |
| Squash & stretch rig (Into Animation) | `references/rigging/squash-and-stretch.md` | root/bottom/body/top bones, Stretch To with volume preservation, Bendy Bones with Absolute handles, custom shapes, CONTROLS/DEFORM collections, **corrected Euler-order rule** (last letter = outermost), pinned base weights; `squash_stretch_rig` recipe builds it in one call |
| Essential modeling add-ons | `references/addons/essential-modeling-addons.md` | Edge Flow, Mesh Align Plus, Tissue, LoopTools, Quick Snap, Re-Primitive — with exact hotkeys/menus |
| Free add-ons mega list | `references/addons/free-addons-mega-list.md` | ~25 free add-ons grouped by CAD, procedural, assets, cables/cloth, retopo, export/utility |

When a request matches one of the project walkthroughs (car, aircraft/vehicle panels, donut, sushi, sofa, or a small prop in quick-projects: flower, pot, fur, gift box, chair, roof tiles, vase, tennis ball), read that file first and follow its order, using the BlendPro mapping table at the end. When a request spans topics, combine them, e.g. real-world prop or food: reference pipeline → modeling → materials from the measured palette → render; cute mascot: blockout → face_expression_setup → face_expression_animate (blinks) → stylized Eevee; stylized bird character: modeling → fur/feathers → texture painting → stylized Eevee; sculpted character: sculpting → (retopo) → texture painting or sculpt vertex paint → stylized Eevee; hard-surface part: boolean cleanup → bevel/SubD → materials.

## How to answer

- Give the concrete path: menu location, node names exactly as Blender labels them, hotkeys, and numeric starting values. Name nodes in `backticks` (`Sample Nearest Surface`, `Set Mesh Normal`).
- Prefer non-destructive solutions (modifiers, node layers, attributes) unless the user wants to bake/apply.
- Blender UI and node names shift between versions (e.g. Auto Smooth became a modifier in 4.1; Eevee was rebuilt in 4.2; 5.x continues to rename nodes/sockets). If the user's version matters and is unknown, ask or state the version the answer assumes. Treat version-specific claims in the references as "verify in your build" rather than guaranteed. Verified against Blender 5.2.2: Principled BSDF has a boolean `Thin Wall` input; the Shrinkwrap method is named `Target Normal Project`; `Set Mesh Normal` (Free mode) exposes a `Custom Normal` input and only works on real mesh, so put it after `Realize Instances`; LoopTools and Bool Tool are not bundled and install from Get Extensions (Bool Tool shortcuts are `Ctrl Shift Numpad -` difference / `Ctrl Shift Numpad +` union). Voxel remesh size is in scene units, so values like `0.03` assume a roughly 1–2 m object with scale applied. Since 4.3, sculpt brushes are assets picked from the asset shelf, not a fixed toolbar.
- For add-ons: note which are bundled (LoopTools is under Preferences → Get Extensions / Add-ons) vs. third-party downloads, and that availability changes — don't invent download URLs.

## Driving Blender: BlendPro MCP (preferred)

When the `blendpro` MCP tools are available, use them instead of shelling out to Blender. Source: this repository (`src/blendpro`). The add-on auto-starts on port 9877 when Blender opens. If no Blender window is open, call `blender_session(action="start_headless", blend_file=...)`.

Token-cheap loop, with images last:
1. `scene_overview` (filter or types for big scenes), then `inspect` / `node_tree_get` only for what you'll touch.
2. Edit in as few calls as possible:
   - `edit_objects` for batched simple edits (rotations are in degrees).
   - `node_tree_build` to build or patch a whole material or GN tree in one call.
   - `run_python` for everything else (assign `result`).
   - `run_operators` for `bpy.ops` that need edit mode, a selection or viewport context, including add-on operators.
3. Read the returned `diff`. Don't re-query to confirm.
4. Verify with text: `mesh_analysis` (pass `target="quest"`/`"webxr"`/`"unity"` for budgets) and `spatial_report` (floating/sunk objects, intersections, camera framing, ASCII maps).
5. Use `render_views` once to judge looks. It returns one contact sheet; keep `size` at 256–400 and pass `objects` to isolate. Use `viewport_screenshot` only to see what the user sees.
- Unsure of an operator arg, socket name or enum? Call `api_lookup` (`op:`, `node:`, `struct:`, `path:`, `enum:`, `search:`) before writing code.
- Call `checkpoint("save", name)` before destructive steps (applying modifiers or booleans, remeshing, deleting).
- Export with `export_asset` presets: `unity_fbx`, `webxr_glb` (Draco), `glb`, `obj`, `usd`.
- **Tripo3D (AI 3D generation; spends the user's Tripo API credits):**
  - Use it for organic or complex assets: characters, creatures, detailed props. Model simple or hard-surface pieces directly instead.
  - Iterate with `tripo_generate(preset="draft")`, which has no texture and is cheapest, then rerun with `standard`/`detailed`, or `xr_lowpoly`/`game_ready` for Quest/WebXR. Pin `options.model_seed` to keep a shape you like.
  - Always pass `target_size` (metres) and `location`, then check with `mesh_analysis(target=...)`.
  - Post-process with `tripo_process`:
    - `retopo` (face_limit, quad, smart_uv)
    - `rig` (`spec="unity"` or `"mixamo"`)
    - `retarget` (`animation="preset:walk"`)
    - `convert`
  - Use `tripo_task("balance")` before batch jobs.
  - If the user generates in Tripo Studio instead, the Tripo Bridge add-on pushes models into Blender (`tripo_task("bridge")` shows its state). Find them with `scene_overview`.

### Recipes: 110 tested one-call tasks

Prefer `recipes` over hand-written bpy when one fits. Each recipe is a parameterized function that was tested headless on Blender 5.2.
- Discover: `recipes(action="list", category=..., query=...)`.
- Read the parameters: `recipes(action="doc", name=...)`.
- Execute: `recipes(action="run", name=..., params={...})`. It returns the result plus the scene diff.

Categories:
- **modeling**: rounded_box, boolean_cut, pipes, arrays, lathe, text, rocks, stairs, mesh_cleanup, fix_ngons, apply_transforms, set_origin, decimate_to_tris, remesh, smooth_by_angle, UV unwrap/lightmap_uv2/checker/texel_density
- **shading**: PBR from texture folders, procedural materials, lighting rigs, HDRI/sky, camera framing/turntable, render presets, baking (AO, normal, diffuse, atlas), compositor
- **rigging**: biped and joint-position armatures, auto weights, ≤4-influence limits, IK, bone renaming for Mixamo/Unity, keyframing, procedural walk/idle, bake action, NLA, shape keys, drivers, retarget
- **faces**: face_expression_setup, face_expression_set, face_expression_animate (blinks), face_atlas_build, face_sheet_import — see `references/rigging/face-expressions.md`
- **reference**: reference_measure, reference_image_setup, reference_compare (silhouette IoU per view), reference_details (sprinkle/seed size + colour stats) — see `references/modeling/reference-pipeline.md`
- **geonodes / pipeline**: scatter, curve instancing, procedural buildings and fences, cables, stylized fur, terrain; LODs, UCX collision, batch export, naming, purge, XR budget report, texture resize, draw-call merge

Source: `blendpro-mcp/src/blendpro/addon/recipes/*.py`. Tests: `tests/test_*.py`, run with `blender --background --factory-startup --python tests/run_recipe_tests.py -- <module>`.

### Character pose understanding (MediaPipe)

`pose_analyze(objects=[character_root], view="front", rest_pose=True, create="lines")`:
- Renders an orthographic view, runs MediaPipe Pose (33 landmarks), and returns an overlay image with the skeleton drawn. Subject's left is blue, right is orange.
- Lifts each joint into 3D at the middle of the limb (ray entry and exit through the mesh). It also derives pelvis, spine, chest, neck and head_top.
- Draws an orange skeleton in the viewport, in front of the mesh (`MP_Pose` collection).
- Returns metrics: elbow and knee angles, arm elevation (T-pose or A-pose), limb lengths and L/R asymmetry, spine lean, facing direction and ankle heights.
- Use `rest_pose=True` for rigging. Detection is much better on T/A poses than on twisted action frames.
- `frames=[...]` checks an animation frame by frame (knee and elbow angles, ankle heights for foot contact) without images.
- Feed `joints` to the rigging recipe `armature_from_joint_positions` to build a starter armature.
- Limits:
  - MediaPipe needs a face-like head (a faceless or logo head fails) and a roughly humanoid figure facing the view. The character should face −Y.
  - When MediaPipe mirrors left and right, the labels are corrected automatically for front and back views.
  - Joints outside the silhouette are marked `estimated`.

### Blender internals

Read `references/internals/blender-architecture.md` when debugging stale or evaluated data, operator context failures, node sockets, layered actions, or 5.x API changes. It covers DNA/RNA, the depsgraph and evaluated copies, mesh attributes and bmesh, operators and poll, Geometry Nodes fields and instances, animation slots, render engines and color management, with Blender source paths.

### Recommended free add-ons and the operators to call via `run_operators`

These are optional. Install them from Blender's Get Extensions (extensions.blender.org); check what's present with `addons(action="list")`.

| Add-on | Operators |
|---|---|
| LoopTools | `mesh.looptools_relax`, `_circle`, `_space`, `_flatten`, `_curve`, `_bridge`, `_gstretch` (edit mode, needs a selection) |
| Bool Tool | `object.boolean_auto_difference`, `_union`, `_intersect`, `_slice` (objects=[target, cutter]; the cutter is consumed), `object.boolean_brush_*`, `object.carve_box` |
| EdgeFlow | `mesh.set_edge_flow`, `mesh.set_edge_linear`, `mesh.set_edge_curve` (edit mode, select edge loops) |
| Mesh Align Plus (RC) | `maplus.alignpointsobject`, `maplus.alignplanesobject`, `maplus.alignlinesobject`. These depend on items stored in its panel, so they're awkward for an agent; usually prefer `run_python` with matrices. |
| Tissue | `object.tissue_tessellate`, `object.dual_mesh`, `object.polyhedral_wireframe`, `object.lattice_along_surface` |
| LODGen | `lodgen.generate_lods`, `lodgen.add_selected` |
| Magic UV | `uv.muv_*` (look them up with `api_lookup("search:muv")`) |
| Blender→Unity FBX (EdyJ) | `export_scene.unity_fbx`. It modifies the scene and then undoes the changes, so in agent workflows use `export_asset(preset="unity_fbx")` instead. |

Deliberately not recommended: LODify (bundles native binaries and launches subprocesses) and QRemeshify (native DLLs, compatibility unverified).

## Running Blender from Claude Code without the MCP (bpy)

Find the Blender executable first: on Windows usually `C:\Program Files\Blender Foundation\Blender <ver>\blender.exe`, on macOS `/Applications/Blender.app/Contents/MacOS/Blender`, on Linux `blender` on PATH.

Headless script execution (no UI):

```bash
blender --background --factory-startup --python script.py
# operate on an existing file:
blender --background scene.blend --python script.py
# pass args to the script after "--":
... --python script.py -- --out render.png
```

bpy guidelines:
- Prefer data-API calls (`bpy.data.objects`, `obj.modifiers.new(...)`, `mat.node_tree.nodes.new(...)`) over `bpy.ops`; ops depend on context/selection and often fail in `--background`.
- Look up nodes/sockets by name (`node.inputs["Base Color"]`) and guard for renamed sockets across versions.
- Save with `bpy.ops.wm.save_as_mainfile(filepath=...)`; render with `bpy.context.scene.render.filepath = ...` then `bpy.ops.render.render(write_still=True)`.
- Never overwrite the user's `.blend` without asking — write to a new file by default.
- To check API details for the installed version: `blender --background --python-expr "import bpy; print(bpy.app.version_string)"`.

Example — the character-modeling SubD blockout as a script:

```python
import bpy, os
bpy.ops.mesh.primitive_cube_add()
body = bpy.context.active_object
body.name = "Body_Blockout"
sub = body.modifiers.new("Subdivision", "SUBSURF")
sub.levels = sub.render_levels = 2
# use an absolute path: "//" is relative to the open .blend and is unreliable for unsaved files
bpy.ops.wm.save_as_mainfile(filepath=os.path.abspath("blockout.blend"))
```
(Verified on Blender 5.2.2 LTS in `--background --factory-startup` mode.)

## Extending this skill

Add new notes as short markdown files under the matching `references/<topic>/` folder and add a row to the index table above.
Pliki w paczce (20)
  • SKILL.md 19 KB
  • references/addons/essential-modeling-addons.md 2 KB
  • references/addons/free-addons-mega-list.md 2 KB
  • references/geometry-nodes/stylized-fur-feathers.md 2 KB
  • references/internals/blender-architecture.md 14 KB
  • references/materials/texture-painting.md 1 KB
  • references/materials/thin-wall-transparency.md 1 KB
  • references/modeling/boolean-cleanup.md 3 KB
  • references/modeling/character-modeling.md 1 KB
  • references/modeling/reference-pipeline.md 6 KB
  • references/projects/car-modeling-bugatti.md 4 KB
  • references/projects/cloth-sofa.md 2 KB
  • references/projects/private-jet-guide-mesh.md 3 KB
  • references/projects/procedural-sushi-geonodes.md 2 KB
  • references/projects/quick-projects.md 11 KB
  • references/projects/realistic-donut.md 4 KB
  • references/rendering/stylized-eevee.md 1 KB
  • references/rigging/face-expressions.md 7 KB
  • references/rigging/squash-and-stretch.md 9 KB
  • references/sculpting/sculpting-for-beginners.md 3 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · MemeGamer/blendpro-mcp85MIT
dreamlab-ai/agentbox100AGPL-3.0
autonomous-ai/openharness100MIT
znlgis/opengis-skills100MIT
BlackBeltTechnology/pi-agent-dashboard100MIT
MAX-786/claude-3d-harness100MIT
whoamnesia/astudio-motion90MIT
digitalsamba/claude-code-video-toolkit87MIT

Migawka bazy z 13.11.2026 · wersja paczki 36dc178cb37b (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90blender-sculpting
    Prowadzi rzeźbienie w Blenderze 5.2 od bryły do detalu: voxel remesh, multires, pędzle i przekazanie do gry.
  • 90blender-sculpting
    Prowadzi przez rzeźbienie organicznych modeli w Blenderze 5.2: od bryły po detal, z remeshem, multires i przekazaniem do silnika gry.
  • 100scenario-blender-retopology
    Zamienia gęsty sculpt, skan lub siatkę z AI w czystą topologię w Blenderze do animacji, subdivision lub low poly do gry: wybór QuadriFlow lub ręcznej retopologii, pętle, bieguny i Shrinkwrap.
  • 90retopology
    Zamienia gęste rzeźby i skany w czyste siatki o niskiej liczbie poligonów w Blenderze i sprawdza odchylenia od powierzchni.
  • 90sculpting
    Modeluje organiczne formy i detale powierzchni w Blenderze 5.2 przy użyciu voxel remesh, multires i kontroli symetrii.
  • 100scenario-blender-expert
    Wspiera pracę 3D w Blenderze przez Python lub most MCP: modelowanie, sculpting, retopologia, UV, baking, rigging, animacja, geometry nodes, światło i render oraz kontrola gotowości zasobu do silnika.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.