blender-harness SKILL.md skillA
blender-harness from full-aigc-plugins/blender-design-plugin is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add full-aigc-plugins/blender-design-plugin/blender-harness@git:20260923.7a181c8Pins git:20260923.7a181c8 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- full-aigc-plugins/blender-design-plugin
- Path
skills/blender-harness/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260923.7a181c8, committed Sep 23, 2026
- First version recorded
- Sep 18, 2026
- Size
- 5,846 bytes
- Repository stars
- 4
- License
- Apache-2.0
Launch a managed Blender harness session and dispatch structured JSON commands through harness_cli.py. Covers session bootstrap, the closed request envelope (protocolVersion/sessionId/requestId/transactionId/command/arguments/expectedSceneRevision), receipt verification, error codes, capability maturity levels and background jobs. Use this skill for ANY task that needs to create, modify, inspect or export Blender content.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Blender Harness 调用规范
本技能定义驱动 Blender 的**唯一执行通道**（WorkBuddy 团队与单插件用户通用）。它是平台无关的：启动器 + JSON 命令行客户端 + 运行在 Blender 内的结构化命令注册表。所有命令契约、回执 schema 与验收阈值以本插件随附的 `blender-production` 技能参考文档为准。
## 1. 定位插件目录
本技能位于 `<插件根>/skills/blender-harness/SKILL.md`。插件根目录（含 `scripts/`、`schemas/`、`config/`）即执行入口所在：
```
<插件根>/scripts/launch_harness.py # 启动托管会话
<插件根>/scripts/harness_cli.py # 向会话派发命令
```
在 shell 中用 `pwd`/`ls` 确认实际路径后再执行；不要凭记忆猜路径。
## 2. 启动会话（每个生产任务一次）
```bash
mkdir -p <输出根目录> # 所有产物必须落在该授权目录内
python3 <插件根>/scripts/launch_harness.py \
--session-id <唯一会话ID> \
--output-root <输出根目录的绝对路径> \
--execution-mode auto_with_budget
```
- Blender 可执行文件自动发现（PATH 或 `/Applications/Blender.app/Contents/MacOS/Blender`）；装在别处时传 `--blender <路径>`。
- 启动成功后打印 descriptor（含 `address`、`token`、`descriptorPath`）。**记下 descriptorPath**——后续所有命令都要用它。
- 会话结束后按 descriptor 里的说明关闭；不要留孤儿 Blender 进程。
## 3. 派发命令
把请求写成 JSON 文件再发送（闭合契约，多余字段直接报 `INVALID_REQUEST`）：
```json
{
"protocolVersion": "codex-blender/v1",
"sessionId": "<与会话一致>",
"requestId": "<本次请求唯一ID>",
"transactionId": "<事务ID>",
"command": "mesh.inspect",
"arguments": {}
}
```
```bash
…Read the whole file at its exact version.
How to install
mdr add full-aigc-plugins/blender-design-plugin/blender-harness@sha256:79156fbcd02d3aedThe line at the top of this page pins the label git:20260923.7a181c8, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_wij7jzp5xtgtpmxe)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Sep 18, 2026 and Sep 23, 2026, about one every 5 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260923.7a181c8 latest | 2026-09-23 | 7a181c8 | 5,846 B | A | view · diff |
| git:20260918.f9fc6f7 | 2026-09-18 | f9fc6f7 | 5,839 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5846 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
full-aigc-plugins/blender-design-plugin · 4 stars · license Apache-2.0 · pushed 2026-10-31 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_wij7jzp5xtgtpmxe GET https://markdownregistry.com/api/v1/resolve?ref=full-aigc-plugins/blender-design-plugin/blender-harness GET https://markdownregistry.com/api/v1/blob/79156fbcd02d3aed4345f055d87671258760a00a02fe200f2d3a830137572e2f
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from full-aigc-plugins/blender-design-plugin
Every file in full-aigc-plugins/blender-design-plugin