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: one authority for shared craft, and a route with no dead ends

rpone16659292714c
diff --git a/.agents/skills/hypit/SKILL.md b/.agents/skills/hypit/SKILL.md
index 748794d1..2e3ec556 100644
--- a/.agents/skills/hypit/SKILL.md
+++ b/.agents/skills/hypit/SKILL.md
@@ -1,6 +1,6 @@
---
name: hypit
-description: Author, check, preview, build, inspect, and retrieve Hypit/SVML projects; configure runtimes and credentials; reconstruct reference videos; develop missing project-local author packages; and apply native video production playbooks. Use for the Hypit repository, SVML/SVS/SVRun authoring, reference-video reconstruction, package vocabulary, runtime operations, or video craft decisions.
+description: Author, check, preview, build, inspect, and retrieve Hypit/SVML projects; configure runtimes and credentials; reconstruct reference videos; develop missing project-local author packages; and apply native video production playbooks. Use for the Hypit repository, SVML/SVS/SVRun authoring, reconstruction, package vocabulary, runtime operations, or video craft decisions.
---
# Hypit
@@ -14,7 +14,7 @@ Keep `.svml` Author Source, `.svs` Recipe Source, `.svrun` Run Source, and
## Route
- Reference-video reconstruction, reverse engineering, shot/B-roll/overlay analysis, or recreating
- a video as Hypit source → read `references/reference-video/index.md`. This is the route whatever
+ a video as Hypit source → read `references/reconstruction/index.md`. This is the route whatever
the author calls it — reconstruct, reverse-engineer, recreate, replicate, clone, remake, copy,
rebuild, or the same idea in any language — and **a path to a video file, with or without words
around it, is this route** even when no verb is given at all. The path is the whole request: the
diff --git a/.agents/skills/hypit/agents/openai.yaml b/.agents/skills/hypit/agents/openai.yaml
index bd56af0d..ec88313f 100644
--- a/.agents/skills/hypit/agents/openai.yaml
+++ b/.agents/skills/hypit/agents/openai.yaml
@@ -1,4 +1,4 @@
interface:
display_name: "Hypit"
short_description: "Build SVML videos and reconstruct reference videos with CLI tools"
- default_prompt: "Use $hypit and route from SKILL.md. For reference-video reconstruction, read references/reference-video/index.md and every required child reference in order before running the three CLI commands or authoring sources."
+ default_prompt: "Use $hypit and route from SKILL.md. For reference-video reconstruction, read references/reconstruction/index.md and every required child reference in order before running the five CLI commands or authoring sources."
diff --git a/.agents/skills/hypit/references/local-author-package.md b/.agents/skills/hypit/references/local-author-package.md
index 9aaf8cce..17d32404 100644
--- a/.agents/skills/hypit/references/local-author-package.md
+++ b/.agents/skills/hypit/references/local-author-package.md
@@ -7,7 +7,7 @@ behavior differs. Never write an unknown tag before its package exists.
## Read the observation before deciding the package's shape
The observation is the contract, and it is read before the first line of the package — not assumed,
-not remembered, not rediscovered halfway. In the reference-video route the evidence for the element
+not remembered, not rediscovered halfway. In the reconstruction route the evidence for the element
this package owns lives in the shot observations (`type:` and `visual:` for its text and picture,
`persistent_systems` for its whole-reference life) and the word-level transcript. Read them.
diff --git a/.agents/skills/hypit/references/playbooks/craft/seedance-directing.md b/.agents/skills/hypit/references/playbooks/craft/seedance-directing.md
index ad5f9dca..ddebc540 100644
--- a/.agents/skills/hypit/references/playbooks/craft/seedance-directing.md
+++ b/.agents/skills/hypit/references/playbooks/craft/seedance-directing.md
@@ -2,7 +2,8 @@
## Build the prompt inputs
-1. Vendor one matching Kit into the project's `./kits/` directory.
+1. Vendor one matching Kit into the project's `./kits/` directory. `../../seedance-kits.md` lists the
+ seven shipped Kits, the dynamic slots each one requires and the ordered references it expects.
2. Import generic Text as `copy` and the vendored Kit under its own alias.
3. Put stable creative choices in a named SVS Recipe.
4. Render the Kit with `copy:Render`; connect only dynamic `dialogue`, `action`, `story`, or
diff --git a/.agents/skills/hypit/references/reference-video/continuity.md b/.agents/skills/hypit/references/reconstruction/continuity.md
similarity index 100%
rename from .agents/skills/hypit/references/reference-video/continuity.md
rename to .agents/skills/hypit/references/reconstruction/continuity.md
diff --git a/.agents/skills/hypit/references/reference-video/final-sources.md b/.agents/skills/hypit/references/reconstruction/final-sources.md
similarity index 100%
rename from .agents/skills/hypit/references/reference-video/final-sources.md
rename to .agents/skills/hypit/references/reconstruction/final-sources.md
diff --git a/.agents/skills/hypit/references/reference-video/index.md b/.agents/skills/hypit/references/reconstruction/index.md
similarity index 73%
rename from .agents/skills/hypit/references/reference-video/index.md
rename to .agents/skills/hypit/references/reconstruction/index.md
index 87b43761..9ec32238 100644
--- a/.agents/skills/hypit/references/reference-video/index.md
+++ b/.agents/skills/hypit/references/reconstruction/index.md
@@ -87,15 +87,33 @@ Before acting on the evidence, read these files completely in order:
1. `workflow.md` — CLI sequence, evidence flow and responsibility boundaries.
2. `continuity.md` — mandatory shot, overlay, B-roll, speaker, product and persistent-system rules.
-3. `../playbooks/craft/graphic-compositions.md` — what may be a base picture, when a full screen is
- one authored composition, and where a missing picture comes from.
-4. `../playbooks/craft/generated-dependencies.md` — what one generation owes another: the location,
- the split shot, the voice, the first frame, and the stretch too short to be a take.
-5. `../playbooks/craft/visual-continuity.md` — recurring anchors as explicit artifacts, one location
- generated once, and the reverse-view geometry that must hold across takes.
-6. `../playbooks/craft/production-gates.md` — images and takes generate and are reviewed in rounds,
- and accepted Records are pinned for reuse.
-7. `vocabulary.md` — existing-package selection, appearance-property resolution, and the route for a
+3. **Every craft file listed in the first item of `../playbooks/index.md`'s required load order — the
+ ones it marks always-read.** That list decides *which* files, and it grows: one added there is
+ required here from the moment it is added, whether or not it appears among the notes below.
+ Restating the set in this file is what once left a required craft file reachable from one route
+ and invisible to the other.
+
+ Its paths are written from `../playbooks/`, so a file it names as `craft/<name>.md` is
+ `../playbooks/craft/<name>.md` from here. Only that first item is meant: the same section goes on
+ to name Seedance directing, a format file and package READMEs conditionally, and none of those
+ conditions can even be evaluated before the evidence is in.
+
+ Read them in the order below, which is this route's rather than that list's — a reconstruction
+ needs to know what a picture *is* before what one generation owes another, and needs both long
+ before a Build is staged:
+ - `../playbooks/craft/graphic-compositions.md` — what may be a base picture, when a full screen is
+ one authored composition, and where a missing picture comes from.
+ - `../playbooks/craft/generated-dependencies.md` — what one generation owes another: the location,
+ the split shot, the voice, the first frame, and the stretch too short to be a take.
+ - `../playbooks/craft/frame-coverage.md` — what is on screen at every instant, and the edges
+ nobody chose.
+ - `../playbooks/craft/visual-continuity.md` — recurring anchors as explicit artifacts, one
+ location generated once, and the reverse-view geometry that must hold across takes.
+ - `../playbooks/craft/production-gates.md` — images and takes generate and are reviewed in rounds,
+ and accepted Records are pinned for reuse.
+
+ A file that list names and this one does not is read last, before `vocabulary.md`.
+4. `vocabulary.md` — existing-package selection, appearance-property resolution, and the route for a
real vocabulary gap.
Two more are required, at the point where they apply rather than now. Reading them here means
diff --git a/.agents/skills/hypit/references/reference-video/reconstruction-loop.md b/.agents/skills/hypit/references/reconstruction/reconstruction-loop.md
similarity index 100%
rename from .agents/skills/hypit/references/reference-video/reconstruction-loop.md
rename to .agents/skills/hypit/references/reconstruction/reconstruction-loop.md
diff --git a/.agents/skills/hypit/references/reference-video/vocabulary.md b/.agents/skills/hypit/references/reconstruction/vocabulary.md
similarity index 100%
rename from .agents/skills/hypit/references/reference-video/vocabulary.md
rename to .agents/skills/hypit/references/reconstruction/vocabulary.md
diff --git a/.agents/skills/hypit/references/reference-video/workflow.md b/.agents/skills/hypit/references/reconstruction/workflow.md
similarity index 98%
rename from .agents/skills/hypit/references/reference-video/workflow.md
rename to .agents/skills/hypit/references/reconstruction/workflow.md
index a798067d..5d7adda3 100644
--- a/.agents/skills/hypit/references/reference-video/workflow.md
+++ b/.agents/skills/hypit/references/reconstruction/workflow.md
@@ -58,6 +58,8 @@ by hand and do not ask a model to transcribe: the transcript is already there.
`{ text, start_seconds, end_seconds, score }`. A machine with no WhisperX service running reports
`status: "unavailable"` with a `reason` and prepares everything else; start the service with
`uv run --project services/whisperx --frozen hypit-whisperx-service` and prepare again.
+`../environment.md` covers diagnosing that service and the rest of the local toolchain when starting
+it is not enough.
When a completed preparation stage must be rerun, use one small `--redo` value: