From 60350f406466566cc72ca48c68036f9359010b8d Mon Sep 17 00:00:00 2001 From: Miao Yang Date: Thu, 15 Oct 2026 19:33:18 +0800 Subject: [PATCH 01/34] refactor(skills): fold six domain skills into hyperframes and media-use guides hyperframes-core, -animation, -keyframes, -creative and -studio move to skills/hyperframes/{core,animation,keyframes,creative,studio}/, and hyperframes-audio moves to skills/media-use/mix/. Each moved SKILL.md becomes a frontmatter-free GUIDE.md so installers that scan recursively for SKILL.md no longer see them as skills; the published list goes from 21 to 15. Relative links, code paths and skill-name mentions are rewritten to the new locations, the catalog surfaces, marketplace core-skills list, fallback core set, module-copy targets and skills-manifest.json follow, and `hyperframes skills update` now removes the retired skills (RETIRED_SKILLS) when they are still installed. Co-Authored-By: Claude Opus 5.5 (1M context) --- .claude-plugin/marketplace.json | 6 -- .github/workflows/ci.yml | 4 +- AGENTS.md | 2 +- CLAUDE.md | 12 ++-- README.md | 24 +++---- .../catalog/components/device-frame-stage.mdx | 2 +- docs/catalog/components/oversized-cursor.mdx | 2 +- .../catalog/components/overwhelm-surround.mdx | 2 +- docs/catalog/components/spring-pop.mdx | 2 +- docs/catalog/components/toggle-flip.mdx | 2 +- docs/catalog/components/touch-indicator.mdx | 2 +- .../migrating-to-hyperframes-lambda.mdx | 2 +- docs/guides/claude-design-hyperframes.md | 6 +- docs/guides/gsap-animation.mdx | 2 +- docs/guides/skills.mdx | 2 +- docs/packages/cli.mdx | 2 +- docs/prompting/anatomy.mdx | 2 +- docs/prompting/overview.mdx | 8 +-- packages/cli/src/browser/manager.test.ts | 2 +- packages/cli/src/browser/manager.ts | 2 +- .../src/commands/contrast-audit.browser.js | 2 +- packages/cli/src/commands/contrast-fg.ts | 2 +- packages/cli/src/commands/contrast-sample.ts | 2 +- .../cli/src/commands/coreSkillContent.test.ts | 6 +- packages/cli/src/commands/skills.test.ts | 33 ++++++++-- packages/cli/src/docs/data-attributes.md | 2 +- packages/cli/src/templates/_shared/AGENTS.md | 4 +- packages/cli/src/templates/_shared/CLAUDE.md | 4 +- packages/cli/src/utils/skillsManifest.test.ts | 60 +++++++++++++++++- packages/cli/src/utils/skillsManifest.ts | 27 ++++++-- packages/cli/src/utils/skillsMirror.test.ts | 6 +- packages/core/src/audioFxPresets.ts | 2 +- .../editor/domEditingAgentPrompt.test.ts | 4 +- .../editor/domEditingAgentPrompt.ts | 2 +- .../src/utils/previewSafeMargins.test.ts | 6 +- .../components/device-frame-stage/demo.html | 2 +- .../device-frame-stage.html | 2 +- .../oversized-cursor/oversized-cursor.html | 2 +- .../overwhelm-surround.html | 2 +- .../components/spring-pop/registry-item.json | 2 +- .../components/spring-pop/spring-pop.html | 2 +- .../components/toggle-flip/toggle-flip.html | 2 +- .../touch-indicator/touch-indicator.html | 2 +- scripts/animejs-v4-guidance.test.mjs | 4 +- scripts/creator-editing-capabilities.test.mjs | 54 ++++++++++------ scripts/creator-editing-recipes.test.mjs | 14 ++-- scripts/generate-skill-module-copies.mjs | 2 +- scripts/test-skills-fresh.sh | 2 +- skills-manifest.json | 54 +++++----------- .../modes/standard/_anatomy.md | 6 +- .../modes/standard/_motion.md | 2 +- .../references/aesthetic-principles.md | 2 +- skills/embedded-captions/references/rail.md | 2 +- skills/faceless-explainer/SKILL.md | 24 +++---- .../references/cut-catalog.md | 2 +- .../references/motion-language.md | 10 +-- .../references/story-design.md | 4 +- .../references/visual-design.md | 30 ++++----- .../scripts/build-frame.mjs | 2 +- .../scripts/captions.test.mjs | 4 +- .../scripts/frame-packets.mjs | 2 +- .../scripts/lib/transition-registry.mjs | 2 +- .../scripts/lib/transitions.json | 2 +- .../sub-agents/frame-worker.md | 2 +- skills/general-video/SKILL.md | 44 ++++++------- .../general-video/scripts/frame-packets.mjs | 2 +- .../general-video/sub-agents/frame-worker.md | 2 +- skills/hyperframes-cli/references/cloud.md | 4 +- skills/hyperframes-cli/references/cloudrun.md | 2 +- .../references/init-and-scaffold.md | 6 +- skills/hyperframes-cli/references/lambda.md | 2 +- .../hyperframes-keyframes/agents/openai.yaml | 4 -- .../references/discovery.md | 4 +- .../animation/GUIDE.md} | 17 ++--- .../animation}/adapters/animate-text.md | 2 +- .../animation}/adapters/animejs.md | 0 .../animation}/adapters/css-animations.md | 0 .../adapters/gsap-easing-and-stagger.md | 0 .../adapters/gsap-timeline-and-labels.md | 0 .../adapters/gsap-transforms-and-perf.md | 0 .../animation}/adapters/gsap.md | 8 +-- .../adapters/html-in-canvas-patterns.md | 0 .../animation}/adapters/lottie.md | 0 .../animation}/adapters/three.md | 0 .../animation}/adapters/typegpu.md | 0 .../animation}/adapters/waapi.md | 0 .../animation}/blueprints-index.md | 2 +- .../blueprints/agent-progress-theater.md | 0 .../animation}/blueprints/camera-journey.md | 0 .../animation}/blueprints/comparison-split.md | 0 .../blueprints/constellation-hub.md | 0 .../animation}/blueprints/cta-morph-press.md | 0 .../animation}/blueprints/cursor-ui-demo.md | 0 .../animation}/blueprints/dataviz-countup.md | 0 .../blueprints/device-surface-showcase.md | 2 +- .../blueprints/fixed-anchor-cycle.md | 0 .../blueprints/grid-card-assemble.md | 0 .../blueprints/kinetic-type-beats.md | 0 .../blueprints/logo-assemble-lockup.md | 2 +- .../blueprints/overwhelm-surround.md | 0 .../blueprints/panel-edit-live-sync.md | 4 +- .../blueprints/prompt-type-submit-generate.md | 2 +- .../blueprints/spatial-pan-stations.md | 0 .../animation}/blueprints/ticker-takeover.md | 0 .../animation}/blueprints/titlecard-reveal.md | 0 .../transcript-scroll-artifact-reveal.md | 0 .../blueprints/typewriter-reveal.md | 0 .../animation}/blueprints/video-text-pivot.md | 0 .../blueprints/zoom-out-workspace-reveal.md | 2 +- .../examples/brand-reveal-assemble-zoom.html | 0 .../examples/comparison-split-cards.html | 0 .../examples/concept-demo-decode-pan.html | 0 .../animation}/examples/cta-morph-press.html | 0 .../examples/cta-orbit-collapse.html | 0 .../examples/demo-page-scroll-spotlight.html | 0 .../examples/hook-counter-burst.html | 0 .../examples/messaging-multi-phrase.html | 0 .../examples/metric-video-text-pivot.html | 0 .../examples/problem-mockup-overwhelm.html | 0 .../animation}/examples/proof-logo-chain.html | 0 .../examples/takeover-ticker-displace.html | 0 .../examples/workflow-approve-press.html | 0 .../animation}/references/motion-blur.md | 2 +- .../animation}/rules-index.md | 4 +- .../animation}/rules/3d-camera-flight.md | 0 .../animation}/rules/3d-page-scroll.md | 0 .../animation}/rules/3d-text-depth-layers.md | 2 +- .../animation}/rules/ai-tracking-box.md | 2 +- .../animation}/rules/ambient-glow-bloom.md | 0 .../rules/anchored-layout-expand.md | 6 +- .../animation}/rules/asr-keyword-glow.md | 2 +- .../animation}/rules/avatar-cloud-network.md | 2 +- .../rules/camera-cursor-tracking.md | 0 .../animation}/rules/card-morph-anchor.md | 2 +- .../rules/center-outward-expansion.md | 2 +- .../animation}/rules/chart-scrub-readout.md | 0 .../animation}/rules/chromatic-glitch.md | 2 +- .../rules/context-sensitive-cursor.md | 2 +- .../animation}/rules/control-target-sync.md | 0 .../rules/coordinate-target-zoom.md | 0 .../rules/counting-dynamic-scale.md | 2 +- .../animation}/rules/css-marker-patterns.md | 2 +- .../animation}/rules/cursor-click-ripple.md | 0 .../animation}/rules/cursor-drag.md | 0 .../animation}/rules/depth-of-field-blur.md | 0 .../rules/depth-scatter-assemble.md | 2 +- .../rules/discrete-text-sequence.md | 2 +- .../rules/dynamic-content-sequencing.md | 2 +- .../animation}/rules/gradient-text-sweep.md | 2 +- .../animation}/rules/gsap-effects.md | 6 +- .../animation}/rules/hacker-flip-3d.md | 2 +- .../animation}/rules/kinetic-beat-slam.md | 4 +- .../animation}/rules/motion-blur-streak.md | 0 .../rules/multi-cursor-choreography.md | 0 .../animation}/rules/multi-phase-camera.md | 0 .../animation}/rules/nudge-curve.md | 0 .../animation}/rules/orbit-3d-entry.md | 2 +- .../animation}/rules/particle-burst.md | 2 +- .../rules/physics-press-reaction.md | 0 .../animation}/rules/press-release-spring.md | 0 .../animation}/rules/reactive-displacement.md | 0 .../animation}/rules/scale-swap-transition.md | 0 .../animation}/rules/sine-wave-loop.md | 0 .../animation}/rules/split-tilt-cards.md | 2 +- .../animation}/rules/spring-pop-entrance.md | 2 +- .../animation}/rules/stat-bars-and-fills.md | 4 +- .../animation}/rules/svg-icon-enrichment.md | 0 .../animation}/rules/svg-path-draw.md | 0 .../animation}/rules/theme-crossfade-morph.md | 2 +- .../rules/vertical-spring-ticker.md | 2 +- .../animation}/rules/viewport-change.md | 0 .../animation}/rules/waterfall-entry.md | 0 .../scripts/animation-map-sampling.mjs | 0 .../scripts/animation-map-sampling.test.mjs | 0 .../animation}/scripts/animation-map.mjs | 2 +- .../animation}/scripts/animation-map.test.mjs | 12 ++-- .../animation}/scripts/package-loader.mjs | 0 .../scripts/package-loader.test.mjs | 0 .../animation}/techniques.md | 4 +- .../transitions/TRANSITION-REGISTRY.md | 0 .../animation}/transitions/catalog.md | 0 .../animation}/transitions/css-3d.md | 0 .../animation}/transitions/css-blur.md | 0 .../animation}/transitions/css-cover.md | 0 .../animation}/transitions/css-destruction.md | 0 .../animation}/transitions/css-dissolve.md | 0 .../animation}/transitions/css-distortion.md | 0 .../animation}/transitions/css-grid.md | 0 .../animation}/transitions/css-light.md | 0 .../animation}/transitions/css-mechanical.md | 0 .../animation}/transitions/css-other.md | 0 .../animation}/transitions/css-push.md | 0 .../animation}/transitions/css-radial.md | 0 .../animation}/transitions/css-scale.md | 0 .../animation}/transitions/overview.md | 2 +- .../SKILL.md => hyperframes/core/GUIDE.md} | 13 ++-- .../core}/references/composition-patterns.md | 2 +- .../references/creator-editing-recipes.md | 36 +++++------ .../core}/references/data-attributes.md | 2 +- .../core}/references/determinism-rules.md | 4 +- .../core}/references/full-screen-motion.md | 0 .../core}/references/minimal-composition.md | 0 .../core}/references/sub-compositions.md | 0 .../core}/references/tailwind.md | 0 .../core}/references/tracks-and-clips.md | 2 +- .../core}/references/variables-and-media.md | 0 .../creative/GUIDE.md} | 21 +++--- .../frame-presets/biennale-yellow/FRAME.md | 0 .../biennale-yellow/caption-skin.html | 0 .../biennale-yellow/frame-showcase.html | 0 .../frame-presets/blockframe/FRAME.md | 0 .../blockframe/caption-skin.html | 0 .../blockframe/frame-showcase.html | 0 .../frame-presets/blue-professional/FRAME.md | 0 .../blue-professional/caption-skin.html | 0 .../blue-professional/frame-showcase.html | 0 .../frame-presets/bold-poster/FRAME.md | 0 .../bold-poster/caption-skin.html | 0 .../bold-poster/frame-showcase.html | 0 .../frame-presets/broadside/FRAME.md | 0 .../frame-presets/broadside/caption-skin.html | 0 .../broadside/frame-showcase.html | 0 .../creative}/frame-presets/capsule/FRAME.md | 0 .../frame-presets/capsule/caption-skin.html | 0 .../frame-presets/capsule/frame-showcase.html | 0 .../frame-presets/cartesian/FRAME.md | 0 .../frame-presets/cartesian/caption-skin.html | 0 .../cartesian/frame-showcase.html | 0 .../frame-presets/cobalt-grid/FRAME.md | 0 .../cobalt-grid/caption-skin.html | 0 .../cobalt-grid/frame-showcase.html | 0 .../frame-presets/code-editorial/FRAME.md | 2 +- .../code-editorial/caption-skin.html | 0 .../code-editorial/fonts/EBGaramond-400.woff2 | Bin .../code-editorial/fonts/EBGaramond-700.woff2 | Bin .../code-editorial/fonts/Inter-400.woff2 | Bin .../code-editorial/fonts/Inter-700.woff2 | Bin .../fonts/JetBrainsMono-400.woff2 | Bin .../fonts/JetBrainsMono-700.woff2 | Bin .../code-editorial/fonts/OFL-eb-garamond.txt | 0 .../code-editorial/fonts/OFL-inter.txt | 0 .../fonts/OFL-jetbrains-mono.txt | 0 .../code-editorial/frame-showcase.html | 0 .../creative}/frame-presets/coral/FRAME.md | 0 .../frame-presets/coral/caption-skin.html | 0 .../frame-presets/coral/frame-showcase.html | 0 .../frame-presets/creative-mode/FRAME.md | 0 .../creative-mode/caption-skin.html | 0 .../creative-mode/frame-showcase.html | 0 .../frame-presets/daisy-days/FRAME.md | 0 .../daisy-days/caption-skin.html | 0 .../daisy-days/frame-showcase.html | 0 .../frame-presets/editorial-forest/FRAME.md | 0 .../editorial-forest/caption-skin.html | 0 .../editorial-forest/frame-showcase.html | 0 .../creative}/palettes/bold-energetic.md | 0 .../creative}/palettes/clean-corporate.md | 0 .../creative}/palettes/dark-premium.md | 0 .../creative}/palettes/jewel-rich.md | 0 .../creative}/palettes/monochrome.md | 0 .../creative}/palettes/nature-earth.md | 0 .../creative}/palettes/neon-electric.md | 0 .../creative}/palettes/pastel-soft.md | 0 .../creative}/palettes/warm-editorial.md | 0 .../creative}/references/audio-reactive.md | 0 .../creative}/references/beat-direction.md | 6 +- .../references/composition-patterns.md | 0 .../creative}/references/data-in-motion.md | 0 .../creative}/references/design-adherence.md | 0 .../creative}/references/design-picker.md | 0 .../creative}/references/design-spec.md | 0 .../creative}/references/house-style.md | 0 .../creative}/references/motion-principles.md | 0 .../creative}/references/narration.md | 0 .../creative}/references/prompt-expansion.md | 0 .../creative}/references/story-spine.md | 0 .../creative}/references/storyboard-recipe.md | 0 .../creative}/references/typography.md | 0 .../creative}/references/video-composition.md | 0 .../creative}/references/visual-styles.md | 0 .../creative}/scripts/contrast-report.mjs | 2 +- .../creative}/scripts/extract-audio-data.py | 0 .../creative}/scripts/package-loader.mjs | 0 .../creative}/scripts/package-loader.test.mjs | 0 .../creative}/templates/design-picker.html | 0 .../keyframes/GUIDE.md} | 33 ++++------ .../references/keyframe-patterns.md | 0 .../hyperframes/references/capability-menu.md | 40 ++++++------ .../references/frame-worker-core.md | 6 +- .../references/intent-interview.md | 6 +- .../hyperframes/references/production-loop.md | 24 +++---- skills/hyperframes/references/review-loop.md | 4 +- .../references/storyboard-format.md | 2 +- .../SKILL.md => hyperframes/studio/GUIDE.md} | 24 ++----- .../audio/references/captions/authoring.md | 4 +- .../audio/references/captions/motion.md | 10 +-- .../SKILL.md => media-use/mix/GUIDE.md} | 23 ++----- .../mix}/references/attributes.md | 0 .../mix}/references/diagnosis.md | 0 .../mix}/references/fx-registry.md | 0 .../mix}/references/presets.md | 0 .../mix}/scripts/carve.mjs | 0 .../mix}/scripts/carve.test.mjs | 0 .../mix}/scripts/lib/main-module.mjs | 0 skills/media-use/references/operations.md | 2 +- skills/motion-graphics/SKILL.md | 8 +-- skills/motion-graphics/agents/builder.md | 4 +- skills/motion-graphics/agents/director.md | 2 +- .../categories/charts/module.md | 2 +- .../motion-graphics/categories/stat/module.md | 4 +- .../categories/webpage/module.md | 2 +- skills/music-to-video/SKILL.md | 8 +-- skills/music-to-video/references/montage.md | 2 +- skills/music-to-video/references/planning.md | 6 +- .../music-to-video/sub-agents/frame-worker.md | 4 +- skills/pr-to-video/SKILL.md | 20 +++--- skills/pr-to-video/references/cut-catalog.md | 2 +- .../pr-to-video/references/motion-language.md | 10 +-- skills/pr-to-video/references/story-design.md | 2 +- .../pr-to-video/references/visual-design.md | 28 ++++---- skills/pr-to-video/scripts/build-frame.mjs | 2 +- skills/pr-to-video/scripts/captions.test.mjs | 4 +- .../scripts/frame-contract.test.mjs | 2 +- skills/pr-to-video/scripts/frame-packets.mjs | 2 +- .../scripts/lib/transition-registry.mjs | 2 +- .../pr-to-video/scripts/lib/transitions.json | 2 +- skills/product-launch-video/SKILL.md | 28 ++++---- .../references/cut-catalog.md | 2 +- .../references/motion-language.md | 10 +-- .../references/story-design.md | 6 +- .../references/visual-design.md | 30 ++++----- .../scripts/build-frame-colors.test.mjs | 2 +- .../scripts/build-frame.mjs | 2 +- .../scripts/captions.test.mjs | 4 +- .../scripts/frame-packets.mjs | 2 +- .../scripts/frame-packets.test.mjs | 2 +- .../scripts/lib/transition-registry.mjs | 2 +- .../scripts/lib/transitions.json | 2 +- .../sub-agents/frame-worker.md | 2 +- .../references/limitations.md | 2 +- .../references/media.md | 2 +- skills/slideshow/SKILL.md | 2 +- 342 files changed, 589 insertions(+), 588 deletions(-) delete mode 100644 skills/hyperframes-keyframes/agents/openai.yaml rename skills/{hyperframes-animation/SKILL.md => hyperframes/animation/GUIDE.md} (77%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/animate-text.md (94%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/animejs.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/css-animations.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/gsap-easing-and-stagger.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/gsap-timeline-and-labels.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/gsap-transforms-and-perf.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/gsap.md (96%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/html-in-canvas-patterns.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/lottie.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/three.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/typegpu.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/adapters/waapi.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints-index.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/agent-progress-theater.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/camera-journey.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/comparison-split.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/constellation-hub.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/cta-morph-press.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/cursor-ui-demo.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/dataviz-countup.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/device-surface-showcase.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/fixed-anchor-cycle.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/grid-card-assemble.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/kinetic-type-beats.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/logo-assemble-lockup.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/overwhelm-surround.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/panel-edit-live-sync.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/prompt-type-submit-generate.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/spatial-pan-stations.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/ticker-takeover.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/titlecard-reveal.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/transcript-scroll-artifact-reveal.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/typewriter-reveal.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/video-text-pivot.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/blueprints/zoom-out-workspace-reveal.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/brand-reveal-assemble-zoom.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/comparison-split-cards.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/concept-demo-decode-pan.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/cta-morph-press.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/cta-orbit-collapse.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/demo-page-scroll-spotlight.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/hook-counter-burst.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/messaging-multi-phrase.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/metric-video-text-pivot.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/problem-mockup-overwhelm.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/proof-logo-chain.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/takeover-ticker-displace.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/examples/workflow-approve-press.html (100%) rename skills/{hyperframes-animation => hyperframes/animation}/references/motion-blur.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules-index.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/3d-camera-flight.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/3d-page-scroll.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/3d-text-depth-layers.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/ai-tracking-box.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/ambient-glow-bloom.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/anchored-layout-expand.md (97%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/asr-keyword-glow.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/avatar-cloud-network.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/camera-cursor-tracking.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/card-morph-anchor.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/center-outward-expansion.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/chart-scrub-readout.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/chromatic-glitch.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/context-sensitive-cursor.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/control-target-sync.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/coordinate-target-zoom.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/counting-dynamic-scale.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/css-marker-patterns.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/cursor-click-ripple.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/cursor-drag.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/depth-of-field-blur.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/depth-scatter-assemble.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/discrete-text-sequence.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/dynamic-content-sequencing.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/gradient-text-sweep.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/gsap-effects.md (97%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/hacker-flip-3d.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/kinetic-beat-slam.md (97%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/motion-blur-streak.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/multi-cursor-choreography.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/multi-phase-camera.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/nudge-curve.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/orbit-3d-entry.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/particle-burst.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/physics-press-reaction.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/press-release-spring.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/reactive-displacement.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/scale-swap-transition.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/sine-wave-loop.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/split-tilt-cards.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/spring-pop-entrance.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/stat-bars-and-fills.md (97%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/svg-icon-enrichment.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/svg-path-draw.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/theme-crossfade-morph.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/vertical-spring-ticker.md (98%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/viewport-change.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/rules/waterfall-entry.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/scripts/animation-map-sampling.mjs (100%) rename skills/{hyperframes-animation => hyperframes/animation}/scripts/animation-map-sampling.test.mjs (100%) rename skills/{hyperframes-animation => hyperframes/animation}/scripts/animation-map.mjs (99%) rename skills/{hyperframes-animation => hyperframes/animation}/scripts/animation-map.test.mjs (97%) rename skills/{hyperframes-animation => hyperframes/animation}/scripts/package-loader.mjs (100%) rename skills/{hyperframes-animation => hyperframes/animation}/scripts/package-loader.test.mjs (100%) rename skills/{hyperframes-animation => hyperframes/animation}/techniques.md (99%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/TRANSITION-REGISTRY.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/catalog.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-3d.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-blur.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-cover.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-destruction.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-dissolve.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-distortion.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-grid.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-light.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-mechanical.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-other.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-push.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-radial.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/css-scale.md (100%) rename skills/{hyperframes-animation => hyperframes/animation}/transitions/overview.md (99%) rename skills/{hyperframes-core/SKILL.md => hyperframes/core/GUIDE.md} (93%) rename skills/{hyperframes-core => hyperframes/core}/references/composition-patterns.md (99%) rename skills/{hyperframes-core => hyperframes/core}/references/creator-editing-recipes.md (86%) rename skills/{hyperframes-core => hyperframes/core}/references/data-attributes.md (99%) rename skills/{hyperframes-core => hyperframes/core}/references/determinism-rules.md (96%) rename skills/{hyperframes-core => hyperframes/core}/references/full-screen-motion.md (100%) rename skills/{hyperframes-core => hyperframes/core}/references/minimal-composition.md (100%) rename skills/{hyperframes-core => hyperframes/core}/references/sub-compositions.md (100%) rename skills/{hyperframes-core => hyperframes/core}/references/tailwind.md (100%) rename skills/{hyperframes-core => hyperframes/core}/references/tracks-and-clips.md (98%) rename skills/{hyperframes-core => hyperframes/core}/references/variables-and-media.md (100%) rename skills/{hyperframes-creative/SKILL.md => hyperframes/creative/GUIDE.md} (84%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/biennale-yellow/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/biennale-yellow/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/biennale-yellow/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/blockframe/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/blockframe/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/blockframe/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/blue-professional/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/blue-professional/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/blue-professional/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/bold-poster/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/bold-poster/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/bold-poster/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/broadside/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/broadside/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/broadside/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/capsule/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/capsule/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/capsule/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/cartesian/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/cartesian/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/cartesian/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/cobalt-grid/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/cobalt-grid/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/cobalt-grid/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/FRAME.md (99%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/EBGaramond-400.woff2 (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/EBGaramond-700.woff2 (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/Inter-400.woff2 (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/Inter-700.woff2 (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/JetBrainsMono-400.woff2 (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/JetBrainsMono-700.woff2 (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/OFL-eb-garamond.txt (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/OFL-inter.txt (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/fonts/OFL-jetbrains-mono.txt (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/code-editorial/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/coral/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/coral/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/coral/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/creative-mode/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/creative-mode/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/creative-mode/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/daisy-days/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/daisy-days/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/daisy-days/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/editorial-forest/FRAME.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/editorial-forest/caption-skin.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/frame-presets/editorial-forest/frame-showcase.html (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/bold-energetic.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/clean-corporate.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/dark-premium.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/jewel-rich.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/monochrome.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/nature-earth.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/neon-electric.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/pastel-soft.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/palettes/warm-editorial.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/audio-reactive.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/beat-direction.md (98%) rename skills/{hyperframes-creative => hyperframes/creative}/references/composition-patterns.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/data-in-motion.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/design-adherence.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/design-picker.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/design-spec.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/house-style.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/motion-principles.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/narration.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/prompt-expansion.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/story-spine.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/storyboard-recipe.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/typography.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/video-composition.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/references/visual-styles.md (100%) rename skills/{hyperframes-creative => hyperframes/creative}/scripts/contrast-report.mjs (99%) rename skills/{hyperframes-creative => hyperframes/creative}/scripts/extract-audio-data.py (100%) rename skills/{hyperframes-creative => hyperframes/creative}/scripts/package-loader.mjs (100%) rename skills/{hyperframes-creative => hyperframes/creative}/scripts/package-loader.test.mjs (100%) rename skills/{hyperframes-creative => hyperframes/creative}/templates/design-picker.html (100%) rename skills/{hyperframes-keyframes/SKILL.md => hyperframes/keyframes/GUIDE.md} (87%) rename skills/{hyperframes-keyframes => hyperframes/keyframes}/references/keyframe-patterns.md (100%) rename skills/{hyperframes-studio/SKILL.md => hyperframes/studio/GUIDE.md} (89%) rename skills/{hyperframes-audio/SKILL.md => media-use/mix/GUIDE.md} (95%) rename skills/{hyperframes-audio => media-use/mix}/references/attributes.md (100%) rename skills/{hyperframes-audio => media-use/mix}/references/diagnosis.md (100%) rename skills/{hyperframes-audio => media-use/mix}/references/fx-registry.md (100%) rename skills/{hyperframes-audio => media-use/mix}/references/presets.md (100%) rename skills/{hyperframes-audio => media-use/mix}/scripts/carve.mjs (100%) rename skills/{hyperframes-audio => media-use/mix}/scripts/carve.test.mjs (100%) rename skills/{hyperframes-audio => media-use/mix}/scripts/lib/main-module.mjs (100%) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index be444b838e0..7ec882d279f 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -21,14 +21,8 @@ "license": "Apache-2.0", "skills": [ "./skills/hyperframes", - "./skills/hyperframes-animation", - "./skills/hyperframes-audio", "./skills/hyperframes-cli", - "./skills/hyperframes-core", - "./skills/hyperframes-creative", - "./skills/hyperframes-keyframes", "./skills/hyperframes-registry", - "./skills/hyperframes-studio", "./skills/media-use" ] } diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index e691070f4aa..f8f1a830cb1 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -714,8 +714,8 @@ jobs: - name: Exercise npm-cli bootstrap command run: >- node --test - skills/hyperframes-animation/scripts/package-loader.test.mjs - skills/hyperframes-creative/scripts/package-loader.test.mjs + skills/hyperframes/animation/scripts/package-loader.test.mjs + skills/hyperframes/creative/scripts/package-loader.test.mjs skills/hyperframes/scripts/plugin-cli.test.mjs # Guards that skills-manifest.json (the published freshness fingerprint read diff --git a/AGENTS.md b/AGENTS.md index 74a602b8c41..8b3fb90e81b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,7 +8,7 @@ This repo ships AI agent skills via [vercel-labs/skills](https://github.com/verc ```bash npx hyperframes skills update # default: installs/refreshes the core set — workflows install on demand -npx hyperframes skills # all 21 published skills at once +npx hyperframes skills # all 15 published skills at once npx skills add heygen-com/hyperframes # interactive picker (terminal only; repo-internal skills are excluded by default) ``` diff --git a/CLAUDE.md b/CLAUDE.md index e0d9b9f7a19..fcb9c2d67e0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,11 +4,11 @@ Open-source video rendering framework: write HTML, render video. ## Skills -This repo ships 21 AI agent skills via [vercel-labs/skills](https://github.com/vercel-labs/skills). Install them before writing compositions — they encode framework-specific patterns that generic docs don't cover. **Default to the core set**: the `/hyperframes` router installs each creation workflow on demand; install all 21 only when the user explicitly asks for the full set. +This repo ships 15 AI agent skills via [vercel-labs/skills](https://github.com/vercel-labs/skills). Install them before writing compositions — they encode framework-specific patterns that generic docs don't cover. **Default to the core set**: the `/hyperframes` router installs each creation workflow on demand; install all 15 only when the user explicitly asks for the full set. ```bash npx hyperframes skills update # default: installs/refreshes the core set — workflows install on demand -npx hyperframes skills # all 21 published skills at once — only on explicit request +npx hyperframes skills # all 15 published skills at once — only on explicit request npx skills add heygen-com/hyperframes # interactive picker; internal skills require INSTALL_INTERNAL_SKILLS=1 for discovery npx skills add heygen-com/hyperframes --all # excludes internal skills unless INSTALL_INTERNAL_SKILLS=1 npx skills add heygen-com/hyperframes --skill # a named match installs regardless of metadata.internal (bare name, no leading slash) @@ -37,12 +37,8 @@ npx skills add heygen-com/hyperframes --skill # a named match installs r Atomic capabilities the creation workflows compose against — pull one when you need that specific layer: -- `/hyperframes-core` — the composition contract: `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, determinism rules. Read before writing composition HTML. -- `/hyperframes-animation` — all animation knowledge: atomic motion rules, scene blueprints, transitions, runtime adapters (GSAP default, plus Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU). -- `/hyperframes-keyframes` — seek-safe keyframe authoring across runtimes: GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth; plus `hyperframes keyframes` diagnostics for surfacing and verifying rendered motion. -- `/hyperframes-creative` — non-animation creative direction: `frame.md` / `design.md` handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns. -- `/media-use` — the media OS (a host app's own music and sound-effect tools come first for those): resolve any media need (BGM, SFX, image, icon, logo, voice, color grade, LUT) into a frozen local file or paste-ready block + ledger record; generate via TTS / music / image models when the catalog misses; transcribe, caption, remove backgrounds, and reuse assets across projects. One shared `scripts/audio.mjs` engine + manifest tracking; keeps search noise on disk. -- `/hyperframes-audio` — mix the audio already placed in a composition: voiceover carve (dip a music bed only in the bands the voice occupies, static or dynamic, level match included), the effect chain (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes on volume or any effect parameter, and submix buses (``) that carry one chain, fader and automation clock for several tracks at once. Sourcing the audio is `/media-use`; this is what happens to it afterwards. +- `/hyperframes` guides — the entry skill also carries the domain guides, read from its folder on demand: `core/GUIDE.md` (the composition contract: `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, determinism rules; read before writing composition HTML), `animation/GUIDE.md` (motion rules, scene blueprints, transitions, runtime adapters), `keyframes/GUIDE.md` (seek-safe keyframes plus `hyperframes keyframes` diagnostics), `creative/GUIDE.md` (`frame.md` / `design.md`, palettes, typography, narration, beat planning), `studio/GUIDE.md` (Studio conventions). +- `/media-use` — the media OS (a host app's own music and sound-effect tools come first for those): resolve any media need (BGM, SFX, image, icon, logo, voice, color grade, LUT) into a frozen local file or paste-ready block + ledger record; generate via TTS / music / image models when the catalog misses; transcribe, caption, remove backgrounds, and reuse assets across projects. One shared `scripts/audio.mjs` engine + manifest tracking; keeps search noise on disk. Its `mix/GUIDE.md` mixes audio already placed in a composition: voiceover carve, effect chain, automation envelopes, `` submix buses. - `/hyperframes-cli` — CLI dev loop: `init`, `add`, `lint`, `check`, `snapshot`, `preview`, `render`, `publish`, `doctor`, `lambda` (AWS Lambda cloud rendering). - `/hyperframes-registry` — search, install and wire registry blocks and components into compositions via `hyperframes catalog` / `hyperframes add`. Load it before hand-building any named look, effect, treatment or transition: the search ranks the whole hosted registry with nothing installed. Covers authoring a new block or component to contribute upstream. - `/figma` — import Figma assets, tokens, components, and storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI) plus Motion animations (MCP) and shaders (MCP source / native export) into a composition. diff --git a/README.md b/README.md index 4529ffdda70..fba1266a135 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,7 @@ For standalone skills (including OpenCode), use: npx skills add heygen-com/hyperframes ``` -> The picker opens with nothing pre-selected — the **Core Skills** group is all you need: the `/hyperframes` router installs each creation workflow on demand. Agents and non-interactive runs should use `npx hyperframes skills update` instead — it installs exactly the core set, whereas `skills add --all` installs all 21 published skills. The six repo-internal skills under `.claude/skills` / `.agents/skills` are excluded by default. For the full published set use `npx hyperframes skills`. +> The picker opens with nothing pre-selected — the **Core Skills** group is all you need: the `/hyperframes` router installs each creation workflow on demand. Agents and non-interactive runs should use `npx hyperframes skills update` instead — it installs exactly the core set, whereas `skills add --all` installs all 15 published skills. The six repo-internal skills under `.claude/skills` / `.agents/skills` are excluded by default. For the full published set use `npx hyperframes skills`. > > `skills add` resolves the skills.sh registry blob, which can lag `main` by hours. `npx hyperframes skills update` installs from the current `main`, so reach for it when you need the newest copy of a skill. @@ -65,9 +65,9 @@ The skills teach agents the HyperFrames production loop: plan the video, write v ## Skills -HyperFrames ships 21 skills agents load on demand. Read `/hyperframes` first — it's the router and capability map; it picks a workflow for any "make me a…" request — video, deck, or composition port — and points to the domain skills below. +HyperFrames ships 15 skills agents load on demand. Read `/hyperframes` first — it's the router and capability map; it picks a workflow for any "make me a…" request — video, deck, or composition port — and points to the domain skills below. -For standalone installation, default to the **core set** — the router installs each creation workflow on demand. `npx hyperframes skills update` installs exactly that from anywhere; the interactive picker (`npx skills add heygen-com/hyperframes`) lists it as the "Core Skills" group, nothing pre-selected. The picker is interactive-only — a non-interactive or agent run without `--skill` installs all 21. Use `npx skills add heygen-com/hyperframes --all` to install the complete published set deliberately (skips the picker), or `npx skills add heygen-com/hyperframes --skill ` for just one (bare name, no leading `/`). +For standalone installation, default to the **core set** — the router installs each creation workflow on demand. `npx hyperframes skills update` installs exactly that from anywhere; the interactive picker (`npx skills add heygen-com/hyperframes`) lists it as the "Core Skills" group, nothing pre-selected. The picker is interactive-only — a non-interactive or agent run without `--skill` installs all 15. Use `npx skills add heygen-com/hyperframes --all` to install the complete published set deliberately (skips the picker), or `npx skills add heygen-com/hyperframes --skill ` for just one (bare name, no leading `/`). Standalone installs stay lean after that: `npx hyperframes init` keeps the **core set** fresh (the router, the `hyperframes-*` domain skills, and `media-use` — plus whatever is already installed; `/figma` stays on demand) and never expands a partial install; the creation workflows install **on demand** — the router runs `npx hyperframes skills update ` before entering one. Nothing re-pulls the full set behind your back. @@ -112,17 +112,13 @@ This writes `dist/hyperframes-plugin.zip` with a `hyperframes/` root folder and Atomic capabilities the creation workflows compose against — pull one when you need that specific layer. -| Skill | Covers | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `/hyperframes-core` | The composition contract — `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, determinism rules. | -| `/hyperframes-animation` | All animation knowledge — atomic motion rules, scene blueprints, transitions, runtime adapters (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU). | -| `/hyperframes-keyframes` | Seek-safe keyframe authoring across runtimes — GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, 3D depth — plus `hyperframes keyframes` diagnostics for rendered motion. | -| `/hyperframes-creative` | Non-animation creative direction — `frame.md` / `design.md`, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns. | -| `/media-use` | The media OS (a host app's own music and sound-effect tools come first for those) — resolve any media need (BGM, SFX, image, icon, logo, voice, color grade, LUT) into a frozen local file or paste-ready block + ledger record, generate via TTS/music/image models when the catalog misses, transcribe, caption, remove backgrounds, and reuse assets across projects. One shared audio engine + manifest tracking. | -| `/hyperframes-cli` | CLI dev loop — `init`, `lint`, `check`, `snapshot`, `preview`, `render`, `publish`, `doctor`, plus HeyGen-hosted cloud rendering (`cloud render`) and AWS Lambda rendering (`lambda deploy / render / progress`). | -| `/hyperframes-audio` | Mix the audio already placed in a composition — voiceover carve (dip a music bed only in the bands the voice occupies, static or dynamic, level match included), the effect chain (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes on volume or any effect parameter, and submix buses (``) carrying one chain, fader and automation clock for several tracks at once. Sourcing the audio is `/media-use`. | -| `/hyperframes-registry` | Search, install and wire registry blocks and components into compositions via `hyperframes catalog` / `hyperframes add`. Load before hand-building any named look, effect, treatment or transition. Authoring a new block or component to contribute upstream. | -| `/figma` | Import Figma assets, tokens, components, and storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI) plus Motion animations (MCP) and shaders (MCP source / native export) into a composition. | +| Skill | Covers | +| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `/hyperframes` guides | Read from the entry skill's folder on demand: `core/GUIDE.md` (the composition contract — `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, determinism rules), `animation/GUIDE.md` (motion rules, scene blueprints, transitions, runtime adapters), `keyframes/GUIDE.md` (seek-safe keyframes plus `hyperframes keyframes` diagnostics), `creative/GUIDE.md` (`frame.md` / `design.md`, palettes, typography, narration, beat planning), `studio/GUIDE.md` (Studio conventions). | +| `/media-use` | The media OS (a host app's own music and sound-effect tools come first for those) — resolve any media need (BGM, SFX, image, icon, logo, voice, color grade, LUT) into a frozen local file or paste-ready block + ledger record, generate via TTS/music/image models when the catalog misses, transcribe, caption, remove backgrounds, and reuse assets across projects. One shared audio engine + manifest tracking. Its `mix/GUIDE.md` mixes audio already placed in a composition — voiceover carve, effect chain, automation envelopes, `` submix buses. | +| `/hyperframes-cli` | CLI dev loop — `init`, `lint`, `check`, `snapshot`, `preview`, `render`, `publish`, `doctor`, plus HeyGen-hosted cloud rendering (`cloud render`) and AWS Lambda rendering (`lambda deploy / render / progress`). | +| `/hyperframes-registry` | Search, install and wire registry blocks and components into compositions via `hyperframes catalog` / `hyperframes add`. Load before hand-building any named look, effect, treatment or transition. Authoring a new block or component to contribute upstream. | +| `/figma` | Import Figma assets, tokens, components, and storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI) plus Motion animations (MCP) and shaders (MCP source / native export) into a composition. | For visual design handoff workflows, see the [Claude Design guide](https://hyperframes.heygen.com/guides/claude-design) and [Open Design guide](https://hyperframes.heygen.com/guides/open-design). diff --git a/docs/catalog/components/device-frame-stage.mdx b/docs/catalog/components/device-frame-stage.mdx index 6246f470510..77c7d1d1d55 100644 --- a/docs/catalog/components/device-frame-stage.mdx +++ b/docs/catalog/components/device-frame-stage.mdx @@ -44,7 +44,7 @@ import { InstallCommand } from "/snippets/install-command.jsx"; hardware reveal, glare sweep, or camera-lens tour, ever. This file is a mountable HyperFrames sub-composition (see - skills/hyperframes-core/references/sub-compositions.md): a host + skills/hyperframes/core/references/sub-compositions.md): a host composition embeds it via a clip carrying data-composition-src, a matching data-composition-id, and its own data-start / data-duration / data-track-index / data-width / data-height. Everything the render needs diff --git a/docs/catalog/components/oversized-cursor.mdx b/docs/catalog/components/oversized-cursor.mdx index 713c19c3e08..74a9f7e81be 100644 --- a/docs/catalog/components/oversized-cursor.mdx +++ b/docs/catalog/components/oversized-cursor.mdx @@ -39,7 +39,7 @@ import { InstallCommand } from "/snippets/install-command.jsx"; mount contract: this file is a HyperFrames sub-composition, loaded by a host via data-composition-src, never opened standalone. The runtime clones ONLY the