Skip to content

Commit a6a9e2f

Browse files
feat(skills): anchored-connector rule + source-traceable visuals doctrine (#3354)
* 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]>
1 parent f0e6373 commit a6a9e2f

8 files changed

Lines changed: 88 additions & 80 deletions

File tree

‎skills-manifest.json‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
"files": 138
77
},
88
"faceless-explainer": {
9-
"hash": "8d3795c85481b4c3",
9+
"hash": "f37cb1dba2890b79",
1010
"files": 24
1111
},
1212
"figma": {
@@ -22,7 +22,7 @@
2222
"files": 17
2323
},
2424
"hyperframes-animation": {
25-
"hash": "4418a24093c4b1c1",
25+
"hash": "67d23c9507ebb1e8",
2626
"files": 121
2727
},
2828
"hyperframes-audio": {
@@ -38,7 +38,7 @@
3838
"files": 20
3939
},
4040
"hyperframes-creative": {
41-
"hash": "0068574ecd376e60",
41+
"hash": "87bc09ec744313c8",
4242
"files": 78
4343
},
4444
"hyperframes-keyframes": {
@@ -62,11 +62,11 @@
6262
"files": 132
6363
},
6464
"pr-to-video": {
65-
"hash": "01f46da1e17577ea",
65+
"hash": "8ea0227e18ab5fc6",
6666
"files": 30
6767
},
6868
"product-launch-video": {
69-
"hash": "085243ed9167a0aa",
69+
"hash": "e89a8d11d99b4edf",
7070
"files": 28
7171
},
7272
"remotion-to-hyperframes": {

‎skills/faceless-explainer/SKILL.md‎

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ A faceless explainer usually has **no brand colors/fonts** (`tokens.json` colors
8383

8484
Goal: Turn the text into an approved frame-by-frame teaching plan.
8585

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.
8787

8888
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.
8989

@@ -213,21 +213,21 @@ Do not rerun `lint`, `check`, or `snapshot` after rendering unless the user asks
213213

214214
The reusable, domain-agnostic shot shapes live in `../hyperframes-animation/blueprints/` (indexed by `../hyperframes-animation/blueprints-index.md`).
215215

216-
| Read | When |
217-
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
218-
| `[../hyperframes-core/references/brief-contract.md](../hyperframes-core/references/brief-contract.md)` | Gate types, mode derivation from `BRIEF.md`, field semantics. |
219-
| `[../hyperframes-creative/references/story-spine.md](../hyperframes-creative/references/story-spine.md)` | Step 3: story doctrine — hook language, value-before-evidence, proposal shape. |
220-
| `[../hyperframes-creative/frame-presets/](../hyperframes-creative/frame-presets/)` | Step 2: choose and adopt a frame preset. |
221-
| `[../hyperframes-creative/references/design-spec.md](../hyperframes-creative/references/design-spec.md)` | Step 2: apply brand tokens correctly. |
222-
| `[references/story-design.md](references/story-design.md)` | Step 3: plan the explainer story. |
223-
| `[../hyperframes-animation/blueprints-index.md](../hyperframes-animation/blueprints-index.md)` | Step 3: role→blueprint menu. Step 4: pick the shot shape. |
224-
| `[../hyperframes-core/references/storyboard-format.md](../hyperframes-core/references/storyboard-format.md)` | Step 3: write `STORYBOARD.md`. |
225-
| `[../hyperframes-core/references/script-format.md](../hyperframes-core/references/script-format.md)` | Step 3: write `SCRIPT.md`. |
226-
| `[../media-use/audio/references/tts.md](../media-use/audio/references/tts.md)` | Step 3.1: choose or understand TTS providers and voices. |
227-
| `[references/visual-design.md](references/visual-design.md)` | Step 4: write the frame's shot sequence (+ Layout vocabulary). |
228-
| `[references/motion-language.md](references/motion-language.md)` | Step 4: the motion vocabulary + the motion doctrine. |
229-
| `[references/cut-catalog.md](references/cut-catalog.md)` | Step 4-5: the cut catalog (worker builds within-frame seams). |
230-
| `[../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. |
233-
| `[../hyperframes-core/references/subagent-dispatch.md](../hyperframes-core/references/subagent-dispatch.md)` | Step 5: dispatch sub-agents safely. |
216+
| Read | When |
217+
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
218+
| `[../hyperframes-core/references/brief-contract.md](../hyperframes-core/references/brief-contract.md)` | Gate types, mode derivation from `BRIEF.md`, field semantics. |
219+
| `[../hyperframes-creative/references/story-spine.md](../hyperframes-creative/references/story-spine.md)` | Step 3: story doctrine — hook language, value-before-evidence, proposal shape, source-traceable visuals. |
220+
| `[../hyperframes-creative/frame-presets/](../hyperframes-creative/frame-presets/)` | Step 2: choose and adopt a frame preset. |
221+
| `[../hyperframes-creative/references/design-spec.md](../hyperframes-creative/references/design-spec.md)` | Step 2: apply brand tokens correctly. |
222+
| `[references/story-design.md](references/story-design.md)` | Step 3: plan the explainer story. |
223+
| `[../hyperframes-animation/blueprints-index.md](../hyperframes-animation/blueprints-index.md)` | Step 3: role→blueprint menu. Step 4: pick the shot shape. |
224+
| `[../hyperframes-core/references/storyboard-format.md](../hyperframes-core/references/storyboard-format.md)` | Step 3: write `STORYBOARD.md`. |
225+
| `[../hyperframes-core/references/script-format.md](../hyperframes-core/references/script-format.md)` | Step 3: write `SCRIPT.md`. |
226+
| `[../media-use/audio/references/tts.md](../media-use/audio/references/tts.md)` | Step 3.1: choose or understand TTS providers and voices. |
227+
| `[references/visual-design.md](references/visual-design.md)` | Step 4: write the frame's shot sequence (+ Layout vocabulary). |
228+
| `[references/motion-language.md](references/motion-language.md)` | Step 4: the motion vocabulary + the motion doctrine. |
229+
| `[references/cut-catalog.md](references/cut-catalog.md)` | Step 4-5: the cut catalog (worker builds within-frame seams). |
230+
| `[../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. |
233+
| `[../hyperframes-core/references/subagent-dispatch.md](../hyperframes-core/references/subagent-dispatch.md)` | Step 5: dispatch sub-agents safely. |

‎skills/hyperframes-animation/rules/svg-path-draw.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,7 @@ Ease families are discrete choices: **stroke draws** use `power2.out` (a hand li
115115
- **Dasharray/dashoffset = the measured `getTotalLength()`**, set at setup; requires the SVG in the DOM (inline SVG is fine; a loaded `<image>` SVG is not).
116116
- **Complex paths**: if `getTotalLength()` looks wrong, overestimate slightly (`len * 1.05`) — too large is invisible at animation start; too small clips the end.
117117
- **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.
118119

119120
## See also
120121

‎skills/hyperframes-creative/SKILL.md‎

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -29,23 +29,23 @@ For motion patterns, scene blueprints, transitions, and CSS marker effects, use
2929

3030
## Routing
3131

32-
| Topic | Read |
33-
| ----------------------------------------------------------------------------- | ---------------------------------------------- |
34-
| Adopt a ready-made frame-preset as `frame.md` (optional) | `frame-presets/` · `references/design-spec.md` |
35-
| Default palettes, motion, typography, lazy defaults to question | `references/house-style.md` |
36-
| Named style presets, mood-to-style routing | `references/visual-styles.md` |
37-
| Palette-specific color tokens | `palettes/*.md` |
38-
| Composition patterns — PiP, text-behind-subject, title card, slide show | `references/composition-patterns.md` |
39-
| Stats / infographic presentation | `references/data-in-motion.md` |
40-
| Structured expansion for open-ended prompts | `references/prompt-expansion.md` |
41-
| Video-medium density, scale, color, frame composition | `references/video-composition.md` |
42-
| Per-beat direction, rhythm planning, transition timing | `references/beat-direction.md` |
43-
| Post-authoring spec verification (colors, type, corners, spacing, depth) | `references/design-adherence.md` |
44-
| High-level motion guardrails and GSAP-quality rules | `references/motion-principles.md` |
45-
| Font selection, pairings, rendered-video type guardrails | `references/typography.md` |
46-
| Story doctrine — hook language, value-before-evidence, storyboard-as-proposal | `references/story-spine.md` |
47-
| Script pacing, tone, openings, number pronunciation | `references/narration.md` |
48-
| Precomputed audio bands mapped to motion | `references/audio-reactive.md` |
32+
| Topic | Read |
33+
| ------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
34+
| Adopt a ready-made frame-preset as `frame.md` (optional) | `frame-presets/` · `references/design-spec.md` |
35+
| Default palettes, motion, typography, lazy defaults to question | `references/house-style.md` |
36+
| Named style presets, mood-to-style routing | `references/visual-styles.md` |
37+
| Palette-specific color tokens | `palettes/*.md` |
38+
| Composition patterns — PiP, text-behind-subject, title card, slide show | `references/composition-patterns.md` |
39+
| Stats / infographic presentation | `references/data-in-motion.md` |
40+
| Structured expansion for open-ended prompts | `references/prompt-expansion.md` |
41+
| Video-medium density, scale, color, frame composition | `references/video-composition.md` |
42+
| Per-beat direction, rhythm planning, transition timing | `references/beat-direction.md` |
43+
| Post-authoring spec verification (colors, type, corners, spacing, depth) | `references/design-adherence.md` |
44+
| High-level motion guardrails and GSAP-quality rules | `references/motion-principles.md` |
45+
| Font selection, pairings, rendered-video type guardrails | `references/typography.md` |
46+
| Story doctrine — hook language, value-before-evidence, storyboard-as-proposal, source-traceable visuals | `references/story-spine.md` |
47+
| Script pacing, tone, openings, number pronunciation | `references/narration.md` |
48+
| Precomputed audio bands mapped to motion | `references/audio-reactive.md` |
4949

5050
## Scripts
5151

‎skills/hyperframes-creative/references/motion-principles.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,7 @@ You build for the web. Video frames are not pages.
7575
- **Anchor to edges.** Pin content to left/top or right/bottom. Centered-and-floating is a web pattern.
7676
- **Split frames.** Data panel on the left, content on the right. Top bar with metadata, full-width below. Zone-based layouts, not centered stacks.
7777
- **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.
7879

7980
## Image Motion Treatment
8081

0 commit comments

Comments
 (0)