Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs: open the Quickstart with where the name comes from
rpone62d82dc97135
diff --git a/docs/quickstart.md b/docs/quickstart.mdindex 557ecd9d..6915ae62 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -5,11 +5,33 @@ description: Install Narratage, compile a complete SVML video graph, and prepare# Quickstart-Narratage turns an SVML (Semantic Video Markup Language) author source — a `.svml` file — into a-visible execution graph. Before any model or external service runs, you can check the source, choose-a Run, and inspect the exact work it would require.+The name **Narratage** comes from a 1933 *New York Times* review of the film *The Power and the+Glory*. The critic coined the word to describe a then-new cinematic technique:+**Narration + Montage** — a narrator's voice carries the story forward while the screen assembles+a montage of scenes to match.-This page gets you to that first safe plan. It does not need API keys and does not make a paid call.+That is exactly what this system does. The author writes a narrated Script with semantic anchors,+and the compiler assembles generated video, captions, B-roll, text and audio into a finished film.+Words are the semantic spine; visual contributions remain independently authored Tracks. Author+Sources are written in SVML (Semantic Video Markup Language) and carry the `.svml` extension.++Narratage turns that source into a visible execution graph. Before any model or external service+runs, you can check the source, choose a Run, and inspect the exact work it would require. This+page gets you to that first safe plan: it needs no API keys and makes no paid call.++## Use the Narratage skill++If you use a coding agent, ask it to use the repository's `narratage` skill. The skill follows the+same files and commands; it does not introduce a separate workflow. Send it this:++```text+Install and use the narratage skill from this repository. Install the whole+.agents/skills/narratage folder, not only SKILL.md. Set up my environment, ask for only the API+keys required by my Runtime Profile, and guide me through authoring and building my first SVML+video.+```++Otherwise, work through the five steps below.## 1. Install the source workspace@@ -183,22 +205,3 @@ Follow the authoring path in order, or jump directly to the part you are changin| [Film & Rendering](./quickstart/composition.md) | Peer Track composition and explicit rendering || [Run Source & Builds](./quickstart/run.md) | Targets, reuse, Runtime Profiles, Builds and retrieval |-## Use the Narratage skill--If you use a coding agent, ask it to use the repository's `narratage` skill. The skill follows the-same files and commands; it does not introduce a separate workflow.--Send it this:--```text-Install and use the narratage skill from this repository. Install the whole-.agents/skills/narratage folder, not only SKILL.md. Set up my environment, ask for only the API-keys required by my Runtime Profile, and guide me through authoring and building my first SVML-video.-```--## Why the name--*Narratage* was coined for narration-driven montage: the narration carries the story while images-assemble around it. That is the original video form behind this project—words are the semantic-spine, and visual contributions remain independently authored Tracks.diff --git a/docs/zh/quickstart.md b/docs/zh/quickstart.mdindex e0723a8a..c0a09b1f 100644--- a/docs/zh/quickstart.md+++ b/docs/zh/quickstart.md@@ -5,11 +5,30 @@ description: 安装 Narratage,编译第一张完整的 SVML 视频图,并准# 快速开始-Narratage 把 SVML 作者源码编译成一张可见的执行图。在任何模型或外部服务开始工作之前,-你可以先检查源码、选择一次 Run,并看清这次 Build 究竟需要执行什么。-SVML 即 Semantic Video Markup Language,Author Source 的扩展名是 `.svml`。+**Narratage** 这个名字来自 1933 年《*New York Times*》对电影《*The Power and the+Glory*》的一篇影评。那位影评人造出这个词,用来描述当时的一种新兴电影手法:+**Narration + Montage** —— 旁白的声音推动故事前进,同时画面组接出与之呼应的蒙太奇。-本页先带你得到第一份安全的 Plan:不需要 API Key,也不会产生任何付费请求。+这套系统做的正是这件事。作者写下带有语义锚点的口播 Script,编译器则把生成的视频、字幕、B-roll、+文字与音频组装成一部完成的影片。文字是语义主轴,所有视觉内容以彼此平级的 Track 参与作品。+Author Source 使用 SVML(Semantic Video Markup Language)编写,扩展名为 `.svml`。++Narratage 把这份源码编译成一张可见的执行图。在任何模型或外部服务开始工作之前,你可以先检查源码、+选择一次 Run,并看清这次 Build 究竟需要执行什么。本页先带你得到第一份安全的 Plan:不需要 API Key,+也不会产生任何付费请求。++## 使用 Narratage skill++如果使用编程 Agent,可以要求它使用仓库中的 `narratage` skill。Skill 遵循的仍然是同一套文件和命令,+不会创造另一套工作流。把下面这段发给它:++```text+安装并使用这个仓库里的 narratage skill。要安装整个 .agents/skills/narratage 文件夹,+而不是只复制 SKILL.md。配置我的环境,只向我索取当前 Runtime Profile 实际需要的 API key,+然后带我完成第一支 SVML 视频的创作与 Build。+```++否则,按下面五个步骤依次进行。## 1. 安装源码工作区@@ -179,20 +198,3 @@ Endpoint 配置,但不会执行作者图。| [Film 与渲染](./quickstart/composition.md) | 平级 Track 合成与显式渲染 || [Run Source 与 Builds](./quickstart/run.md) | Targets、复用、Runtime Profile、Build 与取回结果 |-## 使用 Narratage skill--如果使用编程 Agent,可以要求它使用仓库中的 `narratage` skill。Skill 遵循的仍然是同一套文件和命令,-不会创造另一套工作流。--把下面这段发给它:--```text-安装并使用这个仓库里的 narratage skill。要安装整个 .agents/skills/narratage 文件夹,-而不是只复制 SKILL.md。配置我的环境,只向我索取当前 Runtime Profile 实际需要的 API key,-然后带我完成第一支 SVML 视频的创作与 Build。-```--## 名字的由来--*Narratage* 原本描述的是“叙述驱动的蒙太奇”:声音负责推动故事,画面围绕叙述组接。-这也是本项目最初的视频形态——文字是语义主轴,所有视觉内容以彼此平级的 Track 参与作品。