Back to search
hyperframes-motion-director
SkillGitHub
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
Markdown
[](/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)
- <div align="center">
- # HyperFrames Motion Director
- **An Agent Skill for planning, producing, and reviewing HyperFrames motion videos.**
- <img src="skills/hyperframes-motion-director/assets/banner.png" alt="HyperFrames Motion Director" width="100%">
- [](./LICENSE)
- [](./skills/hyperframes-motion-director/SKILL.md)
- [](https://nodejs.org/)
- </div>
- ## What It Is
- 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.
- 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.
- The skill keeps production in two phases:
- 1. Create a brief/design proposal and wait for confirmation.
- 2. Generate assets, build the composition, validate snapshots/renders, and write a review report.
- ## Install
- ```bash
- npx skills add geekjourneyx/hyperframes-motion-director
- ```
- ## Use
- After installation, ask your Agent for a HyperFrames motion video, product launch film, article-to-video piece, or kinetic typography promo.
- Example:
- ```text
- Turn this README into a 12-second Chinese vertical HyperFrames promo.
- Start with the brief/design proposal and wait for confirmation.
- ```
- ## Local Development
- Create a motion-video production scaffold from this repository:
- ```bash
- node skills/hyperframes-motion-director/scripts/create_project.mjs ./my-motion-film
- ```
- Create a project with timing and motion maps:
- ```bash
- node skills/hyperframes-motion-director/scripts/create_project.mjs ./my-motion-film --with-timing --with-motion
- ```
- ## Outputs
- The scaffold creates four core production files:
- ```text
- BRIEF_DESIGN_PROPOSAL.md Direction, format, visual plan, motion plan
- DESIGN.md Visual system, asset rules, layout contracts
- STORYBOARD.md Beats, screen copy, timing, transitions
- REVIEW_REPORT.md Checks, snapshots, issues, remaining risks
- ```
- It also creates three design-engineering contracts:
- ```text
- SCENE_SCHEMA.json Structured scenes, slots, layout contracts, timing, snapshots
- VECTOR_TEMPLATES.json Approved SVG scene systems, icon/decor rules, rejection tests
- MOTION_PRIMITIVES.json Approved GSAP/SVG/CSS motion vocabulary, plugin policy, selection rules
- ```
- Optional files:
- ```text
- BEAT_MAP.json Music, voiceover, or exact timing map
- MOTION_MAP.json GSAP choreography and transition map
- ```
- ## What It Enforces
- <img src="skills/hyperframes-motion-director/assets/features.png" alt="Background, typography, and motion layers" width="100%">
- - A confirmed brief before implementation.
- - Chinese vertical-video defaults, with documented overrides for other platforms.
- - Image Gen assets with a clear role, quiet text zone, crop-safe area, and local path.
- - Background and component counts derived from the actual story, product mechanism, and proof needs rather than a fixed quota.
- - Exact supplied style sources inspected directly, with a clear boundary between visual language and product narrative.
- - Independent vertical background plates plus source-driven component sheets, with separate hero generations added when needed.
- - Asset libraries checked for narrative-anchor, product-proof, and transition-carrier roles, plus distinct component combinations.
- - Named transparent cutouts, dark/light contact-sheet review, and a manifest that records accepted assets and revisions.
- - Text-over-background layout contracts before animation.
- - Scene schema, vector template, and motion primitive contracts before implementation.
- - GSAP choreography contracts: labels, position parameters, plugin registration, transform aliases, and performance rules.
- - Motion that guides attention instead of repeating static slide patterns.
- - Final-MP4 checks for composite-layer ownership, visible transparent-asset bounds, exported font fit, and entry/hold/exit frames.
- - Validation, snapshots, and review notes before final delivery.
- - Compact artifact writing: no self-talk, generic pitch language, or unrelated commentary.
- ## Validate This Skill
- Check the skill package:
- ```bash
- node skills/hyperframes-motion-director/scripts/check-structure.mjs
- ```
- Check a generated project:
- ```bash
- node skills/hyperframes-motion-director/scripts/check_assets.mjs <project-dir>
- node skills/hyperframes-motion-director/scripts/check_assets.mjs <project-dir> --strict
- node skills/hyperframes-motion-director/scripts/check_assets.mjs <project-dir> --require-premium-assets
- node skills/hyperframes-motion-director/scripts/validate_image_assets.mjs <project-dir>
- node skills/hyperframes-motion-director/scripts/validate_artifacts.mjs <project-dir>
- node skills/hyperframes-motion-director/scripts/validate_design_engineering.mjs <project-dir>
- ```
- For implemented HyperFrames compositions, also run the strongest checks supported by the local HyperFrames CLI, such as validate, inspect, snapshot, and render.
- ## Releases
- 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.
- See [RELEASING.md](RELEASING.md) for the complete release procedure and recovery rules.
- ## Repository Structure
- ```text
- skills/hyperframes-motion-director/SKILL.md Main Agent Skill instructions
- skills/hyperframes-motion-director/templates/ Brief, design, storyboard, review, schema, vector, motion maps
- skills/hyperframes-motion-director/references/ Workflow, visual standards, design engineering, GSAP choreography, layout, audio sync, stability
- skills/hyperframes-motion-director/scripts/ Project scaffold and validation helpers
- skills/hyperframes-motion-director/evals/ Trigger prompts and evaluation cases
- skills/hyperframes-motion-director/assets/ Skill and README visual assets
- ```
- ## Author
- - Website: [jieni.ai](https://jieni.ai)
- - GitHub: [geekjourneyx](https://github.com/geekjourneyx)
- - X: [@seekjourney](https://x.com/seekjourney)
- - WeChat Official Account: 极客杰尼
- ## License
- [GNU Affero General Public License v3.0](./LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.