Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

docs: restore the agent instruction and two Quickstart facts

rpone12314e49998b
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 965403ee..69333acb 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -5,8 +5,9 @@ description: Install Narratage, compile a complete SVML video graph, and prepare
# Quickstart
-Narratage turns an SVML author 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.
+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.
This page gets you to that first safe plan. It does not need API keys and does not make a paid call.
@@ -174,7 +175,7 @@ Follow the authoring path in order, or jump directly to the part you are changin
| Guide | What you will learn |
|---|---|
-| [Script](./quickstart/script.md) | Segments, speakers, Dual Text, Selections and Moments |
+| [Script](./quickstart/script.md) | Segments, Role Cues, Dual Text, Selections, Moments and text projections |
| [SVS Stylesheets](./quickstart/styles.md) | Reusable Recipes for captions, media, text and film |
| [Media & Generation](./quickstart/generation.md) | Images, audio, prompt text and explicit model components |
| [Timing & Assembly](./quickstart/timing.md) | Speech Spine, WhisperX, ProgramSpace and SemanticMap |
@@ -185,6 +186,15 @@ Follow the authoring path in order, or jump directly to the part you are changin
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
diff --git a/docs/zh/quickstart.md b/docs/zh/quickstart.md
index 97a19a1b..1aa63855 100644
--- a/docs/zh/quickstart.md
+++ b/docs/zh/quickstart.md
@@ -7,6 +7,7 @@ description: 安装 Narratage,编译第一张完整的 SVML 视频图,并准
Narratage 把 SVML 作者源码编译成一张可见的执行图。在任何模型或外部服务开始工作之前,
你可以先检查源码、选择一次 Run,并看清这次 Build 究竟需要执行什么。
+SVML 即 Semantic Video Markup Language,Author Source 的扩展名是 `.svml`。
本页先带你得到第一份安全的 Plan:不需要 API Key,也不会产生任何付费请求。
@@ -170,7 +171,7 @@ Endpoint 配置,但不会执行作者图。
| 指南 | 你会学到什么 |
|---|---|
-| [Script](./quickstart/script.md) | Segment、说话人、Dual Text、Selection 与 Moment |
+| [Script](./quickstart/script.md) | Segment、Role Cue、Dual Text、Selection、Moment 与文字投影 |
| [SVS 样式表](./quickstart/styles.md) | 字幕、Media、文字与 Film 的可复用 Recipe |
| [媒体与生成](./quickstart/generation.md) | 图片、音频、Prompt Text 与显式模型组件 |
| [时序与装配](./quickstart/timing.md) | Speech Spine、WhisperX、ProgramSpace 与 SemanticMap |
@@ -181,6 +182,14 @@ Endpoint 配置,但不会执行作者图。
如果使用编程 Agent,可以要求它使用仓库中的 `narratage` skill。Skill 遵循的仍然是同一套文件和命令,
不会创造另一套工作流。
+把下面这段发给它:
+
+```text
+安装并使用这个仓库里的 narratage skill。要安装整个 .agents/skills/narratage 文件夹,
+而不是只复制 SKILL.md。配置我的环境,只向我索取当前 Runtime Profile 实际需要的 API key,
+然后带我完成第一支 SVML 视频的创作与 Build。
+```
+
## 名字的由来
*Narratage* 原本描述的是“叙述驱动的蒙太奇”:声音负责推动故事,画面围绕叙述组接。
diff --git a/docs/zh/quickstart/script.md b/docs/zh/quickstart/script.md
index ef8b7b45..7baf4969 100644
--- a/docs/zh/quickstart/script.md
+++ b/docs/zh/quickstart/script.md
@@ -174,6 +174,9 @@ Moment 编译为包含 `Point[]` 的 `MomentSet` 值。Selection 和 Moment 共
## Slot
+> Script 解析器定义了 Slot 语法,但当前面向作者的 `<script>` Surface 尚未暴露绑定输入。
+> 不要在 `main.svml` 中写未绑定的 Slot,它会导致 `check` 失败。
+
用于模板化 Script 的变量插值:
```svml