- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add scenario-labs/skills --skill scenario-blender-grease-pencil -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add scenario-labs/skills --skill scenario-blender-grease-pencil -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add scenario-labs/skills --skill scenario-blender-grease-pencil -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add scenario-labs/skills --skill scenario-blender-grease-pencil -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/scenario-labs/skills/tree/HEAD/skills/dcc/blender/scenario-blender-grease-pencil來自發布者
Expert Grease Pencil work keeps every drawing editable and redrawable, puts meaning in the structure
(which object, which layer, which key) and judges the result in motion. The agent draws through the
data API (drawings are curves with attributes), builds characters the way 2D studios rig them, and
reviews rendered frames instead of a viewport it cannot flip. If a sibling skill named here is
missing from your available skills, load it with skill_get (Scenario MCP) or ask the user to
install it (https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas
and flag the gap.
REQUIRED BACKGROUND: scenario-blender-expert (execution channel, review loop, 5.2 API changes). Shot planning, boards and animatics: scenario-blender-previs-storyboard. Mesh animation principles: scenario-blender-animation.
Toolkit: scripts/bx_gp.py (tested on 5.2.1).
import sys; sys.path.append("<this skill>/scripts"); import bx_gp as G.
fill_id != 0; strokes sharing an id fill together with even-odd holes; hide_stroke hides the
outline. Material fill toggles are deprecated and holdout "eraser fills" (Grant Abbitt's 4.4
method) are obsolete.use_lights=True, and lit layers take their ambient from
World.color (default 0.05), not from the world node tree, so a flat palette renders at about a
quarter of its value.cam = G.scene_2d(res, fps, frame_range, ortho_scale) (ortho camera at -Y,
Standard, background). Plan the multiplane: which elements are separate objects and their depth
order. Compute px = G.px_size(); line width in pixels is 2 * radius / px. GATE: a test render
shows the frame; planned line widths are at least 1.5 px [added].G.new_object(name, layers=("Fills", "Shadow", "Lines")) per element (bottom to
top, unlit), parent parts, place origins at joints. G.material(ob, name, stroke=hex, fill=hex)
once per bucket. GATE: [l.name for l in ob.data.layers] matches intent; G.draw_order(objs)
lists front to back as designed.d = G.key(ob, "Lines", frame). Lines:
G.add_stroke(d, G.smooth_path(control_pts), radius, pressure=G.taper(n), brush="INK_PEN", material=i);
overlap then trim rather than landing ends exactly (Grant). Fills:
G.add_shape(d, outline, holes=[...], material=i) on the Fills layer, outline on Lines. Bulk:
G.add_strokes(d, specs) (3000 strokes in 0.04 s). Fix shapes with G.grab, G.dissolve,
G.edit_op(ob, "stroke_smooth", ...). GATE: G.verdict(G.report(ob)) is clean and a
full-resolution G.render_frame shows no gaps, leaks or overhangs.blend_mode='MULTIPLY', opacity lowered, use_masks=True,
mask_layers.add(fills); paint the shadow shape past the edge and let the mask clip it; design
it blocky (Pablo). Lit look: use_lights=True plus World.color as ambient plus lamps
(verified: a sun only scales value on a flat drawing, a point light gives a gradient). GATE:
sampled pixels match the palette under Standard.G.key(..., mode="blank"), additive mode="copy", hold or cycle
mode="instance" / G.cycle(...), end an exposure with G.end_exposure. Every visible layer
needs a key at or before frame_start (Elijah). Cutout motion: key object transforms (FK).
In-betweens: check G.match(dA, dB), then
G.interpolate(ob, layer, frame, step=2, type, easing) (native, segment around frame) or
G.inbetween(ob, layer, a, b, frames, spacing=[...] or ease=...) for the animator's own spacing,
clip=True when the pair is different. GATE: per layer,
read left to right for timing and pops,
for arcs and spacing.Measurable (per object, every stage):
for ob in gp_objects:
print(ob.name, G.verdict(G.report(ob))) # first key vs frame_start, lit-without-light,
# invisible strokes, stray micro-strokes, sub-pixel lines,
# fill/stroke alpha 0, empty masks; info: instances, unused materials
print(G.draw_order(gp_objects)) # front -> back vs the staging plan
print(G.match(dA, dB)) # before any interpolation
Visual (open every image): G.render_frame(path, f) at full resolution for line quality, trims,
fill gaps and palette; G.render_strip(path, range(a, b, 2)) for timing, holds and pops;
G.onion(path, f, before, after) for spacing and arcs (it includes object motion and modifiers,
which the viewport onion skin ignores, Falk and Rik); for 2.5D a sequence, never a still. Score
against references/critique.md.
GREASEPENCIL, data bpy.data.grease_pencils;
layer.frames.new(n).drawing.add_strokes([...]); old frame.strokes, point.co, pressure,
strength, GPENCIL and object.grease_pencil_modifiers are gone. Modifiers are regular:
ob.modifiers.new(n, 'GREASE_PENCIL_NOISE'), Line Art is 'LINEART'.grease_pencil.brush_stroke and sculpt_paint have no exec: called with a stroke list in a live
session they log "Invalid operator call" and draw nothing (verified GUI); replayed mouse events
via event_simulate also drew nothing. Draw and sculpt strokes are data; headless edit operators
(stroke_smooth, stroke_simplify, set_uniform_thickness, stroke_subdivide, outline,
join_fills, set_curve_type) run in Edit mode through G.edit_op. In a live session
G.gui_trim (lasso Trim), G.gui_erase_box and G.gui_reproject(type='SURFACE') work with a
3D-view override.interpolate_sequence runs headless on the active object and layer, fills only the segment around
the current frame and inserts BREAKDOWN keys; easing via type and easing.frames.new or frames.copy onto an existing frame raises "Frame already exists";
get_frame_at(n) returns the key exposed at n (None before the first key).layer.mask_layers.add(layer) is the 5.2 mask API; layer groups gp.layer_groups.new,
gp.layers.move_to_layer_group; layers can parent to an object or bone (layer.parent,
parent_bone) and carry their own transform.object.grease_pencil_add(type='LINEART_OBJECT') have lit layers;
objects hidden from render are ignored by Line Art; lineart_bake_strokes bakes the whole scene
range.fill_id on the curve domain.references/expert-notes.md: each expert's principles, judgment and
disagreements with timestamps; load when making a style or pipeline decision.references/procedures.md: tested raw-bpy procedures (P1 to P8) and
bx_gp recipes (cutout character, frame-by-frame, interpolation, 2.5D); load before writing GP
code.references/critique.md: the rubric for judging line, fill, staging, timing and 2.5D renders;
load at every review gate.references/sources.md: the five source videos, what each is best for,
best timestamps.Use when drawing or animating with Grease Pencil in Blender 5.x from Python: 2D or 2.5D illustration, frame-by-frame animation, a cutout or part-based 2D character, strokes with pressure, filled shape
---name: scenario-blender-grease-pencildescription: Use when drawing or animating with Grease Pencil in Blender 5.x from Python: 2D or 2.5D illustration…---# skills/dcc/blender/scenario-blender-grease-pencil/SKILL.md總覽
Use when drawing or animating with Grease Pencil in Blender 5.x from Python: 2D or 2.5D illustration, frame-by-frame animation, a cutout or part-based 2D character, strokes with pressure, filled shapes with holes, in-betweens and interpolation, onion skin, Line Art outlines, strokes on 3D meshes, NPR or hybrid motion graphics. Also when GP code fails (GPENCIL, frame.strokes, grease_pencil_modifiers), fills do not show, colors render dark, or draw brushes will not run from a script.
常見問題
從發布者下載 skills/dcc/blender/scenario-blender-grease-pencil/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/scenario-labs/skills。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。
G.exposures(ob, layer)G.render_strip(path, frames)G.onion(path, frame, before, after)G.lineart(source, radius=width_m) (the modifier radius is the
line width). Strokes on meshes: G.project_to_surface(pts, mesh) and discard strokes with missed
or occluder-captured points (Pablo's failure modes). Relight:
G.relight(ob, canvas, light_dir, shadow, light). Procedural strokes: Geometry Nodes Curves to
Grease Pencil with Instances as Layers off and a fill_id attribute, then apply to bake
(procedures P7). Depth reorder without changing the image: G.push_depth(ob, delta). GATE: a
moving render (strip or playblast) where the surface does not read as 3D (Weigl) and fills do not
poke through (Pablo).