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(skill): connect close reading, shared understanding and service choices

kashorind1ec3e0efa41
diff --git a/skills/hypit/SKILL.md b/skills/hypit/SKILL.md
index e32451b3..edfbd433 100644
--- a/skills/hypit/SKILL.md
+++ b/skills/hypit/SKILL.md
@@ -22,11 +22,13 @@ your directed material; Author Packages express the composition; the Runtime run
Bring the sensibility the video calls for: quick internet wit, warmth, social intuition, restraint,
or playful absurdity. Let it shape your ideas, images, words, and performances. Through every style,
remain grounded, curious, imaginative, and discerning. Be perceptive about the whole, careful and
-honest about the details, and curious when something does not yet make sense. Look for connections
-that explain an unexpected choice. Draw on the relevant Skill references and keep what you learn
+honest about the details, and curious when something does not yet make sense. Let your understanding
+of the whole guide the close look, and let concrete details deepen or change that understanding.
+Look for connections that explain an unexpected choice. Draw on the relevant Skill references and keep what you learn
in the project files as you go. Speak in the user's language, with warmth and specifics from the
work. **Speak aloud as the work develops:** share concrete findings, the choices shaping the piece
-and progress toward delivery. Explain what the current evidence means and what you will examine next.
+and progress toward delivery. As you look closer, bring the meaning back into the conversation:
+what the detail contributes, how it changes your reading, and what it suggests for the new work.
When setup, generation or rendering takes time, explain what is running or what is holding up the
work. A question should make the user's actual choice clear; a progress update keeps them involved
as you carry out the commission.
@@ -127,10 +129,11 @@ Record the whole-piece explanation in Analysis and the timed details and their m
as you discover them. Compression means explaining the relationships precisely with fewer, better
ideas while preserving the details that make them work.
-Make that understanding visible along the way: share a concrete discovery, the passage being
-examined and what it suggests for this video. Once the reading supports a direction, show a concise
-account with representative frames or a labeled grid and the relationships worth preserving.
-This gives the user something tangible to respond to while execution continues under their choices.
+Make the growing understanding visible through concrete discoveries, representative frames or a
+word-labeled grid. Explain the direction these observations suggest and develop it as the reading
+deepens. The user can contribute taste and context while seeing both the idea and the care behind
+its realization. Detailed evidence stays in the project files; the conversation carries its meaning
+and the choices shaping the work.
The Brief holds the user's goal; the Treatment is your creative answer. Clone work often means
"make this with my face" or "use my product." Reconsider the argument, words, images and graphic
diff --git a/skills/hypit/references/creation/project-files.md b/skills/hypit/references/creation/project-files.md
index 50effbc3..6bc8e3c2 100644
--- a/skills/hypit/references/creation/project-files.md
+++ b/skills/hypit/references/creation/project-files.md
@@ -159,7 +159,9 @@ stage and can disappear when there is nothing useful to hand over.
Use these files as the working memory across conversations. Write discoveries and decisions into
their owning documents as the work develops, preserving both the explanation and its concrete
-details. Resume by reading the current project files and relevant Skill pages; use Progress to find
+details. Let provisional accounts grow with the understanding, keeping detailed evidence once and
+linking to its owner. Share the meaning of discoveries in conversation while the files retain the
+full account. Resume by reading the current project files and relevant Skill pages; use Progress to find
the next question and the saved evidence, Sources, Runs or Results to continue it. A new discovery
updates the account it changes so the next session inherits the improved understanding.
diff --git a/skills/hypit/references/creation/reference-video.md b/skills/hypit/references/creation/reference-video.md
index dd5f5bf4..456d82a4 100644
--- a/skills/hypit/references/creation/reference-video.md
+++ b/skills/hypit/references/creation/reference-video.md
@@ -20,7 +20,9 @@ these changes against the words, pauses or actions they serve. Explain what the
viewer: establishes a person, contrasts two claims, accumulates proof, amplifies a reaction, makes
a process legible, or hands attention to the next idea. Meaning directs the close look; the close
look supplies the detail needed to recreate the expression. Close reading also reveals purposes and
-connections that the first whole-piece impression missed.
+connections that the first whole-piece impression missed. An interpretation earns its usefulness
+by explaining the concrete choices; close observation becomes creative understanding when those
+choices connect to the piece's intention. Keep both growing together throughout the reading.
When a choice is puzzling, widen the view: relate it to the surrounding words, nearby events, earlier
appearances and later consequences. Consider what those connections could explain, then examine the
@@ -40,12 +42,13 @@ replace an item, add to a collection, or temporarily cover it. Document the syst
its changes in time. Camera boundaries help navigation; meaning and continuity determine which
things belong together.
-Speak aloud as the understanding develops: share a specific finding, its significance for this work
-and the next question being examined, while continuing the investigation. Once the direction is supported, present a
-short account of the reference's structure with representative frames or a word-labeled grid:
-what persists, what changes on which idea, and which relationships suit the user's adaptation.
-Analysis and Timeline retain the detailed evidence; the visible account helps the user assess your
-reading and contribute their taste. Routine progress does not require another approval.
+Speak aloud as the understanding develops. During a close look, explain what the discovered timing,
+placement or motion does for the viewer and how it informs the adaptation. Share representative
+frames or a word-labeled grid when they make that relationship tangible. Carry a provisional reading
+into the conversation, then explain how new evidence deepens or changes it. Articulating the
+connection also helps you notice where your explanation is still incomplete. Analysis and Timeline
+retain the detailed evidence; the conversation lets the user follow the developing interpretation
+and contribute their taste. Routine progress does not require another approval.
Build an account of behavior that can become an editable production. A fixed screen image may be
the evidence the passage needs; a changing comparison also needs its arrivals, states and handoffs.
@@ -57,6 +60,11 @@ when its person, product or wording changes, and which choices should be redesig
observed behavior before choosing how the target will implement it. A picture, text and motion that
work together may become one component; repeated appearances may be states of that same object.
+Follow the whole reference and account concretely for each distinct system and its changes.
+Repeated behavior can share an explanation, with its variations and handoffs located in time.
+Carry established understanding into direction and composition while pursuing the questions still
+open. Preserve those questions at their source times so the next view can sharpen the account.
+
## Make time visible
Use `hypit transcribe` when understanding a spoken reference. Its wording and word-level times give
diff --git a/skills/hypit/references/environment/model-and-provider.md b/skills/hypit/references/environment/model-and-provider.md
index 7bfa73e6..c7906cfc 100644
--- a/skills/hypit/references/environment/model-and-provider.md
+++ b/skills/hypit/references/environment/model-and-provider.md
@@ -43,6 +43,14 @@ are maintained on the [service-partner page](https://github.com/hypit-ai/hypit/b
A partner is an independent service with its own
account, pricing and API, and uses the same project-extension path as any other external service.
+Service choice and authentication method are different questions: HypiHub itself accepts OAuth or
+an API key. In a BYOK request, establish which service the user's key belongs to and what it supports.
+Compare the remaining work for the useful routes: available capabilities, adapter preparation,
+local setup, account requirements and usage cost. A ready suitable connection can carry the work
+forward. A new project Provider makes another service possible, but its API mapping and validation
+take real work; HypiHub's bundled integration can avoid that work. Recommend the route that fits
+the commission, explain the tradeoff, and carry the user's settled choice forward.
+
[Environment selection](profile.md#choose-the-practical-capability-path-with-the-user) owns readiness,
local preparation and account choices. Connect the capability needed next. For a spoken reference,
that may be WhisperX while the generation plan is still developing. Once the intended material is
diff --git a/skills/hypit/references/production/builds.md b/skills/hypit/references/production/builds.md
index b05d709f..075988f5 100644
--- a/skills/hypit/references/production/builds.md
+++ b/skills/hypit/references/production/builds.md
@@ -71,6 +71,10 @@ these details.
## Plan the selected Run
+`hypit plan` inspects an authored Run's execution demands. The creative direction shared with the
+user develops earlier from their request and reference evidence; it does not require a Run, a fully
+prepared environment or this command. Use the command when there is concrete execution to inspect.
+
Plan the actual Run after its reuse choices and requested changes are expressed:
```bash