docs: explain director skill integration

Author: Aoike123

.claude-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "blender-vse",
   "displayName": "Blender VSE Control",
   "version": "0.1.1",
-  "description": "Local, revision-safe control of editable Blender VSE projects with one Skill and a four-tool MCP server.",
+  "description": "Revision-safe Blender VSE timeline execution for agents; pair with a director Skill for end-to-end production.",
   "author": {
     "name": "Aoike",
     "url": "https://github.com/Aoike123"

.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "blender-vse",
   "version": "0.1.1",
-  "description": "Local, revision-safe control of editable Blender VSE projects through one Skill and four MCP tools.",
+  "description": "Revision-safe Blender VSE timeline execution for agents; pair with a director Skill for end-to-end production.",
   "author": {
     "name": "Aoike",
     "url": "https://github.com/Aoike123"
@@ -28,7 +28,7 @@
   "interface": {
     "displayName": "Blender VSE Control",
     "shortDescription": "Revision-safe local Blender VSE editing for agents",
-    "longDescription": "Let AI agents safely inspect, edit, resume, render, and verify persistence for local Blender VSE projects. Fresh observations, atomic patches, stale-base protection, and fresh-process verification preserve human changes while the .blend remains editable.",
+    "longDescription": "Let AI agents safely inspect, edit, resume, render, and verify persistence for local Blender VSE projects. Fresh observations, atomic patches, stale-base protection, and fresh-process verification preserve human changes while the .blend remains editable. For end-to-end production, pair this timeline execution layer with a director or production-orchestration Skill that owns creative planning, storyboards, and source-media work.",
     "developerName": "Aoike",
     "category": "Productivity",
     "capabilities": [

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 [Chinese version](CHANGELOG_zh-CN.md)
 
+## Unreleased
+
+- Documented how to pair Blender VSE Control with a director or
+  production-orchestration Skill for end-to-end automation, with explicit
+  ownership boundaries for creative planning, source media, timeline execution,
+  and persistence verification.
+
 ## 0.1.1 - 2026-09-04
 
 - Rewrote all 25 English/Chinese documentation pairs for clear, natural prose

CHANGELOG_zh-CN.md

@@ -2,6 +2,11 @@
 
 [English version](CHANGELOG.md)
 
+## 尚未发布
+
+- 补充 Blender VSE Control 与导演或制作编排 Skill 的全流程自动化搭配方式，明确创意规划、
+  源素材、时间线执行和持久化验证分别由哪一层负责。
+
 ## 0.1.1 - 2026-09-04
 
 - 重写全部 25 组中英文文档，使两种语言都自然、清晰，同时保留命令、契约和安全边界。

README.md

@@ -17,6 +17,24 @@ remain protected.
 > declares compatibility with Blender 4.2+, but official support claims cover
 > only the versions listed in the release notes.
 
+## Pairing with a director Skill
+
+Blender VSE Control is the timeline execution layer, not the creative director.
+For an automated workflow that runs from concept and storyboard through
+source-media preparation and final assembly, pair it with an available director
+or production-orchestration Skill:
+
+- The director Skill owns the creative brief, narrative structure, shot plan,
+  asset requirements, and acceptance criteria, then delegates concrete timeline
+  edits.
+- Blender VSE Control applies those edits to the named `.blend`, protects human
+  revisions, renders when requested, and verifies that the saved timeline
+  persists.
+
+Media generation, sourcing, and licensing remain the responsibility of the
+upper-layer workflow and its chosen tools. The resulting `.blend` stays
+editable, so a human can intervene without giving up control.
+
 ## Install from GitHub
 
 Send the repository link to Codex, Claude Code, or DeepSeek Harness (DSH) and

README_zh-CN.md

@@ -10,6 +10,19 @@ Blender VSE Control 是面向 Blender 视频序列编辑器（Video Sequence Edi
 
 > 状态：Alpha。Blender 5.1 是当前主要验证目标。随附的 Bridge 声明兼容 Blender 4.2+，但官方只对发布说明中列出的版本作出支持承诺。
 
+## 与导演 Skill 搭配
+
+Blender VSE Control 是时间线执行层，不承担创意导演的职责。如果希望 Agent 从创意、分镜、
+素材准备一路自动推进到最终组装，建议与可用的导演或制作编排 Skill 搭配使用：
+
+- 导演 Skill 负责创意简报、叙事结构、镜头方案、素材需求和验收标准，再把明确的时间线修改
+  交给本项目执行。
+- Blender VSE Control 负责把这些修改写入指定的 `.blend`，保护人工修订，按需渲染，并验证
+  保存后的时间线确实已经持久化。
+
+素材生成、获取和授权仍由上层流程及其所选工具负责。最终 `.blend` 始终可编辑，人工可以
+随时介入，而不会失去对时间线的控制。
+
 ## 从 GitHub 安装
 
 将仓库链接发给 Codex、Claude Code 或 DeepSeek Harness（DSH），让它安装插件：

docs/architecture.md

@@ -11,6 +11,20 @@ proxy files, and session observations are derived artifacts.
 The package has no runtime dependency on an agent framework, production
 database, downloader, or media provider.
 
+## Role in an end-to-end production stack
+
+Blender VSE Control intentionally acts as the timeline execution and
+verification layer. When a request spans creative direction, storyboarding,
+source-media generation or sourcing, and final assembly, an available director
+or production-orchestration Skill should own that upper-layer workflow. It
+turns creative intent into an explicit edit plan and delegates the concrete VSE
+operations to this project.
+
+The two layers are composed by the Agent host; Blender VSE Control has no hard
+dependency on a particular director Skill. This boundary lets the upper layer
+change creative tools or media providers while the named `.blend` remains the
+revision-safe, human-editable source of truth.
+
 ```text
 Application / Agent host
         |

docs/architecture_zh-CN.md

@@ -8,6 +8,15 @@ Blender VSE Control 是围绕持久化 `.blend` 时间线构建的本地控制
 
 本包在运行时不依赖 Agent 框架、生产数据库、下载器或媒体服务商。
 
+## 在全流程自动化中的职责
+
+Blender VSE Control 有意只承担时间线执行与验证。如果任务覆盖创意方向、分镜、素材生成或
+获取以及最终组装，应由可用的导演或制作编排 Skill 负责上层流程：它把创作意图整理成明确
+的剪辑方案，再把具体的 VSE 操作交给本项目执行。
+
+这两层由 Agent 宿主组合，Blender VSE Control 不强制依赖某一个导演 Skill。因此，上层可以
+更换创作工具或媒体服务，而指定的 `.blend` 仍是具备修订保护、可由人工继续编辑的事实源。
+
 ```text
 应用 / Agent 宿主
         |

docs/index.md

@@ -7,6 +7,12 @@ Agent-assisted editing of persistent `.blend` timelines. Blender remains the
 editable source of truth, while fresh observations prevent Agents from
 silently overwriting human changes.
 
+For end-to-end automation, pair it with an available director or
+production-orchestration Skill. The upper layer owns creative direction,
+storyboards, source-media work, and acceptance criteria; Blender VSE Control
+executes concrete timeline edits and verifies the saved `.blend`. See
+[Architecture](architecture.md) for the responsibility boundary.
+
 Proxy encoding and rebuilding remain outside the project's scope; it only
 validates and attaches externally generated proxy manifests. `blender_verify`
 reopens the project in a fresh process and confirms saved structural facts. It

docs/index_zh-CN.md

@@ -4,6 +4,10 @@
 
 Blender VSE Control 是面向 Agent 辅助剪辑的本地控制层，为持久化的 `.blend` 时间线提供具备修订保护的编辑能力。Blender 始终作为可编辑的事实源；每次写入都基于最新观察，从而防止 Agent 静默覆盖人工修改。
 
+如果需要全流程自动化，建议与可用的导演或制作编排 Skill 搭配使用。上层负责创意方向、
+分镜、源素材和验收标准；Blender VSE Control 负责执行明确的时间线修改，并验证保存后的
+`.blend`。职责边界详见[架构](architecture_zh-CN.md)。
+
 代理编码和重建不在本项目的职责范围内；本项目只验证并附加外部生成的代理清单。`blender_verify` 会在新的进程中重新打开项目，确认已保存的结构事实，但不会评估视觉质量或创意是否正确。仓库根目录的 [README](../README_zh-CN.md) 提供简要概览，详细契约则集中在此处。
 
 ## 使用项目