Skip to content
Back to search

hyperframes-motion-director

Agent Skill for Chinese-first HyperFrames motion-video production from articles, products, websites, and README files.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/geekjourneyx--hyperframes-motion-director/badge.svg)](/listings/geekjourneyx--hyperframes-motion-director)

HTML

<a href="/listings/geekjourneyx--hyperframes-motion-director"><img src="/api/listings/geekjourneyx--hyperframes-motion-director/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add geekjourneyx/hyperframes-motion-director

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 150 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # HyperFrames Motion Director
  3. **An Agent Skill for planning, producing, and reviewing HyperFrames motion videos.**
  4. <img src="skills/hyperframes-motion-director/assets/banner.png" alt="HyperFrames Motion Director" width="100%">
  5. [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](./LICENSE)
  6. [![Agent Skill](https://img.shields.io/badge/Agent%20Skill-HyperFrames-c96442.svg)](./skills/hyperframes-motion-director/SKILL.md)
  7. [![Node.js](https://img.shields.io/badge/Node.js-18%2B-141413.svg)](https://nodejs.org/)
  8. </div>
  9. ## What It Is
  10. HyperFrames Motion Director is an Agent Skill for turning a product story, article, README, website, or launch message into a structured HyperFrames motion-video production.
  11. It defaults to Chinese-first vertical promo videos: `9:16`, `1080x1920`, concise screen copy, controlled visual assets, readable hold frames, and a review step before delivery.
  12. The skill keeps production in two phases:
  13. 1. Create a brief/design proposal and wait for confirmation.
  14. 2. Generate assets, build the composition, validate snapshots/renders, and write a review report.
  15. ## Install
  16. ```bash
  17. npx skills add geekjourneyx/hyperframes-motion-director
  18. ```
  19. ## Use
  20. After installation, ask your Agent for a HyperFrames motion video, product launch film, article-to-video piece, or kinetic typography promo.
  21. Example:
  22. ```text
  23. Turn this README into a 12-second Chinese vertical HyperFrames promo.
  24. Start with the brief/design proposal and wait for confirmation.
  25. ```
  26. ## Local Development
  27. Create a motion-video production scaffold from this repository:
  28. ```bash
  29. node skills/hyperframes-motion-director/scripts/create_project.mjs ./my-motion-film
  30. ```
  31. Create a project with timing and motion maps:
  32. ```bash
  33. node skills/hyperframes-motion-director/scripts/create_project.mjs ./my-motion-film --with-timing --with-motion
  34. ```
  35. ## Outputs
  36. The scaffold creates four core production files:
  37. ```text
  38. BRIEF_DESIGN_PROPOSAL.md Direction, format, visual plan, motion plan
  39. DESIGN.md Visual system, asset rules, layout contracts
  40. STORYBOARD.md Beats, screen copy, timing, transitions
  41. REVIEW_REPORT.md Checks, snapshots, issues, remaining risks
  42. ```
  43. It also creates three design-engineering contracts:
  44. ```text
  45. SCENE_SCHEMA.json Structured scenes, slots, layout contracts, timing, snapshots
  46. VECTOR_TEMPLATES.json Approved SVG scene systems, icon/decor rules, rejection tests
  47. MOTION_PRIMITIVES.json Approved GSAP/SVG/CSS motion vocabulary, plugin policy, selection rules
  48. ```
  49. Optional files:
  50. ```text
  51. BEAT_MAP.json Music, voiceover, or exact timing map
  52. MOTION_MAP.json GSAP choreography and transition map
  53. ```
  54. ## What It Enforces
  55. <img src="skills/hyperframes-motion-director/assets/features.png" alt="Background, typography, and motion layers" width="100%">
  56. - A confirmed brief before implementation.
  57. - Chinese vertical-video defaults, with documented overrides for other platforms.
  58. - Image Gen assets with a clear role, quiet text zone, crop-safe area, and local path.
  59. - Background and component counts derived from the actual story, product mechanism, and proof needs rather than a fixed quota.
  60. - Exact supplied style sources inspected directly, with a clear boundary between visual language and product narrative.
  61. - Independent vertical background plates plus source-driven component sheets, with separate hero generations added when needed.
  62. - Asset libraries checked for narrative-anchor, product-proof, and transition-carrier roles, plus distinct component combinations.
  63. - Named transparent cutouts, dark/light contact-sheet review, and a manifest that records accepted assets and revisions.
  64. - Text-over-background layout contracts before animation.
  65. - Scene schema, vector template, and motion primitive contracts before implementation.
  66. - GSAP choreography contracts: labels, position parameters, plugin registration, transform aliases, and performance rules.
  67. - Motion that guides attention instead of repeating static slide patterns.
  68. - Final-MP4 checks for composite-layer ownership, visible transparent-asset bounds, exported font fit, and entry/hold/exit frames.
  69. - Validation, snapshots, and review notes before final delivery.
  70. - Compact artifact writing: no self-talk, generic pitch language, or unrelated commentary.
  71. ## Validate This Skill
  72. Check the skill package:
  73. ```bash
  74. node skills/hyperframes-motion-director/scripts/check-structure.mjs
  75. ```
  76. Check a generated project:
  77. ```bash
  78. node skills/hyperframes-motion-director/scripts/check_assets.mjs <project-dir>
  79. node skills/hyperframes-motion-director/scripts/check_assets.mjs <project-dir> --strict
  80. node skills/hyperframes-motion-director/scripts/check_assets.mjs <project-dir> --require-premium-assets
  81. node skills/hyperframes-motion-director/scripts/validate_image_assets.mjs <project-dir>
  82. node skills/hyperframes-motion-director/scripts/validate_artifacts.mjs <project-dir>
  83. node skills/hyperframes-motion-director/scripts/validate_design_engineering.mjs <project-dir>
  84. ```
  85. For implemented HyperFrames compositions, also run the strongest checks supported by the local HyperFrames CLI, such as validate, inspect, snapshot, and render.
  86. ## Releases
  87. Stable tags publish GitHub Releases automatically after the tagged source passes the repository checks. A `main` push also repairs the newest stable tag when its Release is missing.
  88. See [RELEASING.md](RELEASING.md) for the complete release procedure and recovery rules.
  89. ## Repository Structure
  90. ```text
  91. skills/hyperframes-motion-director/SKILL.md Main Agent Skill instructions
  92. skills/hyperframes-motion-director/templates/ Brief, design, storyboard, review, schema, vector, motion maps
  93. skills/hyperframes-motion-director/references/ Workflow, visual standards, design engineering, GSAP choreography, layout, audio sync, stability
  94. skills/hyperframes-motion-director/scripts/ Project scaffold and validation helpers
  95. skills/hyperframes-motion-director/evals/ Trigger prompts and evaluation cases
  96. skills/hyperframes-motion-director/assets/ Skill and README visual assets
  97. ```
  98. ## Author
  99. - Website: [jieni.ai](https://jieni.ai)
  100. - GitHub: [geekjourneyx](https://github.com/geekjourneyx)
  101. - X: [@seekjourney](https://x.com/seekjourney)
  102. - WeChat Official Account: 极客杰尼
  103. ## License
  104. [GNU Affero General Public License v3.0](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.