Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 23 additions & 7 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,28 @@
# AGENTS.md

This repo turns a short video into ONE stylized **captioned MP4** — subtitles across every spoken beat,
rendered over the real footage by `veed-engine-cli` (the veed render engine). It runs via the `open-edit` skill
(`.claude/skills/open-edit/SKILL.md`) — the golden master. The default (recipe-backed) run is
**scripted end to end** — recipes are compiled code (`refs/html/<id>/recipe.ts`), zero tokens at run time;
subagents remain only for the opt-in vision analysis (run when the user asks to refine the style); the
CREATIVE path face-1 (the user brought their own reference/brand/concept) is authored INLINE by the
orchestrator, and creative iteration on a delivered result is REMIXED inline.
This repo is a **video creation and editing system** powered by `veed-engine-cli` (the veed render engine).
It is not limited to captions: agents can edit, cut, and reframe footage; layer motion graphics and
visual elements (shapes, images, animations — not just text); turn slides or websites into video;
capture web pages; and compose rich stylized output over real footage.

**Video is not always required.** Work from stills, slides, websites, generated imagery, audio-only
sources, or pure motion graphics when that fits the ask — source footage is optional, not assumed.

**Use the full toolbox.** Reach for any video or image generating service, and any available MCP
server, when it helps — don't limit yourself to the local engine and recipe path.

**Be creative and fluid.** Try new ideas and avenues. Prototype, explore alternatives, and follow
promising directions rather than collapsing every ask onto the captioned-recipe default. Match the
ask; invent when the brief is open.

One common path is stylized captioned video via the `open-edit` skill
(`.claude/skills/open-edit/SKILL.md`) The default (recipe-backed)
caption run is **scripted end to end** — recipes are compiled code (`refs/html/<id>/recipe.ts`), zero
tokens at run time; subagents remain only for the opt-in vision analysis (run when the user asks to
refine the style); the CREATIVE path face-1 (the user brought their own reference/brand/concept) is
authored INLINE by the orchestrator, and creative iteration on a delivered result is REMIXED inline.
Treat captions as one capability among many — match the ask, and use the full engine surface when
the work calls for edits, motion graphics, or other compositions.

## To run a video
When the user says "run the open-edit skill on `<video.mp4>`", follow
Expand Down
10 changes: 6 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,12 @@
OpenEdit is an open-source, agent-driven editing pipeline that ships with VEED's HTML renderer — closed
source, but free to use.

There is no GUI and no timeline. The pipeline is driven entirely through your coding agent: it
transcribes the audio, designs a caption style for the footage, and renders the clip.

OpenEdit edits footage; it does not generate it. Supply your own source files.
There is no GUI and no timeline. The pipeline is driven entirely through your coding agent — edit,
cut, and reframe footage; layer motion graphics and visual elements; turn
slides or websites into video; capture web pages; and pull in any video/image generating service
or MCP server when it helps. Source video is optional: stills, slides, generated media, or pure
motion graphics are enough when the brief calls for it. Be creative and fluid — try new ideas
rather than collapsing every ask onto captions.

<a href="https://github.com/veedstudio/open-edit/releases/download/launch-examples/OpenEdit-16x9.mp4"><img src="docs/examples/openedit-launch.webp" alt="OpenEdit launch video" width="100%"></a>

Expand Down