This skill handles angle switching, cut-point revision, and main recording continuity checks for existing synchronized multi-camera material. It hands off to skills in the same package by name, can be used when installed alone, and does not read sibling directories. It invokes the fixed released filmcraft-cli and preserves the native editing project.
Trusted directory permissions
Old cli.py Native forwarded project reading and editing also require an independent root parameter before -- ; only exact version/help/no-project-directory queries remain compatible with old calls. Model downloads must separately use --model-maintenance, see this skill's Execution permissions。
Public workflow.py and commands.py run must explicitly provide --read-root READ_DIRECTORY --write-root WRITE_DIRECTORY(repeatable); the root must be an existing canonical real directory, authorized by the user/host, and must not be derived from plans or material metadata. Plans, materials, and source deliverables must be located under the read root, and deliverables and their parent directories must be located under the write root.--runtime-home is the installation maintenance directory and must be located under a separate, explicitly authorized write root; editing native processes are always prohibited from modifying this cache, the skill, registration inputs, and source projects. The current root-isolated execution supports macOS headless; desktop entry points must simultaneously isolate the signed application and MCP client owned by this session, exposing only the assigned loopback control port. External bridges whose isolation cannot be confirmed are explicitly rejected. The low-level Python test API is not a public authorization entry point. For detailed boundaries, see Execution permissions。
Inputs and deliverables
The inputs are the user-confirmed task, materials, project or object, output directory, and modification scope; when an existing project is required, verify the summary first. Return the actual CLI results, the saved native project, the required derived outputs, and verification records. Report installation success, command directory existence, and creative task completion separately.
First use and public entry points
Locate the real directory of the current SKILL.md. Currently supports macOS arm64, Python 3.11+; the fixed CLI is installed to the user data directory. When existing task authorization covers the necessary dependencies, run this skill's installer directly; do not create a separate approval process.
Set SKILL_DIR to the directory containing the actually loaded SKILL.md for this host (absolute path). User-level installations may be located at ~/.agents/skills/filmcraft-cli-multicam, project-level ones may be located at .agents/skills/filmcraft-cli-multicam, and plugins may be located in their skills/filmcraft-cli-multicam or the host cache directory; rely on the actual loaded path, do not guess based on the current working directory, and do not search and arbitrarily select a duplicate version. The skill directory and the CLI's user data installation directory are two independent locations.
: "${SKILL_DIR:?请先设置为本 SKILL.md 的实际所在目录}"
python3 -I -B "$SKILL_DIR/scripts/bootstrap.py"
python3 -I -B "$SKILL_DIR/scripts/cli.py" -- --version
python3 -I -B "$SKILL_DIR/scripts/cli.py" -- commands --json
In the CLI argv, after -- , the native subcommand must come first. Installation parameters go before the separator;--runtime-home can isolate the cache. Stop when locking artifact digests fails, the installation is corrupted, or the platform is unsupported; do not modify PATH and do not perform floating upgrades. The native help entry point is help; the launcher's own --help only describes launch parameters.
Scene operations
First read multi-camera scene, confirm the synchronization basis, current sequence, and actual camera order; distinguish replacing an angle from creating a cut point, and after saving check the main recording and non-target shots.
First query the current version and command directory; record read-only and editing calls separately. Read the current project state and command enabled/params, then construct argv; consecutive steps that need to create objects must be executed in the same session, and returned IDs must not be guessed.
describe <id> Check the parameters, then use exec <id> <JSON> or run <JSONL>; write commands must be saved in the same batch or used with --save-as。
Native composition and source project revisions use this skill's built-in scripts/workflow.py; read workflow contract, templates are in this skill's examples. Modify only authorized objects, preserve native projects and dependent assets, and read derivation format loss through exchange report。
Verification and recovery
A non-zero command exit does not count as completion; the actual saved project, export, dimensions, and media decoding need to be inspected. Timed-out results are marked unknown; check the original task/project first, and do not automatically replay edits. Existing native workflows support save-as revisions; refuse to overwrite when the corresponding project summary does not match.
On-demand references and handoff
- Actual command evidence: fixed-version observations, used only as routing and parameter references; real-time results take precedence, and disabled items are not executed.
- Workflow contract: composition operations, native saving, dependency collection, and revisions.
- Hand installation/diagnostics to filmcraft-cli-setupwhen needed, and full task routing to filmcraft-use; when the skill is missing, use
npx skills add full-aigc-skills/filmcraft-skills --skill <skill-name>. Do not load other skills through adjacent file paths.
This skill does not provide a fictional login interface; local headless does not require a cloud account. Full GUI, cross-editor fidelity, and creative quality are stated according to actual evidence.
Full native command usage
The current skill includes parameter descriptions for the full catalog and same-session entry points, not restricted by the creative template whitelist. Read full usage guide, and query on demand command reference; each instruction has a skill route, prerequisite observations, and acceptance status.
: "${READ_ROOT:?Set READ_ROOT to an existing independently authorized directory}"
: "${RUNTIME_HOME:?Set RUNTIME_HOME to an existing independently authorized directory}"
: "${SKILL_DIR:?Set SKILL_DIR to an existing independently authorized directory}"
: "${WRITE_ROOT:?Set WRITE_ROOT to an existing independently authorized directory}"
python3 -I -B "$SKILL_DIR/scripts/commands.py" list --filter QUERY
python3 -I -B "$SKILL_DIR/scripts/commands.py" describe COMMAND_ID
python3 -I -B "$SKILL_DIR/scripts/commands.py" run "$SKILL_DIR/examples/commands-advanced.json" --output /absolute/new-command-result --runtime-home "$RUNTIME_HOME" --read-root "$SKILL_DIR" --read-root "$READ_ROOT" --write-root "$WRITE_ROOT" --write-root "$RUNTIME_HOME"
Before executing a new entry point, check the real registry and current executable status, retain return value references and step-by-step receipts; do not pass off semantic errors or timeouts as success. Catalog coverage and direct native use do not mean that all commands, GUI, delivery, or Art orchestration have been accepted.
For the full workflow command gateway, see usage instructions. The fixed CLI version and artifact summary are based on this skill's built-in scripts/runtime.lock.json ; the skill package version is based on the corresponding release tag. Independent installation re-verification and full command-by-command acceptance are recorded separately; release is not a substitute for acceptance.
For GUI tasks, you may first use this skill's built-in fixed desktop installation; installation, startup, and actual GUI editing are verified separately.
Complete attribution commands are listed by command family in categorized usage list; each item can be viewed through this skill's commands.py describe parameters; the general CLI catalog also retains all commands not assigned to specialized skills.
For this skill's tasks, first read specialized task template, and execute according to the corresponding inputs, first task, failure boundaries, local revisions, and verification. When combining across capabilities, also read complete business scenarios。
If installation fails, read first-use diagnostics, and locate the current skill's own setup entry point according to the receipt; handle installation failures and native invocation failures separately.
For multicamera interviews, performances, and main recording continuity tasks, read multicamera scenarios, and verify camera numbers, synchronization basis, and cut point acceptance.
For same-target execution contention and interruption registration, see this skill's execution registration; Skill source dev.29 includes the implementation; plugin fixed-installation acceptance is recorded separately.
For continuous operations, preferentially use this skill's built-in task-level session: start once, then check, save, and rework plan by plan, sharing the same FilmCraft instance; exit only when the task ends. A single run still retains the original compatible behavior.