You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a6a9e2f
Browse filesBrowse the repository at this point in the historyBrowse files
* feat(skills): anchored-connector rule + source-traceable visuals doctrine
Two advisory rules absorbed from a community-skill comparison study
(4-cell sandbox replay vs geekjourneyx/hyperframes-motion-director;
ideas only — no upstream text, the repo is AGPL-3.0):
- Connector lines earn their place: any beam/rail/scan/underline must
name both anchors and its job (reveal/route/validate) or be cut.
Lands in motion-principles (composition) + svg-path-draw (constraints).
- Visuals point back to the source: when a video derives from concrete
material, each frame's key visual should trace to a specific source
line — real filenames/numbers over stock props. Lands as story-spine
rule 4; the four SKILL.md index lines that enumerate story-spine's
rules are synced.
Both are self-checks, not hard gates. lint:skills + skill-mirror green.
Co-Authored-By: Claude Fable 5 <[email protected]>
* fix(skills): regen stale manifest + add emphasize to connector job list
Review 4975048154 follow-ups:
- skills-manifest.json was hashed mid-commit before oxfmt renormalized
the four SKILL.md tables (lefthook pre-commit runs format and
skills-manifest in parallel — they raced). Regenerated at head;
second regen is a no-op.
- The connector rule's job list read literally would cut lines this
same doctrine prescribes (dividers, hairlines, underline_sweep):
emphasis was a missing job, not a forbidden one. Added 'emphasize'
to both motion-principles and svg-path-draw.
Co-Authored-By: Claude Fable 5 <[email protected]>
---------
Co-authored-by: Claude Fable 5 <[email protected]>
Copy file name to clipboardExpand all lines: skills/faceless-explainer/SKILL.md
+19-19Lines changed: 19 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -83,7 +83,7 @@ A faceless explainer usually has **no brand colors/fonts** (`tokens.json` colors
83
83
84
84
Goal: Turn the text into an approved frame-by-frame teaching plan.
85
85
86
-
Read `../hyperframes-creative/references/story-spine.md` (hook language, value-before-evidence, storyboard-as-proposal), `references/story-design.md`, `../hyperframes-animation/blueprints-index.md`, `../hyperframes-core/references/storyboard-format.md`, and `../hyperframes-core/references/script-format.md`. Use them to write `STORYBOARD.md` and, when narration is needed, `SCRIPT.md`. Set the frontmatter `duration:` from the brief's `length` — a rough expectation; assembly reports where the cut lands against it.
86
+
Read `../hyperframes-creative/references/story-spine.md` (hook language, value-before-evidence, storyboard-as-proposal, source-traceable visuals), `references/story-design.md`, `../hyperframes-animation/blueprints-index.md`, `../hyperframes-core/references/storyboard-format.md`, and `../hyperframes-core/references/script-format.md`. Use them to write `STORYBOARD.md` and, when narration is needed, `SCRIPT.md`. Set the frontmatter `duration:` from the brief's `length` — a rough expectation; assembly reports where the cut lands against it.
87
87
88
88
Use `story-design.md` for the explainer structure (concept / how-to / listicle / story), hook strategy, clarity techniques, emotional beats, the type-enum mapping, and `VO_MODE`. The video's sequence comes from **narrative design, not the input text's paragraph order** — reorder, merge, omit, compress. As a **soft guide**, consult the role→blueprint menu in `../hyperframes-animation/blueprints-index.md`: for each beat, write the voiceover in the shape its candidate blueprint implies and tag that candidate `blueprint:` id when one fits. Teaching truth still decides which beats exist — never force a beat to fit a blueprint, and never invent a beat just because a proven shape is available. Faceless visuals are invented downstream, so frames do **not** carry an asset inventory: leave `asset_candidates` empty unless the user supplied a real `public/<basename>` image. Use the exact required fields from the storyboard and script references.
89
89
@@ -213,21 +213,21 @@ Do not rerun `lint`, `check`, or `snapshot` after rendering unless the user asks
213
213
214
214
The reusable, domain-agnostic shot shapes live in `../hyperframes-animation/blueprints/` (indexed by `../hyperframes-animation/blueprints-index.md`).
|`[../hyperframes-core/references/brief-contract.md](../hyperframes-core/references/brief-contract.md)`| Gate types, mode derivation from `BRIEF.md`, field semantics. |
|`[../hyperframes-animation/rules-index.md](../hyperframes-animation/rules-index.md)` + `[../hyperframes-animation/rules/](../hyperframes-animation/rules/)`| Step 5: local rule recipe bodies for the cited motions. |
231
-
|`[../hyperframes-core/references/frame-worker-core.md](../hyperframes-core/references/frame-worker-core.md)`| Step 5: the shared worker contract (packet builder prepends it to the delta). |
232
-
|`[sub-agents/frame-worker.md](sub-agents/frame-worker.md)`| Step 5: the workflow's frame-worker delta. |
|`[../hyperframes-core/references/brief-contract.md](../hyperframes-core/references/brief-contract.md)`| Gate types, mode derivation from `BRIEF.md`, field semantics. |
|`[../hyperframes-animation/rules-index.md](../hyperframes-animation/rules-index.md)` + `[../hyperframes-animation/rules/](../hyperframes-animation/rules/)`| Step 5: local rule recipe bodies for the cited motions. |
231
+
|`[../hyperframes-core/references/frame-worker-core.md](../hyperframes-core/references/frame-worker-core.md)`| Step 5: the shared worker contract (packet builder prepends it to the delta). |
232
+
|`[sub-agents/frame-worker.md](sub-agents/frame-worker.md)`| Step 5: the workflow's frame-worker delta. |
Copy file name to clipboardExpand all lines: skills/hyperframes-animation/rules/svg-path-draw.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -115,6 +115,7 @@ Ease families are discrete choices: **stroke draws** use `power2.out` (a hand li
115
115
-**Dasharray/dashoffset = the measured `getTotalLength()`**, set at setup; requires the SVG in the DOM (inline SVG is fine; a loaded `<image>` SVG is not).
116
116
-**Complex paths**: if `getTotalLength()` looks wrong, overestimate slightly (`len * 1.05`) — too large is invisible at animation start; too small clips the end.
117
117
-**Stagger multi-path draws at ~70–80%** of the previous segment's duration.
118
+
-**A drawn line must land on something.** When the path is a connector (rail, beam, underline, callout) rather than a shape, both endpoints must sit on real elements and the draw must do a job — reveal, route, validate, or emphasize. A stroke that only decorates empty space reads as filler; attach it or cut it.
Copy file name to clipboardExpand all lines: skills/hyperframes-creative/references/motion-principles.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,6 +75,7 @@ You build for the web. Video frames are not pages.
75
75
-**Anchor to edges.** Pin content to left/top or right/bottom. Centered-and-floating is a web pattern.
76
76
-**Split frames.** Data panel on the left, content on the right. Top bar with metadata, full-width below. Zone-based layouts, not centered stacks.
77
77
-**Use structural elements.** Rules, dividers, border panels. They create paths for the eye and animate well (scaleX from 0).
78
+
-**Connector lines earn their place.** Any beam, rail, scan line, or drawn underline must be able to name its start anchor, its end anchor (real elements, not empty space), and its job — revealing, routing, validating, or emphasizing something. A line the frame can lose without losing meaning is decoration: cut it. An edge-lit component (a card's top highlight, a state dot) usually reads as more designed than a free-floating arc.
0 commit comments