This skill handles sorting, trimming, and moving shots, organizing tracks, and single-shot edits. 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 project reading and editing natively forwarded also require an independent root parameter to be provided before -- ; only exact version/help/no-project-directory queries are 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 the plan or asset metadata. The plan, assets, and source deliverables must be located under the read root, and the 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, registered inputs, and the source project. Current root-isolated execution supports macOS headless; the desktop entry point must simultaneously isolate the signed app and MCP client owned by this session, exposing only the allocated 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, assets, project or object, output directory, and scope of modification; when an existing project is required, verify the summary first. Return the actual CLI results, the saved native project, the required derived outputs, and the verification record. Report installation success, existence of the command directory, and completion of the creative task separately.
First Use and Public Entry Point
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 the existing task authorization covers the necessary dependencies, execute this skill's installer directly without creating a separate approval process.
Set SKILL_DIR to the directory (absolute path) containing this SKILL.md actually loaded by the host. User-level installations may be located at ~/.agents/skills/filmcraft-cli-timeline, project-level ones may be located at .agents/skills/filmcraft-cli-timeline, and plugins may be located in their skills/filmcraft-cli-timeline or host cache directory; rely on the actual loaded path, do not guess based on the current working directory, and do not search and then 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
CLI argv after -- , the native subcommand must come first. Installation parameters go before the separator;--runtime-home can isolate the cache. Stop when the locked artifact digest 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 explains the launch parameters.
Scene Operations
Verify this scene's inputs, native project, target objects, version, and output boundaries. Choose the current command according to the Scene Guide save an independent checkpoint, then execute; after completion, reopen the native project and check the actual outputs and non-target content.
describe <id> verify the parameters, then use exec <id> <JSON> or run <JSONL>; write commands must be saved in the same batch or used together with --save-as。
254016000000 ticks per second; the workflow.py template handles large integers according to its contract; commands.py native ticks must be exact JSON integers and must not use numeric strings. Preserve non-target shot and audio track parameters.
Native composition and source project revisions use this skill's bundled scripts/workflow.py; read workflow contract, and the template is within this skill's examples. Only modify authorized objects; native projects and dependency assets are preserved, and derived-format lossy reads use exchange report。
Verification and recovery
A non-zero command exit does not count as completion; you need to inspect the actual saved project, export, dimensions, and media decoding. Timeout results are marked unknown; first inspect the original task/project, and do not automatically replay edits. The existing native workflow supports save-as revision; if the corresponding project summary does not match, refuse to overwrite.
On-demand reference and handoff
- Actual command evidence: fixed-version observation, used only as routing and parameter reference; real-time results take precedence, and disabled items are not executed.
- workflow contract: composition operations, native saving, dependency collection, and revision.
- When installation/diagnostics are needed, hand off to filmcraft-cli-setup; for full task routing hand off 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 fictitious 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 commands use
The current skill includes the parameter descriptions and same-session entry points for the complete catalog, and is not limited by the creative template allowlist. Read full usage guide, and query command referenceas needed; each instruction has a skill route, prerequisite observation, 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, and retain return value references and step-by-step receipts; semantic errors or timeouts must not be passed off as success. Catalog coverage and direct native use do not mean that all instructions, GUI, delivery, or Art orchestration have been accepted.
For the full workflow command gateway, see usage instructions. For the fixed CLI version and artifact digest, refer to this skill's bundled scripts/runtime.lock.json as authoritative; the skill package version is based on the corresponding release tag. Independent installation re-verification and full per-command acceptance are recorded separately, and release does not replace acceptance.
For GUI tasks, you may first use this skill's bundled fixed desktop installation; installation, launch, and actual GUI editing are verified separately.
Complete attribution commands are listed by command family in categorized usage list, and each item can be viewed through this skill's commands.py describe for parameters; the general CLI list also retains all commands not assigned to specialized skills.
Tasks for this skill first read specialized task template, and execute according to the corresponding inputs, first task, failure boundaries, local revisions, and verification. For cross-capability combinations, read complete business scenarios。
If installation fails, read first-use diagnostics, and use the receipt to locate the setup entry point of the current skill itself; installation failures and native invocation failures are handled separately.
For same-target execution contention and interruption registration, see this skill's execution registration; skill source dev.29 includes the implementation, and plugin fixed installation acceptance is recorded separately.
For continuous operations, prioritize using this skill's built-in task-level session: start it 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.