agentcut 0.2.22 → 0.2.24
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/studio/canvas.d.ts +82 -0
- package/dist/studio/canvas.js +273 -0
- package/dist/studio/canvas.js.map +1 -0
- package/dist/studio/chat.js +6 -0
- package/dist/studio/chat.js.map +1 -1
- package/dist/studio/editing-styles.d.ts +2 -2
- package/dist/studio/host.d.ts +2 -0
- package/dist/studio/host.js +41 -5
- package/dist/studio/host.js.map +1 -1
- package/dist/studio/mcp-guides.js +22 -12
- package/dist/studio/mcp-guides.js.map +1 -1
- package/dist/studio/projects.d.ts +9 -0
- package/dist/studio/projects.js +20 -1
- package/dist/studio/projects.js.map +1 -1
- package/dist/studio/read-batch.d.ts +45 -0
- package/dist/studio/read-batch.js +25 -0
- package/dist/studio/read-batch.js.map +1 -0
- package/dist/studio/review-plan.d.ts +53 -0
- package/dist/studio/review-plan.js +52 -0
- package/dist/studio/review-plan.js.map +1 -0
- package/dist/studio/schema.d.ts +88 -88
- package/dist/studio/tools.js +17 -3
- package/dist/studio/tools.js.map +1 -1
- package/dist/studio/video-creation.d.ts +15 -0
- package/dist/studio/video-creation.js +90 -0
- package/dist/studio/video-creation.js.map +1 -0
- package/dist/studio/voice/kokoro-catalog.d.ts +253 -0
- package/dist/studio/voice/kokoro-catalog.js +285 -0
- package/dist/studio/voice/kokoro-catalog.js.map +1 -0
- package/dist/studio/voice/kokoro.d.ts +5 -0
- package/dist/studio/voice/kokoro.js +152 -0
- package/dist/studio/voice/kokoro.js.map +1 -0
- package/dist/studio/voice/registry.js +2 -0
- package/dist/studio/voice/registry.js.map +1 -1
- package/dist/studio/voice/types.d.ts +8 -0
- package/dist/studio/voice.d.ts +6 -0
- package/dist/studio/voice.js +10 -19
- package/dist/studio/voice.js.map +1 -1
- package/package.json +56 -54
- package/template/skill/SKILL.md +29 -1
- package/template/skill/references/efficient-review.md +71 -0
- package/template/skill/references/how-to.md +161 -0
- package/template/skill/references/product-launch.md +131 -0
- package/template/skill/references/sound.md +9 -5
- package/template/skill/references/website-howto.md +4 -0
package/dist/studio/voice.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/studio/voice.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,yFAAyF;AACzF,wFAAwF;AACxF,8FAA8F;AAC9F,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAOtE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,MAAM,KAAK,GAAG,aAAa,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;AAIjE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEhF,8EAA8E;AAC9E,YAAY;AAEZ,MAAM,UAAU,YAAY;IAC1B,6DAA6D;IAC7D,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,aAAa;QACzB,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,kBAAkB,CAAC,CACjD,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,EAAW;IACvB,OAAO,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,MAAM,CAAC,EAAmB;IACxC,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/studio/voice.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,54 +1,56 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "agentcut",
|
|
3
|
-
"version": "0.2.
|
|
4
|
-
"description": "Local helper for Agentcut: runs your coding agent (Claude Code or Codex), your video workspace and live preview bundles for the Agentcut studio page.",
|
|
5
|
-
"license": "MIT",
|
|
6
|
-
"type": "module",
|
|
7
|
-
"bin": {
|
|
8
|
-
"agentcut": "dist/studio/cli.js"
|
|
9
|
-
},
|
|
10
|
-
"publishConfig": {
|
|
11
|
-
"access": "public"
|
|
12
|
-
},
|
|
13
|
-
"repository": {
|
|
14
|
-
"type": "git",
|
|
15
|
-
"url": "git+https://github.com/deifos/Agentcut.git",
|
|
16
|
-
"directory": "packages/agentcut"
|
|
17
|
-
},
|
|
18
|
-
"files": [
|
|
19
|
-
"dist",
|
|
20
|
-
"template",
|
|
21
|
-
"README.md",
|
|
22
|
-
"LICENSE"
|
|
23
|
-
],
|
|
24
|
-
"scripts": {
|
|
25
|
-
"build": "tsc",
|
|
26
|
-
"typecheck": "tsc --noEmit",
|
|
27
|
-
"studio": "tsx src/studio/cli.ts",
|
|
28
|
-
"sync:skill": "node scripts/sync-studio-skill.mjs",
|
|
29
|
-
"prepack": "npm run sync:skill && npm run build"
|
|
30
|
-
},
|
|
31
|
-
"keywords": [
|
|
32
|
-
"agentcut",
|
|
33
|
-
"mcp",
|
|
34
|
-
"remotion",
|
|
35
|
-
"video",
|
|
36
|
-
"claude-code",
|
|
37
|
-
"codex"
|
|
38
|
-
],
|
|
39
|
-
"engines": {
|
|
40
|
-
"node": ">=20.10"
|
|
41
|
-
},
|
|
42
|
-
"dependencies": {
|
|
43
|
-
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
44
|
-
"agent-browser": "0.41.0",
|
|
45
|
-
"esbuild": "^0.28.2",
|
|
46
|
-
"
|
|
47
|
-
"
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
"
|
|
53
|
-
|
|
54
|
-
|
|
1
|
+
{
|
|
2
|
+
"name": "agentcut",
|
|
3
|
+
"version": "0.2.24",
|
|
4
|
+
"description": "Local helper for Agentcut: runs your coding agent (Claude Code or Codex), your video workspace and live preview bundles for the Agentcut studio page.",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"bin": {
|
|
8
|
+
"agentcut": "dist/studio/cli.js"
|
|
9
|
+
},
|
|
10
|
+
"publishConfig": {
|
|
11
|
+
"access": "public"
|
|
12
|
+
},
|
|
13
|
+
"repository": {
|
|
14
|
+
"type": "git",
|
|
15
|
+
"url": "git+https://github.com/deifos/Agentcut.git",
|
|
16
|
+
"directory": "packages/agentcut"
|
|
17
|
+
},
|
|
18
|
+
"files": [
|
|
19
|
+
"dist",
|
|
20
|
+
"template",
|
|
21
|
+
"README.md",
|
|
22
|
+
"LICENSE"
|
|
23
|
+
],
|
|
24
|
+
"scripts": {
|
|
25
|
+
"build": "tsc",
|
|
26
|
+
"typecheck": "tsc --noEmit",
|
|
27
|
+
"studio": "tsx src/studio/cli.ts",
|
|
28
|
+
"sync:skill": "node scripts/sync-studio-skill.mjs",
|
|
29
|
+
"prepack": "npm run sync:skill && npm run build"
|
|
30
|
+
},
|
|
31
|
+
"keywords": [
|
|
32
|
+
"agentcut",
|
|
33
|
+
"mcp",
|
|
34
|
+
"remotion",
|
|
35
|
+
"video",
|
|
36
|
+
"claude-code",
|
|
37
|
+
"codex"
|
|
38
|
+
],
|
|
39
|
+
"engines": {
|
|
40
|
+
"node": ">=20.10"
|
|
41
|
+
},
|
|
42
|
+
"dependencies": {
|
|
43
|
+
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
44
|
+
"agent-browser": "0.41.0",
|
|
45
|
+
"esbuild": "^0.28.2",
|
|
46
|
+
"kokoro-js": "1.2.1",
|
|
47
|
+
"smol-toml": "^1.9.1",
|
|
48
|
+
"zod": "^3.25.76",
|
|
49
|
+
"@huggingface/transformers": "3.8.1"
|
|
50
|
+
},
|
|
51
|
+
"devDependencies": {
|
|
52
|
+
"@types/node": "^24.0.3",
|
|
53
|
+
"tsx": "^4.20.3",
|
|
54
|
+
"typescript": "^5.8.3"
|
|
55
|
+
}
|
|
56
|
+
}
|
package/template/skill/SKILL.md
CHANGED
|
@@ -5,6 +5,10 @@ description: "Create and edit videos in an Agentcut workspace, including website
|
|
|
5
5
|
|
|
6
6
|
# Agentcut
|
|
7
7
|
|
|
8
|
+
## Independent clips and versions
|
|
9
|
+
|
|
10
|
+
When asked for several standalone videos from recordings, use `agentcut_canvas` to list the sources and edits in this canvas. Inspect the recordings or their transcripts to find complete moments. Use `agentcut_create_cut` with kind `clip` for each requested video. Pass source IDs and start/end times in seconds in the desired playback order. One clip can use several ranges from one or more recordings. Do not split the recording into equal chapters unless asked. For an alternative edit, use kind `version` on the cut to duplicate. Edit the returned slug explicitly. To reuse an edit from another cut, read its layers and copy the relevant ranges or scene and asset files. Keep the current editor selection during batch creation.
|
|
11
|
+
|
|
8
12
|
## Phone editing modes
|
|
9
13
|
|
|
10
14
|
For phone requests with Social video or Light cleanup selected, read
|
|
@@ -39,6 +43,30 @@ working setup. Keep the full creative and review workflow below, including forma
|
|
|
39
43
|
music, sound and visual checks. Remove stalled waits and repeated setup without reducing quality.
|
|
40
44
|
User-requested scope and existing project choices take priority.
|
|
41
45
|
|
|
46
|
+
## How-to
|
|
47
|
+
|
|
48
|
+
For the **How-to** chat action or a request for a tutorial, walkthrough, or video that teaches a
|
|
49
|
+
software task, read `references/how-to.md` first (`agentcut_guide` through MCP). Keep the user's
|
|
50
|
+
brief, uploads, style and music. A bare request without a task or project material needs only:
|
|
51
|
+
"What should viewers learn to do? Add a URL, recording, or a short description of the task."
|
|
52
|
+
Ask immediately; do not search libraries or other projects to guess the task. Use the normal studio
|
|
53
|
+
workflow, not the release-job API, which does not support how-to jobs.
|
|
54
|
+
|
|
55
|
+
New-video actions create a separate canvas video when the current edit has content; a truly empty
|
|
56
|
+
video is reused. Work only on the assigned target. Keep the source video unchanged. Explicit edit
|
|
57
|
+
requests stay on the intended edit; ask which destination for ambiguous requests before changing it.
|
|
58
|
+
|
|
59
|
+
## Product Launch
|
|
60
|
+
|
|
61
|
+
For the **Product Launch** chat action or a written request for a product launch video, product reveal,
|
|
62
|
+
launch film, or video to introduce a new product or feature, read `references/product-launch.md` first
|
|
63
|
+
(through `agentcut_guide` when using MCP). Use the same guide with uploaded footage or from scratch.
|
|
64
|
+
Keep the user's brief, attachments and selected style/music. Inspect existing material before asking
|
|
65
|
+
for input. For a bare request without product context or project material, ask what is launching and
|
|
66
|
+
for a URL or short description immediately; do not scan libraries, sources or other projects to guess.
|
|
67
|
+
This is a creative brief, not a fixed template or the release capture prototype below.
|
|
68
|
+
Use that prototype only when its real-app capture workflow is requested or needed for verified proof.
|
|
69
|
+
|
|
42
70
|
## Release announcements from a real app
|
|
43
71
|
|
|
44
72
|
This flow must work from the app URL, user brief and browser-visible UI. Source-code access is
|
|
@@ -299,7 +327,7 @@ scripts from the project folder (e.g. composing music or fetching CC0 sounds, se
|
|
|
299
327
|
| `agentcut_preview_check` | does the live preview keep up? dropped frames per clip (see `references/performance.md`) |
|
|
300
328
|
| `agentcut_import_reference` | Style Spy: a reference video plus sampled frames (see `references/style-spy.md`) |
|
|
301
329
|
| `agentcut_inspect_reference` | Inspect consecutive source frames and crop a caption or graphic for measurement |
|
|
302
|
-
| `agentcut_voice_options` / `_generate_voice` |
|
|
330
|
+
| `agentcut_voice_options` / `_generate_voice` | free local Kokoro by default; paid only on explicit user selection (see `references/sound.md`) |
|
|
303
331
|
| `agentcut_components` | the component library: search, then `id` for props and a ready clip |
|
|
304
332
|
| `agentcut_music_catalog` / `_add_catalog_music` | the Agentcut music library (200+ hosted songs) |
|
|
305
333
|
| `agentcut_broll_search` / `_add_broll` | archival public-domain footage by meaning (see `references/broll.md`) |
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Group reads and review changed shots
|
|
2
|
+
|
|
3
|
+
Use fewer repeated model turns without removing evidence, craft or final checks. These methods do
|
|
4
|
+
not promise measured token or time savings. They do not change provider settings or compact history.
|
|
5
|
+
|
|
6
|
+
## Independent reads in one request
|
|
7
|
+
|
|
8
|
+
Once the task and product are known, gather small independent reads together. For MCP,
|
|
9
|
+
`agentcut_read_files` accepts the active `project` and up to 12 `files`, each with `scope`, `path`,
|
|
10
|
+
optional configured source ID, and optional one-based inclusive `startLine`/`endLine`. Examples of
|
|
11
|
+
independent inputs are project.json, layers.json and notes.md, or already-located source UI sections.
|
|
12
|
+
Use `agentcut_guide` with `paths` to read up to six known supporting guides together. Single-guide
|
|
13
|
+
`path` remains supported. Do not load every reference just because a batch is possible.
|
|
14
|
+
|
|
15
|
+
The file batch uses the existing file-read permission checks and returns every result in request
|
|
16
|
+
order. Check each `ok`, scope, range, completeness and hash. It returns an explicit error for a file
|
|
17
|
+
that exceeds the remaining 96,000-character content budget; that file was not reviewed. A range's
|
|
18
|
+
hash covers the full original file, not only the excerpt. Keep hashes for normal conflict-safe writes.
|
|
19
|
+
Do not write from an excerpt when missing context could affect correctness. Narrow the range
|
|
20
|
+
or request the needed full file, without silently omitting evidence.
|
|
21
|
+
|
|
22
|
+
With local shell/file access, read those independent files or sections in one tool execution. Reuse
|
|
23
|
+
current material; avoid repeated whole-repository scans or rediscovering known brand/source paths.
|
|
24
|
+
Keep dependencies sequential: first list to find a path, then read it; first read before a write.
|
|
25
|
+
Do not parallelize edits, capture, contact sheets, audio analysis/review, preview checks or exports.
|
|
26
|
+
If an older helper does not advertise a new batching tool, use existing file tools grouped in
|
|
27
|
+
one local execution when permitted. Do not repeatedly call an unknown method or restart services.
|
|
28
|
+
|
|
29
|
+
## Intermediate picture checks
|
|
30
|
+
|
|
31
|
+
After an edit, call status for build/validation. For a change confined to known shots, use
|
|
32
|
+
`agentcut_review_plan` with `scope: "shot"` and their current clip IDs. It reads the project and
|
|
33
|
+
timeline together and returns concrete calls to existing capture and preview tools. It does not
|
|
34
|
+
render, edit, export or certify quality. Inspect and execute relevant calls in sequence.
|
|
35
|
+
|
|
36
|
+
The plan samples the changed shot's entrance, hold, exit and neighboring boundaries in all project
|
|
37
|
+
variants, including variant timing overrides. Add exact narration, action/result, focus, lift or
|
|
38
|
+
caption cue frames that the proposed samples miss. Samples are full frames, so overlays and nearby
|
|
39
|
+
content remain visible. Crop only for a detail diagnosis, never as the sole layout proof.
|
|
40
|
+
|
|
41
|
+
Use `agentcut_capture_frames` with explicit `frames` for small changed-shot probes. The existing
|
|
42
|
+
`agentcut_contact_sheet` also supports explicit `frames`, or inclusive `from`/`to` plus `every` for
|
|
43
|
+
a bounded sequence. The existing `agentcut_preview_check` supports `from`/`to`; check changed heavy
|
|
44
|
+
shots rather than replaying the whole video after every small revision. The planner splits its
|
|
45
|
+
preview suggestions into ranges of at most 60 seconds. These are suggestions, not passed checks.
|
|
46
|
+
|
|
47
|
+
Scope must broaden in these cases:
|
|
48
|
+
|
|
49
|
+
- A shared scene, component, asset, font, palette, style, layout helper or camera function changes:
|
|
50
|
+
use `scope: "shared"` unless every consumer is known and included. Check all affected variants.
|
|
51
|
+
- A clip moves, a trim/duration changes, a shot is removed, or music/voice/SFX timing changes:
|
|
52
|
+
use `scope: "timing"`. Check old and new boundaries, overlaps and sync; a current ID alone cannot
|
|
53
|
+
describe a removed shot. Re-read the timeline and regenerate the plan after further edits.
|
|
54
|
+
- The affected scope is uncertain, or a probe reveals a new problem outside the shot: widen the
|
|
55
|
+
review. A passed earlier check is stale for any range or variant affected by the new change.
|
|
56
|
+
|
|
57
|
+
Shared and timing plans broaden to full-project samples. Add focused transition/cue probes
|
|
58
|
+
where uniform sampling misses a critical moment. Unknown clip IDs in shot scope are errors, not
|
|
59
|
+
permission to skip them. Do not call a plan complete until its actual checks pass.
|
|
60
|
+
|
|
61
|
+
## Final review remains complete
|
|
62
|
+
|
|
63
|
+
Before hand-off, review full wide/mobile contact sheets and the complete story/procedure, confirm
|
|
64
|
+
readable actions and the actual success state, review captions, measure the mix and cue sync with
|
|
65
|
+
`agentcut_listen_critique`, and finish playback checks for heavy scenes. The planner always returns
|
|
66
|
+
`finalReviewRequired: true` and full-project picture/audio calls in each variant. Use current project
|
|
67
|
+
variants, including any user-added size. Follow the main skill's review and export rules.
|
|
68
|
+
|
|
69
|
+
Run page-heavy tasks sequentially. On timeout inspect `agentcut_status.page.activeWork` before retrying,
|
|
70
|
+
as `references/website-howto.md` requires. A smaller probe helps recover or diagnose; it cannot
|
|
71
|
+
replace final picture/sound checks or lower render quality.
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
# How-to
|
|
2
|
+
|
|
3
|
+
Help a viewer complete one real task and recognize success. Use this guide for the How-to action,
|
|
4
|
+
tutorial requests and software walkthrough videos. The user's brief, uploaded material, existing edit,
|
|
5
|
+
selected style and music take priority. This is not a fixed scene sequence or a promotional film.
|
|
6
|
+
|
|
7
|
+
## Establish the task before searching
|
|
8
|
+
|
|
9
|
+
The studio asks locally when the request is empty. If a bare request reaches the agent without a
|
|
10
|
+
task, brief, recording or relevant project material, ask immediately: "What should viewers learn to
|
|
11
|
+
do? Add a URL, recording, or a short description of the task." Stop before tool calls, source or
|
|
12
|
+
library searches, planning or rendering. A project name, generic earlier request, music choice or
|
|
13
|
+
unrelated shared stock does not establish a task. A known product alone may still lack a procedure.
|
|
14
|
+
|
|
15
|
+
This also applies when How-to is clicked while viewing a finished launch or another populated video.
|
|
16
|
+
The old edit, its incidental assets and prior launch conversation do not identify the new tutorial's
|
|
17
|
+
task. Ask locally before creating a destination or sending to the agent. An explicit current task,
|
|
18
|
+
genuinely established tutorial task, or material deliberately attached for the tutorial can proceed.
|
|
19
|
+
Keep project uploads available for inspection after the user answers; do not discard them.
|
|
20
|
+
|
|
21
|
+
With material, inspect the current project and attachments first. Read `references/format.md`,
|
|
22
|
+
`references/footage.md` for recordings, and `references/website-howto.md` for website execution and
|
|
23
|
+
tool recovery. Use media information, source frames and transcripts to find complete actions and
|
|
24
|
+
their results. Do not ask the user to repeat facts already in the brief or a visible recording.
|
|
25
|
+
If one crucial task detail remains missing, ask that one question and continue work that is clear.
|
|
26
|
+
When a user reply is required, state the exact missing input plainly, for example
|
|
27
|
+
"Question for you: Which voice should this use?" or "Still blocked: I need a recording of the task."
|
|
28
|
+
Do not bury the needed action beneath a long completion update or imply that generation continues.
|
|
29
|
+
|
|
30
|
+
## Obtain the real UI from a task-only brief
|
|
31
|
+
|
|
32
|
+
A request such as "how to add a style to Agentcut" supplies a task. Do not make the user also ask
|
|
33
|
+
for screenshots, captions or an edited video. Proactively obtain authentic evidence:
|
|
34
|
+
|
|
35
|
+
1. Check relevant captures or recordings already in the target project's assets and its supplied
|
|
36
|
+
source material. Reuse them only if they show the current labels, complete actions and success state.
|
|
37
|
+
2. Use the supplied or already-known product URL or an already-running local preview. Read the
|
|
38
|
+
relevant routes and control labels from configured source folders if that helps locate the task.
|
|
39
|
+
A source-code read locates controls; it is not a visual or proof that an action works. Do not
|
|
40
|
+
search the home folder for identity or start/restart the user's services as part of discovery.
|
|
41
|
+
3. Use an available permitted browser capture tool. Prefer a connected browser automation tool
|
|
42
|
+
when it supports actual screenshots/recording. Otherwise the helper includes `agent-browser`:
|
|
43
|
+
read `agent-browser skills get core` and its video-recording reference for the installed version,
|
|
44
|
+
use a named session, open the known URL, inspect the live controls, and take real screenshots or
|
|
45
|
+
a recording into the new video's `assets/`. Inspect before each action and re-inspect afterward.
|
|
46
|
+
The installed CLI supports `screenshot <path>` and `record start <path.webm> --cursor`, followed
|
|
47
|
+
by planned actions and `record stop`. Use only supported commands from its local documentation.
|
|
48
|
+
4. Demonstrate the requested task in prepared safe demo state, retaining the real pointer/action,
|
|
49
|
+
response and final success state. Do not modify the user's original video to make tutorial footage.
|
|
50
|
+
For Agentcut, use a disposable safe demo video rather than changing the completed launch. Reuse
|
|
51
|
+
existing captures if obtaining that safe state is not possible under the current permissions.
|
|
52
|
+
5. If sign-in, access, an unknown URL, blocked network permissions or capture capability prevents
|
|
53
|
+
this, ask for the smallest missing link or recording. The user signs in directly; never request
|
|
54
|
+
credentials, cookies or tokens. Do not fabricate screens, bypass a block, or claim code proves UI.
|
|
55
|
+
|
|
56
|
+
`agentcut_capture_frames` captures the edited composition, not an arbitrary website. The release-job
|
|
57
|
+
API still supports announcement only; do not submit a how-to job to it or pretend it captured a task.
|
|
58
|
+
After authentic material exists, add accurate captions or step labels without waiting for a separate
|
|
59
|
+
request, then build and review the editable tutorial. Preserve all earlier edits and source files.
|
|
60
|
+
|
|
61
|
+
## Plan for someone doing the task
|
|
62
|
+
|
|
63
|
+
Record in `notes.md`: the intended viewer, their starting state and prerequisites, the task they
|
|
64
|
+
will complete, and the visible evidence that confirms success. Show the direction in a few lines.
|
|
65
|
+
For example, "Create a project from a preset" needs the real starting screen, the preset selection,
|
|
66
|
+
the creation action and the newly opened project. A title that says "Easy presets" is not instruction.
|
|
67
|
+
|
|
68
|
+
Use a task title with a clear action. Start with the useful result or a brief orientation, then give
|
|
69
|
+
the minimum context needed to begin. Teach the actual procedure in its dependency order. Put any
|
|
70
|
+
necessary account, permission or prepared-file condition before the first action that needs it.
|
|
71
|
+
Do not turn the tutorial into a tour of every feature. Split distinct goals when the user requests
|
|
72
|
+
several tutorials; do not silently omit a required step to hit an arbitrary duration.
|
|
73
|
+
|
|
74
|
+
Build a flexible cue sheet. For each step note the source range or real captured view, exact control
|
|
75
|
+
label, action, visible reaction, focus region, text or narration cue and readable hold. Mark the
|
|
76
|
+
final state that proves success. Choose length from the requested duration and the time needed to
|
|
77
|
+
understand the steps. No duration slider or camera vocabulary is required from the user.
|
|
78
|
+
|
|
79
|
+
## Real actions and useful cues
|
|
80
|
+
|
|
81
|
+
- Use real screenshots and recordings from the current app or user material as the procedural
|
|
82
|
+
evidence. A screenshot can orient the viewer or show a result; it must not imply that an unseen
|
|
83
|
+
click was verified. Capture a missing transition or state clearly what remains unverified.
|
|
84
|
+
- Follow the main skill's website safety rules. Inspect before capture. Use safe sample content;
|
|
85
|
+
do not submit live messages, change settings or expose credentials to make a tutorial. If a write
|
|
86
|
+
action needs user preparation or authorization, explain the missing step. Do not invent it.
|
|
87
|
+
- Preserve actual labels, cursor targets, menu state, entry values and system feedback. Do not
|
|
88
|
+
replace procedural evidence with an imagined UI or pretend a decorative animation is a capture.
|
|
89
|
+
Any explanatory reconstruction must be clearly identified and must not be the only proof.
|
|
90
|
+
- Show where to act, the action, then its result. Give the viewer a stable pause at meaningful step
|
|
91
|
+
boundaries instead of relying on them to discover where to pause. Trim idle waits but retain
|
|
92
|
+
feedback that explains progress and completion. Speed up typing only when the entered value and
|
|
93
|
+
result remain clear. Keep important errors and their recovery when relevant to the task.
|
|
94
|
+
- Use a brief highlight, pointer or close-up on the relevant control as the instruction reaches it.
|
|
95
|
+
Do not cue several competing objects. Start wide enough for orientation, move to the detail,
|
|
96
|
+
then hold sharp and readable through the action and reaction. Follow cursor metadata when present
|
|
97
|
+
(`references/cursor.md`). Keep the current step and progress clear without excessive labels.
|
|
98
|
+
- Narration should explain the action as it appears. Use plain action words and exact UI labels.
|
|
99
|
+
Do not narrate a click several seconds before or after the visible action. For a silent tutorial,
|
|
100
|
+
place concise step instructions next to the demonstrated action and hold them long enough to read.
|
|
101
|
+
|
|
102
|
+
## Brand, library, motion and sound
|
|
103
|
+
|
|
104
|
+
Match the app's actual logos, fonts, colors and spacing. Discover useful existing project images,
|
|
105
|
+
B-roll, recordings, music and effects even when they are not chat attachments: list project `assets/`
|
|
106
|
+
with `agentcut_list_files`, then relevant shared library folders with `scope: "library"`. Follow
|
|
107
|
+
pagination and inspect relevant subfolders. Use `assets/...` and `library:...` media paths. Do not scan
|
|
108
|
+
other projects or every source directory to guess the task. Reuse known allowed source locations for
|
|
109
|
+
brand checks; if one is missing, ask instead of searching the home folder. Tell the user they can
|
|
110
|
+
drop a specific missing asset into the Library panel; a second chat attachment is not required.
|
|
111
|
+
|
|
112
|
+
Use B-roll only when it explains the task without hiding an essential step. Reuse existing components
|
|
113
|
+
and relevant assets; do not generate replacements by default. With website source available, inspect
|
|
114
|
+
the exact relevant components rather than reading the whole repository repeatedly.
|
|
115
|
+
|
|
116
|
+
Read `references/cinematic.md` when using camera depth or devices. Use existing `Device3D` hardware
|
|
117
|
+
for visible phones and computers. Smooth motion, backgrounds and restrained brand effects can frame
|
|
118
|
+
the tutorial, but essential UI must stay sharp, upright enough to read and clear of captions. Blur,
|
|
119
|
+
perspective and zoom should lead into a readable hold. Do not carry launch-film energy through every
|
|
120
|
+
instructional step. Keep optional backgrounds quiet during the action.
|
|
121
|
+
|
|
122
|
+
Read `references/sound.md`. Preserve a selected song; balance it below speech and keep busy music or
|
|
123
|
+
effects away from difficult steps. Use a small sound on a meaningful action, not every pointer move.
|
|
124
|
+
Caption narration accurately using the transcription workflow. Correct names, numbers and UI labels;
|
|
125
|
+
include meaningful non-speech audio when needed to understand the task. Captions must follow the
|
|
126
|
+
audio and avoid controls, results and the cursor target. Do not require voice for a silent brief.
|
|
127
|
+
|
|
128
|
+
## Success and review
|
|
129
|
+
|
|
130
|
+
Read `references/efficient-review.md`. Group independent file/guide reads and target changed shots
|
|
131
|
+
during revisions. Broaden after shared or timing changes; retain the complete final review below.
|
|
132
|
+
|
|
133
|
+
End at the real successful state. Tell the viewer what to check, for example the saved item appearing
|
|
134
|
+
in its list or an exported file opening correctly. An optional short "Try it with your own project"
|
|
135
|
+
prompt can encourage practice. Do not claim that an extra replay or recap guarantees learning.
|
|
136
|
+
|
|
137
|
+
Use the normal build and review loop: editable scene, text, footage and audio clips, status after
|
|
138
|
+
changes, source-frame checks, wide and mobile contact sheets, audio measurements and heavy-scene
|
|
139
|
+
playback checks. Check that a novice could follow every action without guessing a hidden step.
|
|
140
|
+
Check the order, cue timing, pointer visibility, label accuracy, reading time, final state and caption
|
|
141
|
+
placement. Retain both-format and sound review. Export only when requested.
|
|
142
|
+
|
|
143
|
+
Reuse current material and passed checks. Check changed regions first, then review the complete edit
|
|
144
|
+
in both formats. Run page-heavy checks in sequence as `website-howto.md` requires. If a tool stalls,
|
|
145
|
+
inspect active work before retrying. Record what passed and what remains blocked; do not claim a
|
|
146
|
+
build alone proves instructional accuracy.
|
|
147
|
+
|
|
148
|
+
## Evidence used for this guide
|
|
149
|
+
|
|
150
|
+
The application above is original Agentcut guidance, informed by these primary sources. These studies
|
|
151
|
+
do not establish a universal video length or guarantee an outcome for Agentcut users.
|
|
152
|
+
|
|
153
|
+
- [Software-training research (2013)](https://ris.utwente.nl/ws/portalfiles/portal/6827789/s4.pdf)
|
|
154
|
+
supports task-focused demonstrations, accurate interfaces and coordinated action and narration.
|
|
155
|
+
- [A controlled study of pause and navigation guidance (2022)](https://pmc.ncbi.nlm.nih.gov/articles/PMC9610327/)
|
|
156
|
+
supports explicit help for when to pause and review. Its experiment used educational material,
|
|
157
|
+
so applying it to software-step holds is a design inference.
|
|
158
|
+
- [A software-tutorial study of reviews (2018)](https://research.utwente.nl/en/publications/supporting-motivation-task-performance-and-retention-in-video-tut/)
|
|
159
|
+
found no extra benefit from its review or second-demonstration conditions. Keep recaps purposeful.
|
|
160
|
+
- [W3C caption guidance](https://www.w3.org/WAI/media/av/captions/) calls for synchronized, accurate
|
|
161
|
+
captions and correction of automatic output. This informs the caption review above.
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
# Product Launch
|
|
2
|
+
|
|
3
|
+
Make a product film that gives a specific audience one clear reason to care and a clear next step.
|
|
4
|
+
Use this guide for the Product Launch action and equivalent written requests. It works with an empty
|
|
5
|
+
project, uploaded footage, screenshots, an existing edit, or product context already in the chat.
|
|
6
|
+
The user's request takes priority. Keep their context, attachments, style, music and hand edits.
|
|
7
|
+
|
|
8
|
+
## Check product context first
|
|
9
|
+
|
|
10
|
+
If the request only asks for a launch video and has no product brief, URL, attached material,
|
|
11
|
+
project footage or relevant project assets, ask immediately: "What are you launching? Add a product
|
|
12
|
+
URL or a short description." Stop there. Do not call tools, scan the shared library or source folders,
|
|
13
|
+
search other projects, plan scenes or render to guess the product. A project name, a generic earlier
|
|
14
|
+
launch request, an assistant's unanswered intake question, music choice or shared library stock does
|
|
15
|
+
not establish product identity. The studio handles this empty intake locally without an agent call;
|
|
16
|
+
use this early exit when a bare request reaches you by another path.
|
|
17
|
+
|
|
18
|
+
Use genuinely established user context when present. With project footage or relevant project assets,
|
|
19
|
+
inspect that material first. Once the product is known, discover supporting library assets below.
|
|
20
|
+
If project material still cannot identify the product, ask the same short question instead of widening
|
|
21
|
+
the search to unrelated projects or sources. Keep the original launch request and the user's answer.
|
|
22
|
+
|
|
23
|
+
## Start with evidence
|
|
24
|
+
|
|
25
|
+
- Read the studio context, project files, notes and attached material. Inspect the current timeline
|
|
26
|
+
before changing it. Read `references/format.md` and `references/footage.md` when footage is present.
|
|
27
|
+
- Discover material beyond the chat attachments. Call `agentcut_list_files` with `scope: "project"`,
|
|
28
|
+
the active project slug and `path: "assets"`, then with `scope: "library"` and `path: ""`.
|
|
29
|
+
Follow `nextOffset` and open relevant subfolders; listings are not recursive. This includes items
|
|
30
|
+
dropped into the project Library panel without a chat attachment or timeline clip. Inspect relevant
|
|
31
|
+
images, B-roll, recordings, music and effects before fetching or generating replacements. Do not
|
|
32
|
+
assume every file is useful: match it to the benefit, brand and proof, then use the relevant items.
|
|
33
|
+
Project files use `assets/...`; shared files use `library:...` in media tools. Use
|
|
34
|
+
`agentcut_copy_file` with `scope: "library"` to copy a needed shared asset into project `assets/`
|
|
35
|
+
when required. With local disk access, inspect these same folders. Do not limit discovery to files
|
|
36
|
+
named in the message. If a specific required asset is missing, tell the user they can drop it into
|
|
37
|
+
the Library panel; re-list the files after they do. Do not require a second chat attachment.
|
|
38
|
+
- With recordings, use `agentcut_media_info`, sample frames and inspect transcripts when useful.
|
|
39
|
+
Find the actual action and visible result. Note useful source ranges, weak material and gaps.
|
|
40
|
+
Do this before proposing a story or asking the user to explain material you can inspect.
|
|
41
|
+
- From scratch, first establish the product from the user's brief or previous user context. Then use
|
|
42
|
+
the brief, existing project and library assets, product URL and allowed source
|
|
43
|
+
folders. Use `agentcut_sources` for configured folders. Do not require source code. Inspect what
|
|
44
|
+
is available before requesting more. A URL alone does not prove every product claim.
|
|
45
|
+
- Ask only for the minimum missing input that blocks an honest film. If the product is unknown,
|
|
46
|
+
ask for its name and a link or short description. If the intended viewer or next step cannot be
|
|
47
|
+
inferred, ask for the missing item in one short question. Do not send a blank questionnaire or
|
|
48
|
+
ask again for facts already supplied. State reasonable low-risk assumptions and continue.
|
|
49
|
+
- Never invent customer quotes, numbers, integrations, capabilities or UI evidence. If a required
|
|
50
|
+
claim lacks proof, narrow the claim to what is visible or ask for the missing material. Label
|
|
51
|
+
any user-approved illustration as an illustration. Follow the real-app capture safety rules in
|
|
52
|
+
the main skill when recording a website. Do not rebuild an app and present it as a real capture.
|
|
53
|
+
|
|
54
|
+
## Write a flexible brief
|
|
55
|
+
|
|
56
|
+
Record a short brief in `notes.md` and show the direction in two or three lines in chat:
|
|
57
|
+
|
|
58
|
+
- **Audience:** who needs this product, and the task or problem they recognize.
|
|
59
|
+
- **One benefit:** the single outcome this film will make clear, in the product's own language.
|
|
60
|
+
- **Proof:** for each claim, the exact source range, screenshot region or verified interaction that
|
|
61
|
+
demonstrates it. Pair the words with a visible action and result. Remove unsupported claims.
|
|
62
|
+
- **Next step:** one specific action, with the real destination or product name. Do not invent a URL.
|
|
63
|
+
- **Delivery:** use the requested format, duration and tone; infer sensible defaults from the use
|
|
64
|
+
case when they are absent. Let the amount of proof and reading time determine the cut length.
|
|
65
|
+
Honor a length stated in plain language. Do not require a duration slider or a length choice to start.
|
|
66
|
+
|
|
67
|
+
Consider at least two distinct openings before choosing one. Examples include a useful result first,
|
|
68
|
+
a recognizable problem with an immediate demonstration, a surprising verified detail, or a product
|
|
69
|
+
reveal with a short promise. Compare them against the available material and audience. Record the
|
|
70
|
+
choice and its reason in notes. Do not force a device orbit or logo reveal onto every film.
|
|
71
|
+
|
|
72
|
+
Build the story around the strongest proof. A shot can introduce the problem, show an action, reveal
|
|
73
|
+
the result or explain the next step; combine or omit these functions when the material supports it.
|
|
74
|
+
There is no required shot count, fixed order, duration per shot or mandatory sequence. Choose frame
|
|
75
|
+
ranges only after the story works. Each planned shot needs a purpose, source, claim, focus target,
|
|
76
|
+
readable hold and sound cue. Do not use decorative motion to conceal a missing demonstration.
|
|
77
|
+
|
|
78
|
+
## Brand and visual direction
|
|
79
|
+
|
|
80
|
+
- Inspect the repository or allowed product source, website and supplied assets for actual logos,
|
|
81
|
+
colors, typography, product names and UI. Reuse the brand assets and match their proportions,
|
|
82
|
+
clear space, spelling and color. Do not replace a real logo with typed text or an invented symbol.
|
|
83
|
+
- Show an integration only when the material or official product information verifies it. Use that
|
|
84
|
+
integration's official mark from supplied/repository assets or its official brand source. Do not
|
|
85
|
+
draw an approximate logo, imply an unverified partnership or add unrelated brand marks. If the
|
|
86
|
+
official asset is unavailable, use an accurate plain-text label or omit the mark.
|
|
87
|
+
- Read `references/cinematic.md` for its toolkit, camera guidance and quality gate. Use its existing
|
|
88
|
+
`Device3D` models whenever a phone, laptop or desktop device is visible. Check available library
|
|
89
|
+
models and their license rules. Do not draw flat hardware frames. Browser windows and frameless
|
|
90
|
+
detail views can use `Screen`; respect export rules and keep proof sharp.
|
|
91
|
+
- Use a purposeful pan to connect an action to its result, a zoom to reveal a relevant detail,
|
|
92
|
+
perspective to show useful depth, and lens or motion blur to guide attention during a move.
|
|
93
|
+
Choose the moves that serve this brief. Do not apply every effect to every shot. Settle the camera
|
|
94
|
+
and focus for readable holds; keep essential UI, claims and the next step legible in each format.
|
|
95
|
+
- For a website, choose the camera treatment automatically from the plain-language request and the
|
|
96
|
+
inspected page. Show enough of the full view to establish the product, move from wide to the detail
|
|
97
|
+
that proves the benefit, then pause in focus while the viewer reads the action and result. Adjust
|
|
98
|
+
the crop, perspective, move speed and hold to the actual content. The user does not need to name a
|
|
99
|
+
camera technique or open Cinematic Mode. Avoid a continuous fly-over that never lets the UI settle.
|
|
100
|
+
- Use `references/loops.md`, `references/craft.md` and the component catalog for brand-matched
|
|
101
|
+
backgrounds and editable graphics. Keep decoration below the product's visual priority.
|
|
102
|
+
|
|
103
|
+
The cinematic guide supplies tools and quality checks. Its suggested shot arc and example timings
|
|
104
|
+
do not replace this brief. Fit the edit to the product, evidence and user request.
|
|
105
|
+
|
|
106
|
+
## Sound and build
|
|
107
|
+
|
|
108
|
+
Read `references/sound.md`. Keep the user's selected music. Otherwise choose music that supports the
|
|
109
|
+
benefit, pace and brand. Analyze beats and meaningful onsets. Synchronize cuts, product actions,
|
|
110
|
+
reveals and result moments with the music where it helps the story. Put a sound effect on a meaningful
|
|
111
|
+
action or transition, not every camera movement. Keep voice and product sounds clear. Use the listen
|
|
112
|
+
tools and record measured mix results; do not claim to have heard the mix.
|
|
113
|
+
|
|
114
|
+
Follow the main skill's build and review loop. Build one beat at a time, keep footage trims, text,
|
|
115
|
+
music and SFX editable on separate timeline clips, and preserve user edits. Use real material for
|
|
116
|
+
proof; graphics can explain it but must not change what the product can do.
|
|
117
|
+
|
|
118
|
+
## Review before hand-off
|
|
119
|
+
|
|
120
|
+
Read `references/efficient-review.md`. Group independent file/guide reads, use changed-shot probes
|
|
121
|
+
for local revisions, and broaden for shared/timing changes. Keep all final picture and sound checks.
|
|
122
|
+
|
|
123
|
+
Check the whole film, not only attractive stills. Does the opening earn attention from this audience?
|
|
124
|
+
Can a new viewer name the benefit? Does each claim have visible real proof? Can they read the action
|
|
125
|
+
and result without pausing? Is the next step correct and clear? Remove shots that add no meaning.
|
|
126
|
+
|
|
127
|
+
Capture entrances, settled holds and exits in wide and mobile. Inspect full contact sheets, check
|
|
128
|
+
heavy scene playback, and review the mix and cue timing with the existing tools. Fix cropped logos,
|
|
129
|
+
blurred proof, tiny UI, weak contrast, abrupt moves and masking sound. Keep the cinematic quality gate
|
|
130
|
+
and normal preview/export checks. State any remaining evidence gaps. Hand off the editable draft;
|
|
131
|
+
export only when requested.
|
|
@@ -71,16 +71,20 @@ masters the rendered audio to −14 LUFS with a true-peak limiter (≤ −1 dBTP
|
|
|
71
71
|
what it did (`mastering`: rendered loudness, gain, limiter reduction). Large limiter reduction (> 3 dB)
|
|
72
72
|
means a few sounds are far louder than the rest: turn those clips down instead of relying on the limiter.
|
|
73
73
|
|
|
74
|
+
## Local voice default
|
|
75
|
+
|
|
76
|
+
Generic voice-over requests use **Kokoro**, even if paid keys are configured. Use paid generation only when the user explicitly requests or selects a paid provider. Preserve explicit provider, voice, language, gender and accent choices. Use `agentcut_voice_options` with provider `kokoro`: its 28 English voices share verified IDs with the human preview samples. `localVoices` includes authored female/male labels, language/accent and preview URLs. `suggestedUses` comes from ScreenSlick's director playbook: Heart for tutorials, Emma for walkthroughs, Bella for demos, Puck for launches and Michael for sales. These are editorial defaults, not measured tone. Do not invent calm/energetic labels. Audition or measure a sample when tone matters; honor constraints before these defaults.
|
|
77
|
+
|
|
78
|
+
The first local generation downloads about 93 MB plus support files. Later calls reuse the model cache. This runtime supports English only, speed 0.5–2, and no style instructions. For setup/offline/language errors, state the error and offer a retry, an English script, or an explicit provider choice. Never silently call paid. WAV output uses the same media-info, transcription, Voice track and word-timed caption workflow below.
|
|
79
|
+
|
|
74
80
|
## Voice-overs
|
|
75
81
|
|
|
76
|
-
|
|
77
|
-
Gemini, OpenAI or Grok/xAI). You never see, ask for or mention API keys: the helper adds them.
|
|
82
|
+
Kokoro is available without credentials. Optional paid providers are ElevenLabs, Gemini, OpenAI and Grok/xAI. The helper adds their keys only for explicitly selected paid generation.
|
|
78
83
|
|
|
79
84
|
1. `agentcut_voice_options`: which providers are set up, the default, models and voices. For
|
|
80
|
-
ElevenLabs pass `provider: "elevenlabs"` to get the account's voice ids.
|
|
81
|
-
to open **Voices** and add a key, and stop there.
|
|
85
|
+
ElevenLabs pass `provider: "elevenlabs"` to get the account's voice ids. Local Kokoro requires no key.
|
|
82
86
|
2. Write the script in `notes.md` first (one line per beat). Keep the spoken text clean: no stage directions.
|
|
83
|
-
3. `agentcut_generate_voice` with the user
|
|
87
|
+
3. `agentcut_generate_voice` with Kokoro unless the user explicitly selected a paid provider. Honor their voice/model choice. Generate 2 takes
|
|
84
88
|
for anything that matters. Delivery notes:
|
|
85
89
|
- Gemini, OpenAI: `style` ("confident tech launch announcer, upbeat, quick pace, smile on the call to
|
|
86
90
|
action"; pronunciations like "say V2 as 'vee two'"). Gemini voices: Puck (upbeat), Kore (firm),
|
|
@@ -7,6 +7,10 @@ and existing project choices take priority.
|
|
|
7
7
|
|
|
8
8
|
## Reuse working setup
|
|
9
9
|
|
|
10
|
+
Read `references/efficient-review.md` for grouped independent file/guide reads and changed-shot
|
|
11
|
+
revision checks. Use scoped plans only for intermediate work; retain full final picture/sound
|
|
12
|
+
review and broaden when shared components, media or timing affect other shots.
|
|
13
|
+
|
|
10
14
|
- Start from the known app URL, source folder and existing project notes. Reuse a working
|
|
11
15
|
preview, app build, captured evidence and generated assets when they are still current.
|
|
12
16
|
- Ask for a missing source location instead of searching the entire home folder and GitHub.
|