@opengamehq/skills 1.3.0 → 1.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +44 -0
- package/README.md +12 -4
- package/dist/.claude-plugin/marketplace.json +26 -0
- package/dist/skills/manifest.json +1409 -145
- package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
- package/dist/skills/opengame-accessibility/SKILL.md +48 -32
- package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
- package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
- package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
- package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
- package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
- package/dist/skills/opengame-api/CHANGELOG.md +12 -0
- package/dist/skills/opengame-api/SKILL.md +39 -13
- package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
- package/dist/skills/opengame-assets/SKILL.md +79 -31
- package/dist/skills/opengame-assets/references/pipeline.md +67 -0
- package/dist/skills/opengame-audio/CHANGELOG.md +11 -0
- package/dist/skills/opengame-audio/SKILL.md +129 -41
- package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
- package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
- package/dist/skills/opengame-capture/SKILL.md +44 -20
- package/dist/skills/opengame-capture/references/pipeline.md +33 -1
- package/dist/skills/opengame-capture/references/threejs.md +17 -1
- package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
- package/dist/skills/opengame-characters/SKILL.md +94 -39
- package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-characters/references/player-og.md +1 -1
- package/dist/skills/opengame-cli/CHANGELOG.md +20 -0
- package/dist/skills/opengame-cli/SKILL.md +12 -11
- package/dist/skills/opengame-deploy/CHANGELOG.md +30 -0
- package/dist/skills/opengame-deploy/SKILL.md +43 -23
- package/dist/skills/opengame-deploy/references/json-events.md +6 -5
- package/dist/skills/opengame-deploy/references/manifest.md +9 -3
- package/dist/skills/opengame-deploy/references/packaging.md +32 -30
- package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
- package/dist/skills/opengame-depth/SKILL.md +61 -33
- package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
- package/dist/skills/opengame-enemies/SKILL.md +96 -40
- package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-enemies/references/threejs.md +59 -0
- package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
- package/dist/skills/opengame-front-end/SKILL.md +85 -39
- package/dist/skills/opengame-front-end/references/menus.md +42 -8
- package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
- package/dist/skills/opengame-game-feel/SKILL.md +95 -47
- package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
- package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-jam/CHANGELOG.md +12 -0
- package/dist/skills/opengame-jam/SKILL.md +48 -33
- package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
- package/dist/skills/opengame-lighting/SKILL.md +85 -34
- package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
- package/dist/skills/opengame-loading/SKILL.md +78 -38
- package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-loading/references/threejs.md +32 -7
- package/dist/skills/opengame-look/CHANGELOG.md +9 -0
- package/dist/skills/opengame-look/SKILL.md +122 -51
- package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
- package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
- package/dist/skills/opengame-maps/SKILL.md +78 -0
- package/dist/skills/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
- package/dist/skills/opengame-mobile/SKILL.md +18 -18
- package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-make/SKILL.md +187 -0
- package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
- package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
- package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
- package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
- package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
- package/dist/skills/opengame-performance/SKILL.md +106 -65
- package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-performance/references/measuring.md +51 -0
- package/dist/skills/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-production/CHANGELOG.md +13 -0
- package/dist/skills/opengame-production/SKILL.md +119 -54
- package/dist/skills/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-production/references/templates.md +106 -16
- package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
- package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
- package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
- package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
- package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
- package/dist/skills/opengame-rhythm/SKILL.md +138 -0
- package/dist/skills/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-router/CHANGELOG.md +12 -0
- package/dist/skills/opengame-router/SKILL.md +14 -7
- package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
- package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
- package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
- package/dist/skills/opengame-sdk/CHANGELOG.md +16 -0
- package/dist/skills/opengame-sdk/SKILL.md +27 -10
- package/dist/skills/opengame-sdk/references/engines.md +2 -2
- package/dist/skills/opengame-sdk/references/identity.md +10 -11
- package/dist/skills/opengame-sdk/references/leaderboards.md +11 -1
- package/dist/skills/opengame-sdk/references/radio.md +1 -1
- package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
- package/dist/skills/opengame-stability/SKILL.md +59 -27
- package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
- package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
- package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
- package/dist/skills/opengame-verification/SKILL.md +113 -48
- package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
- package/dist/skills/opengame-weapons/SKILL.md +129 -55
- package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
- package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-weapons/references/threejs.md +71 -0
- package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
- package/dist/skills/opengame-world-physics/SKILL.md +55 -24
- package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
- package/package.json +1 -1
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
> Carried from `opengame-trailer-plan` 1.0.0. Read it when: Plan a game trailer before anything is shot, for a browser game or any engine. Covers the archetype and format, choosing and measuring the music, measuring reference trailers, mapping how to make the game filmable, the story, and a frame-exact shot list and storyboard checked against measured gates and the owner's eye. Use when someone wants a launch trailer, gameplay reveal, story trailer, store preview, teaser or social cut. For a montage cut to a song, use opengame-montage-plan.
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
# Trailer plan
|
|
5
|
+
|
|
6
|
+
Step 1 of 3: **plan**, then `opengame-trailer-make`, then `opengame-trailer-review-and-improve` on every round.
|
|
7
|
+
|
|
8
|
+
The job is a plan good enough that the first full cut is already above the last film. The last one, the OG Clash launch
|
|
9
|
+
trailer, took 47 hours, 4 chained sessions, about 80 subagents, about 100 owner notes and 63 renders, and its owner
|
|
10
|
+
still rated the shipped film 6/10. Most of those notes were things a plan could have settled: idle characters, a puppet
|
|
11
|
+
enemy animation planned as a hero shot, cheap effects, depth of field that blurred everything, heroes and enemies coming
|
|
12
|
+
from the same side, a mechanic on screen for 0.57 s, a title that looked like a sticker, and no story. This plan aims at
|
|
13
|
+
11/10: the trailer people rewatch and share.
|
|
14
|
+
|
|
15
|
+
For a kill montage, highlight edit or clip edit to a song, use `opengame-montage-plan` instead: a montage overrides
|
|
16
|
+
several trailer defaults (no designed silences, equal payoff spacing, the song never edited).
|
|
17
|
+
|
|
18
|
+
## Read first
|
|
19
|
+
|
|
20
|
+
1. [references/core.md](references/core.md), whole: the loop, the bar, the principles, what 11/10 means, the working
|
|
21
|
+
rules. It decides what else applies.
|
|
22
|
+
2. [references/gates.md](references/gates.md): the measurable gates every cut must pass. Plan so the first cut passes them.
|
|
23
|
+
3. [references/owner-eye.md](references/owner-eye.md): how a demanding owner reviews, the anticipation table, the
|
|
24
|
+
pre-send checklist and the recurring notes with the rule each produced.
|
|
25
|
+
4. [references/archetypes.md](references/archetypes.md), [references/music.md](references/music.md),
|
|
26
|
+
[references/craft.md](references/craft.md), [references/filmable.md](references/filmable.md).
|
|
27
|
+
5. [references/reference-set.md](references/reference-set.md), then [references/edge-cases.md](references/edge-cases.md)
|
|
28
|
+
if the game is 2D, abstract, closed, multiplayer-only, mobile or VR.
|
|
29
|
+
6. [references/og-clash-record.md](references/og-clash-record.md): where the last film's time and points went.
|
|
30
|
+
7. As needed: [references/title.md](references/title.md), [references/finishing.md](references/finishing.md),
|
|
31
|
+
[references/review.md](references/review.md), [references/ops.md](references/ops.md),
|
|
32
|
+
[references/briefs.md](references/briefs.md) (research and critic briefs, word for word), and
|
|
33
|
+
[references/measure.md](references/measure.md) (how to measure every gate with ffmpeg, Python and a speech
|
|
34
|
+
recogniser).
|
|
35
|
+
|
|
36
|
+
Related skills: `opengame-capture` (the hooks that make a game filmable, built into the game), `opengame-audio` (the
|
|
37
|
+
game's own sound), `opengame-production` (running many agent rounds against one owner), `opengame-quality-bar` (judging
|
|
38
|
+
the game itself). Keys come from the environment and are never printed.
|
|
39
|
+
|
|
40
|
+
## Settle the inputs (infer first; ask once)
|
|
41
|
+
|
|
42
|
+
Infer everything you can from the repo and the brief: the game's name, genre, engine, platforms, release moment (store
|
|
43
|
+
drafts, the changelog, tags), tone (art, palette, soundtrack), logo and brand assets. Then send **one** message with at
|
|
44
|
+
most four questions, each with a default, only for what you could not infer:
|
|
45
|
+
|
|
46
|
+
- **Archetype and length.** Default from the decision tree in the archetypes chapter. For a browser game: a 45-75 s
|
|
47
|
+
launch trailer, a raw gameplay montage and 15 and 30 s vertical cuts.
|
|
48
|
+
- **Resolution, frame rate and file size of the master.** 1080p or 4K (or a store size), 30 or 60 fps, the aspect.
|
|
49
|
+
**Default 1080p at 60 fps, 16:9.** 4K costs about 4x the capture time and disk; 30 fps halves capture but loses the
|
|
50
|
+
smoothness ramps need (App Store previews cap at 30 fps). Slow motion is captured from the simulation either way.
|
|
51
|
+
Settle a target size or bitrate per deliverable ("so its not a crazy file size").
|
|
52
|
+
- **Music.** Two or three measured candidates with a 15 s excerpt each and a default (the music chapter). Never "what
|
|
53
|
+
music do you want?". Their own track wins if they gave one.
|
|
54
|
+
- **The must-show list.** The core-loop beats, hero moments and newest features (default: the game bible's top beats).
|
|
55
|
+
- **Spend and permissions.** Any paid generation (music, voice, video, image, 3D) runs only on the person's own account,
|
|
56
|
+
with their explicit go-ahead on the cost: ask, state what it is for and the likely cost, and record the answer word
|
|
57
|
+
for word. Ask too whether improved but unshipped visuals may appear (fixed in a film build and handed back to the game
|
|
58
|
+
team).
|
|
59
|
+
|
|
60
|
+
Never ask about the loop, the gates or the principles; they are not optional. If nobody answers, log the defaults you
|
|
61
|
+
took in `plan/DECISIONS.md` and keep going.
|
|
62
|
+
|
|
63
|
+
## Steps
|
|
64
|
+
|
|
65
|
+
### 1. Freeze and fan out (the first 10 minutes)
|
|
66
|
+
|
|
67
|
+
- **Freeze the build:** a named, hashed build players get; clone the release and the source (copy-on-write if your file system allows); play it once. Tell the game
|
|
68
|
+
team in writing that the film works from it and they keep shipping.
|
|
69
|
+
- **Launch research in parallel,** briefs on disk first (the briefs chapter): the game bible (R-GAME), the capability
|
|
70
|
+
map with one probe (R-CAPTURE), the music measurement (R-MUSIC), the reference measurement (R-REFS), voices and the
|
|
71
|
+
sound inventory (R-SOUND). Run the taste pass (R-TASTE) **after** the references land.
|
|
72
|
+
- Set up the film repo: `plan/`, `research/`, `briefs/` (the common brief filled in), `capture/`, `edit/`, `title/`,
|
|
73
|
+
`work/PROGRESS.log`, `work/REQUESTS.md`, `plan/DECISIONS.md`, `handoff/GAME-NOTES.md`, a spend ledger, and
|
|
74
|
+
`film/SKILLS.log` with one UTC line per skill invocation.
|
|
75
|
+
- Start the notes ledger with the brief in the owner's own words; it is the first spec. Log every later note the moment it arrives.
|
|
76
|
+
|
|
77
|
+
### 2. Archetype, references, the bar
|
|
78
|
+
|
|
79
|
+
- Run the archetype decision tree; write the format (aspect, resolution, rate, length, deliverables, platform rules).
|
|
80
|
+
For a launch, offer the package: the trailer, a raw gameplay montage, a share card and social cuts. The montage must
|
|
81
|
+
show skilled play that fulfils every on-screen objective.
|
|
82
|
+
- Pick the floor, the bar and the edit bar for this genre (the reference-set chapter) and measure them (R-REFS). Write
|
|
83
|
+
the act template from the measurements, not from memory: first voice line, first enemy, the cut-rate curve, where the
|
|
84
|
+
title sits, the end card, how many silences end in slams, the first-person share, the feature beats.
|
|
85
|
+
- References are for measuring only. Never recreate another studio's game, characters, logo or shots, even renamed.
|
|
86
|
+
- Name every departure from the references and get a yes, or log the default. OG Clash departed on HUD feedback, beat
|
|
87
|
+
lock, first-person share and voice count.
|
|
88
|
+
|
|
89
|
+
### 3. Music and the clock
|
|
90
|
+
|
|
91
|
+
- Choose per the music decision: their track, then the game's own score, then music they own or licensed, then
|
|
92
|
+
generation (only with their go-ahead on the cost), then a licensable library with proof.
|
|
93
|
+
- Measure the chosen track fully: splices, a piecewise grid, a bar map, drops, holes, stops, the ending. Write
|
|
94
|
+
`research/grid.json` and verify it with a click track. Edit to length on downbeats at phrase boundaries; take a
|
|
95
|
+
ring-out from the song if it ends abruptly.
|
|
96
|
+
- Plan **2-4 designed silences** (silence then slam) and where the loudest moment lands (the boss or the title, never a
|
|
97
|
+
mid-film feature).
|
|
98
|
+
|
|
99
|
+
### 4. Make the game filmable (map it; do not build yet)
|
|
100
|
+
|
|
101
|
+
- Fill the capability checklist C1-C19 (the filmable chapter) from R-CAPTURE. List the film-build hooks needed, each off
|
|
102
|
+
by default, and the capture method for this engine (the per-engine table). Where you own the game, the in-game hooks
|
|
103
|
+
follow `opengame-capture`.
|
|
104
|
+
- Audit before you plan: list every character, enemy, weapon and effect the plan wants on screen and mark which ones
|
|
105
|
+
need an animation or effect audit on frames (`opengame-trailer-make` runs it). Mine the developers' QA history for what already
|
|
106
|
+
looks bad.
|
|
107
|
+
- Draw the level from above: named places, the most cinematic spots, where each side comes from in each act (the
|
|
108
|
+
screen-direction map), and lens positions that are physically possible.
|
|
109
|
+
|
|
110
|
+
### 5. Story, language and copy
|
|
111
|
+
|
|
112
|
+
- **Story first:** the hook (first 3 s: a question or an image), the promise, the escalation, the **turn**, the payoff
|
|
113
|
+
(its impact frame on screen) and the **button** (a beat after the title that rewards a rewatch). Name at least one
|
|
114
|
+
**character moment** (a reaction, a look, a line between characters) and one **signature moment** only this game can
|
|
115
|
+
do. The 6/10 film had systems and no story; 11/10 starts here. Design at least two items from the core chapter's
|
|
116
|
+
"beyond 10/10" list into the plan.
|
|
117
|
+
- **The film's one language** (the craft chapter): allowed cuts and transitions, the ramp recipe, camera rules, the HUD policy, the text
|
|
118
|
+
policy, a colour script of one sentence per act, the sound rules. Ban every editorial effect; allow what the game
|
|
119
|
+
renders itself.
|
|
120
|
+
- **Voice:** characters, not an announcer; density per the brief (references run 5-8 lines a minute); each line on the
|
|
121
|
+
shot where its speaker is, or on the thing it names; the game's own lines and voices first; no other studio's names.
|
|
122
|
+
- **Title:** the game's own logo as a 3D object inside the scene of its shot (the title chapter): where it lands, and what
|
|
123
|
+
energy it carries on which beats.
|
|
124
|
+
|
|
125
|
+
### 6. The shot list (`plan/shots.json` and the table in `plan/PLAN.md`)
|
|
126
|
+
|
|
127
|
+
| # | frames a..b at 60 fps (bars) | first person or cinematic | what performs (one whole action) | payoff frame and the beat it hits | camera (path, lens, px/f in and out) | cut in (kind, direction) | speed (ramp keys) | sound events | voice | source (build, flags) | reference moment |
|
|
128
|
+
|
|
129
|
+
- Every shot: one whole action, entering on the wind-up and cutting on the payoff; the payoff 1-3 frames before its
|
|
130
|
+
beat; the camera moving from first frame to last; a reason to arrive.
|
|
131
|
+
- Rhythm: vary 0.5-4 beats; no more than 4 equal-length shots in a row; tighten into the drop; one long breath on the
|
|
132
|
+
hero reveal; a new mechanic held at least 70-90 frames.
|
|
133
|
+
- First person 25-40 % of the film (the action section may reach about 50 %); first-to-third-person pairs as one take;
|
|
134
|
+
long-draw weapons and acrobatics in third person.
|
|
135
|
+
- Machine-readable: `{n, a, b, kind, what, pair, payoff[], bars, take_covers, reason}`; keep each version of the list
|
|
136
|
+
side by side.
|
|
137
|
+
|
|
138
|
+
### 7. A visual storyboard (a page, not a markdown file)
|
|
139
|
+
|
|
140
|
+
Publish a storyboard page: the timeline to scale against bars and drops, act bands, first-person and cinematic lanes,
|
|
141
|
+
every shot with its frames, action, payoff, cut in, camera, sound and a thumbnail (a probe still, a reference frame or a
|
|
142
|
+
sketch). Republish it whenever the structure changes. In the first hour of making, stand up a review page with the
|
|
143
|
+
latest cut, a frame and bar.beat readout and the timeline, and send the owner its link after loading it yourself.
|
|
144
|
+
|
|
145
|
+
### 8. Pre-mortem: run the loop on the plan
|
|
146
|
+
|
|
147
|
+
- Check the plan against every gate and the owner-eye anticipation table, line by line; fix what it already fails.
|
|
148
|
+
- Spawn one blind harsh critic with only the storyboard, the references and the core chapter; filter its proposals
|
|
149
|
+
through the rules (the review chapter); log the rejections.
|
|
150
|
+
- Send the open decisions in one short message, each with a default.
|
|
151
|
+
|
|
152
|
+
## Output
|
|
153
|
+
|
|
154
|
+
In the film repo: `plan/PLAN.md` (the brief in the owner's words; archetype and format; references and the act template; music and
|
|
155
|
+
the grid; the one language; the story arc; voice; title; the shot list; the capture plan with hooks for this engine;
|
|
156
|
+
owners; finishing; deliverables; open questions with defaults), `plan/shots.json`, `research/*.md`,
|
|
157
|
+
`research/grid.json`, the storyboard link, the common brief filled in, `plan/DECISIONS.md` and a line in
|
|
158
|
+
`film/SKILLS.log`. Then: "Plan ready. Run `opengame-trailer-make`."
|
|
159
|
+
|
|
160
|
+
## Don't
|
|
161
|
+
|
|
162
|
+
- Don't plan a shot around an animation, behaviour or effect nobody has seen on rendered frames.
|
|
163
|
+
- Don't plan engine depth of field as a look, a locked-off camera, a standing character, or a mechanic under 1.2 s.
|
|
164
|
+
- Don't plan interpolated slow motion, post blur, crossfades as glue, or invented effects.
|
|
165
|
+
- Don't storyboard from memory of what trailers look like; measure the references.
|
|
166
|
+
- Don't lock a track you have not measured, or cut on drops you have not found.
|
|
167
|
+
- Don't let a paraphrase strengthen the owner's words: their "sick angle and depth of field" became a brief for
|
|
168
|
+
"shallow DOF, f/2.8, soft foreground", and the result had nothing sharp in it.
|
|
169
|
+
- Don't plan a title as an image tracked onto the frame.
|
|
170
|
+
- Don't spend on generation without the person's go-ahead, and never on an account that is not theirs.
|
|
171
|
+
- Don't recreate another studio's game, characters, logo or footage, even renamed.
|
|
172
|
+
- Don't skip the story: a feature list at 60 fps is still a 6/10.
|
package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md
ADDED
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# Archetypes: which trailer to make, and the decision when nobody knows
|
|
2
|
+
|
|
3
|
+
Most people asking for a trailer bring no music and no idea which kind of trailer they want. Decide from the repo, or
|
|
4
|
+
ask once with defaults. The OG Clash trailer was a map and launch trailer hybrid: 62 s of cinematic gameplay with the
|
|
5
|
+
structure of a zombies map trailer and the editing of a community montage.
|
|
6
|
+
|
|
7
|
+
## 1. The decision tree (run it yourself; ask at most one question)
|
|
8
|
+
|
|
9
|
+
Infer what you can first: store page drafts, release notes, version tags, the changelog, store ids, the README's
|
|
10
|
+
pitch, the game's own art and soundtrack. Ask only the release moment if you cannot infer it.
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
1. Where does it play first?
|
|
14
|
+
iOS / iPadOS / Mac / tvOS store -> App Store preview (15-30 s, 30 fps max, 886x1920 or 1920x886) + 30 s social cut
|
|
15
|
+
Google Play only -> 30-45 s Play preview (the first 30 s carries it, muted) + 15 s vertical
|
|
16
|
+
Meta Quest / VR -> 60-90 s 16:9 VR trailer (third-person avatar or mixed reality) + 30 s cut
|
|
17
|
+
Browser game (OpenGame and the like) -> launch trailer 45-75 s 16:9 (1080p60 default, 4K60 on request)
|
|
18
|
+
+ raw gameplay montage + 15 / 30 s vertical
|
|
19
|
+
Steam / PC / console -> step 2
|
|
20
|
+
2. What is the release moment?
|
|
21
|
+
first showing, no store page -> gameplay reveal, 60-75 s
|
|
22
|
+
launching now or within 30 days -> launch trailer, 60-90 s (a date or "play now", and a call to action)
|
|
23
|
+
post-launch, 10 or more strong reviews -> accolades, 45-60 s; otherwise launch v2 with new content
|
|
24
|
+
new map / season / DLC -> map or season trailer, 60-90 s
|
|
25
|
+
3. Authored characters with faces, voices, cutscenes?
|
|
26
|
+
yes, and story sells it -> add a story trailer (90-120 s) as the second video; the first stays gameplay
|
|
27
|
+
yes, a roster game -> character spotlights (45-60 s each)
|
|
28
|
+
no (abstract, puzzle, sim, pixel) -> tell-show-repeat (a card, then the footage); no voice; type and music carry it
|
|
29
|
+
4. Does the art hold up close (rigged faces, LODs at 35-85 mm)?
|
|
30
|
+
yes -> a cinematic cold open of up to 8 s before gameplay is allowed
|
|
31
|
+
no -> gameplay from frame 1; cinematic language only through camera moves at gameplay distance
|
|
32
|
+
5. Tone (art, palette, store copy, soundtrack) -> genre and tempo (the music chapter)
|
|
33
|
+
6. Always deliver: the 16:9 master, 30 s and 15 s 9:16 cutdowns, a version readable muted, captions (.srt),
|
|
34
|
+
a clean music-and-effects version (no music or voice) and stems.
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## 2. The archetypes
|
|
38
|
+
|
|
39
|
+
| Archetype | When | Length | Beats | Text | Music | Voice |
|
|
40
|
+
|---|---|---|---|---|---|---|
|
|
41
|
+
| Cinematic story reveal | announcing a big season or character; authored characters | 60-180 s | cold open on a world detail or a line (0-10 s); a character and what they want (10-40 s); conflict escalates (40-75 %); climax image; title; slate 3-6 s; 0.17-0.27 cuts/s, 3-5 s shots | title and slate only | score-like, one big stop before the climax | character dialogue, 3-8 lines |
|
|
42
|
+
| Gameplay reveal | first showing; the first store video; showcase events | 60-90 s | 0-3 s hook is the core verb at its best (no logos); 3-15 s genre and player fantasy; 15-55 s show-tell-repeat of 2-3 pillars, escalating; montage with a rising cut rate; a stop and a hero moment; title at about 85 %; slate 4-6 s | 0-4 short cards about the fantasy | driving cue with a clear build and drop | optional |
|
|
43
|
+
| Launch trailer (OG Clash) | release week | 60-120 s | as the reveal, with the best late-game content held for the climax; slate with "out now" or a date, platforms and a call to action | date and call to action | the most anthemic cue | reprise iconic lines |
|
|
44
|
+
| Map, season or DLC | a new map, season or expansion | 60-100 s (the Black Ops 6/7 map trailers run about 62 s) | an establishing shot allowed in 0-5 s; first enemy by about 6-13 s; new weapon or boss mid-film; a boss tease and the loudest hit before the title; title at 84-90 %; end card 4-6.5 s; a 2-7 s stinger in 4 of 12 measured | the map's name only | composed or licensed, with stops | crew lines; the name spoken as the title lands |
|
|
45
|
+
| Montage or velocity edit | community energy, a skill showcase | 30-180 s | beat-locked motion; intro 0.4-0.9 cuts/s, body 1.0-1.45, one held breakdown, a slow outro; ends on a held slow image | none or minimal | one track, cut to it | none |
|
|
46
|
+
| Raw gameplay montage (OG Clash, launch day) | proof the game is real, next to the cinematic trailer | 45-90 s | the player's journey in order, 4-10 s per segment, hard cuts | none | the game's own score under the raw sound | none |
|
|
47
|
+
| Accolades | only with many strong reviews | 30-90 s | a montage with 3-6 long, clear quotes from known outlets, 2-3 s each; a wall of laurels at the end | quotes | the launch cue | none |
|
|
48
|
+
| Story trailer | narrative games; a second video | 90-150 s | a line at 0-5 s; world and want; antagonist; stakes; montage; an open question; title | minimal | emotive, wider dynamics | lines that generalise |
|
|
49
|
+
| Character spotlight | roster drops | 45-120 s | the hero's line at 0 s; signature pose by 3 s; one shot per ability (2-4 s); the ultimate is the drop; name and date | ability names optional | the hero's theme | the hero's lines only |
|
|
50
|
+
| Store page trailer (Steam and others) | every store listing | 45-90 s | frame 1 is recognisable gameplay from deep in the game; genre legible in 5-10 s muted; no studio logos up front; ends on the title and "Wishlist" | short, readable muted | structured (it often plays muted) | optional |
|
|
51
|
+
| Social 15 s / 30 s | ads, short-form feeds, replies | 15 or 30 s, 9:16 first | 0-1.5 s is the strongest moment, centred; escalation; the hero hit; title and call to action in the last 2-4 s | burned in, inside safe zones | a loop-friendly edit, downbeat at 0 | none or one captioned line |
|
|
52
|
+
| App Store preview | iOS stores | 15-30 s, 30 fps max, device sizes | the core interaction in 0-3 s; 3-5 features with copy; title or disclosure at the end; no hands, devices, prices or dates | required (it autoplays muted) | one track | optional |
|
|
53
|
+
| Google Play preview | Android | the first 30 s autoplay muted | real gameplay within 10 s, at least 80 % representative | no "#1" claims or calls to action | | |
|
|
54
|
+
| Console store | PlayStation, Xbox, eShop | 30-120 s | gameplay-forward, the platform's own footage, a rating card per region; no other platform's logos or button glyphs; captions (Xbox requires .srt) | | | |
|
|
55
|
+
| VR or mixed reality | VR titles | 30 s-2 min | a stabilised spectator camera, a third-person avatar or a mixed-reality composite; "Captured on [device]" | | | |
|
|
56
|
+
|
|
57
|
+
Platform rules change: check the store's current preview and trailer requirements before you render, and keep a
|
|
58
|
+
link to the page you checked in the plan.
|
|
59
|
+
|
|
60
|
+
## 3. The launch package (offer it up front)
|
|
61
|
+
|
|
62
|
+
For a launch, offer the package and ask which pieces are wanted. OG Clash produced all of them over two days, mostly
|
|
63
|
+
unplanned:
|
|
64
|
+
|
|
65
|
+
1. The cinematic trailer (16:9; master 1080p60 by default, 4K60 if asked).
|
|
66
|
+
2. A raw gameplay montage (full HUD, real time, 45-90 s).
|
|
67
|
+
3. A share card: a real graded game frame at 2400x1260 with debug overlays painted out, the game's logo, a call to
|
|
68
|
+
action and the URL; exported as a 1200x630 JPEG under about 300 KB plus a PNG, a 1200x1200 square and a favicon set
|
|
69
|
+
made from the mark alone (legible at 16 px); `og:*` and `twitter:card` tags with width, height and alt text
|
|
70
|
+
describing the actual frame; cross-origin resource and cache headers on the images; checked on each platform's link
|
|
71
|
+
debugger.
|
|
72
|
+
4. Social cuts: 30 s and 15 s in 9:16 with burned-in captions, and an inline 720p preview under 50 MB.
|
|
73
|
+
|
|
74
|
+
Check the end card's "play now" claim against the game's real first-load time on typical connections, and test the
|
|
75
|
+
trailer link landing in the in-app browsers of the networks it will be posted to.
|
|
76
|
+
|
|
77
|
+
## 4. The raw gameplay montage: the proof next to the fantasy
|
|
78
|
+
|
|
79
|
+
The OG Clash owner's brief for it, on launch day: "make sure its good gameplay not like a noob or not able to play
|
|
80
|
+
etc ... i want the full hud ... just from their spawning in and killing first zombies and running and jumping and side
|
|
81
|
+
flipping too just like a real person etc... can be 45-90 seconds long". Their only content note: "why werent u hitting
|
|
82
|
+
and shooting its weak spots? Ur shooting the visor when thats not the objective there?"
|
|
83
|
+
|
|
84
|
+
- **Spec:** 45-90 s at the target resolution; full HUD with frame counters and debug overlays off; real time, no slow
|
|
85
|
+
motion, hard cuts, no text; segments of 4-10 s in the order a player meets them (menu, character, loadout, spawn and
|
|
86
|
+
first kills, movement, aimed kills, the game's signature systems, an objective, the boss); first person for aiming,
|
|
87
|
+
the game's own third-person view for acrobatics (first-person flips read as a camera spin).
|
|
88
|
+
- **Play the game correctly on camera.** For every beat, read the on-screen objective, prompt and subtitle, and make
|
|
89
|
+
the action fulfil it with visible success feedback. Check it in a 720p rehearsal before the master take.
|
|
90
|
+
- **Skilled play only.** Drive play with a capture-only aim and fire helper, not a playtest bot (OG Clash's bot got
|
|
91
|
+
stuck on rubble): fire only when the aim is on a visible target, the nearest threat under about 7 m first, aim down
|
|
92
|
+
sights past about 7 m, pulse semi-automatic triggers, aim at a visible point rather than the centre of mass. Never get hit on camera (cut before contact). No player stuck, firing at nothing, or
|
|
93
|
+
score jumps between cuts that reveal developer setups. God mode and fixtures stay off camera.
|
|
94
|
+
- **Audio:** record with the game music muted, and verify the mute by loudness (a mute that failed silently cost a full
|
|
95
|
+
nine-segment reshoot). Lay the game's own score per act (menu, play, boss) with crossovers of about 0.3 s under the
|
|
96
|
+
raw effects, 12 ms fades at each cut, about −16 LUFS, true peak at or under −1 dBTP.
|
|
97
|
+
- **Delivery:** OG Clash delivered a 4K60 HEVC master at about 32 Mbps (`hvc1` tag, `+faststart`), a 1080p60 x264 CRF
|
|
98
|
+
17 copy and a 720p inline preview at about 6.5 Mbps. Post a preview sheet per segment as each
|
|
99
|
+
lands, and the inline preview the moment a cut exists.
|
|
100
|
+
- **It is a QA pass on the game.** Watch subtitles and voice for duplicates or bugs (one line was said and subtitled
|
|
101
|
+
twice) and file each as a game note.
|
|
102
|
+
- **Launch media loses to the release.** "dont worry about montage v2 put all ur power into just getting this out".
|
|
103
|
+
There may be no second pass: rehearse objectives and get it right the first time.
|
|
104
|
+
- **Uploads share the network.** Do not upload a large video while the game is deploying; a 130 MB upload broke a
|
|
105
|
+
production deploy. Warn the game team first.
|
|
106
|
+
|
|
107
|
+
## 5. The share card
|
|
108
|
+
|
|
109
|
+
A real in-game hero frame at 2400x1260 with debug overlays painted out, graded (an S-curve, a split tone, a vignette, bloom on
|
|
110
|
+
lights, fine grain), the game's lockup, the call to action and the URL. Flat brand type, no gradient or shimmer. Export
|
|
111
|
+
the sizes above, alt text that describes the real frame, cache headers on the images, and validate on the link
|
|
112
|
+
debuggers of every network it will be shared to. Verify every URL against the live domain before it ships (a request
|
|
113
|
+
once named the wrong domain). Show the owner the card before it goes out.
|
|
@@ -0,0 +1,273 @@
|
|
|
1
|
+
# Briefs: what to hand each agent
|
|
2
|
+
|
|
3
|
+
Write a brief to disk before spawning any agent; the brief is the agent's whole context. Fill every `{brace}`. Paste
|
|
4
|
+
the whole brief, not a summary of it. These are the briefs the OG Clash trailer ran on, with what each one learned.
|
|
5
|
+
|
|
6
|
+
## 1. Common brief (every agent reads it first)
|
|
7
|
+
|
|
8
|
+
> Film: a {length} s, {aspect}, {resolution and frame rate, default 1080p60} {archetype} for **{GAME}**, {one line on
|
|
9
|
+
> the game: genre, engine, platform}. Bar: {floor and bar references} combined with {the edit bar}. The previous film
|
|
10
|
+
> of this kind was rated 6/10 by its owner; this one aims for 11/10. Track: {path} ({length} s, instrumental), measured
|
|
11
|
+
> in `research/MUSIC.md` and `research/grid.json`.
|
|
12
|
+
>
|
|
13
|
+
> Frozen game build: {build id}, hash {hash}. Servable release: {path}. Source clone (read only): {path}. Film build
|
|
14
|
+
> (capture-only hooks, defaults identical to the frozen build): {path}, owned by {role}. The game team's workspace is
|
|
15
|
+
> read only.
|
|
16
|
+
>
|
|
17
|
+
> House rules:
|
|
18
|
+
> - Write only inside {film repo}/{your output path}. Never modify the game team's workspace. Never stop other
|
|
19
|
+
> people's servers or kill processes you did not start (by verified process id, never by pattern). Never use
|
|
20
|
+
> `git stash` in a shared checkout.
|
|
21
|
+
> - Every browser, GPU capture, render, encode or build goes through {your machine's job queue, if it has one} with
|
|
22
|
+
> thread caps (`ffmpeg -threads 6`). Browsers are headless and muted. Waiting for a slot is normal.
|
|
23
|
+
> - Machine share: {for example, film 45 %, at most 2 heavy jobs}; declare bursts in {file} with a time window; yield
|
|
24
|
+
> new jobs to the game team's profiling windows.
|
|
25
|
+
> - Never play audio aloud. Analyse audio with ffmpeg, Python and a speech recogniser only.
|
|
26
|
+
> - Storage: render and capture on internal disk; copy finished files to {archive} when it is present and writable
|
|
27
|
+
> (verify a checksum), else to the local `outputs/` folder. Keep proxies and select audio local. Keep {N} GB free:
|
|
28
|
+
> check before every take; delete rejected masters, keep proxies.
|
|
29
|
+
> - Secrets: never print, log or pass keys as command-line arguments; read them inside the process.
|
|
30
|
+
> - Paid calls only through the capped ledger, on the person's own account. Spend approved: {their approval,
|
|
31
|
+
> verbatim}.
|
|
32
|
+
> - Append one progress line to `work/PROGRESS.log` about every 20 minutes: `{UTC time from date -u} {role} {what you
|
|
33
|
+
> just finished}`. Machine-written lines for takes, mixes, renders and QA.
|
|
34
|
+
> - Report measurements and file:line evidence, not impressions. Never invent a number. Never write "the owner wants"
|
|
35
|
+
> unless they said it; quote them.
|
|
36
|
+
> - Requests to another agent go in `work/REQUESTS.md` (`{UTC} {from} -> {to}: {title}`, then What, Ask (the smallest
|
|
37
|
+
> change, off by default), Until then). Decisions go in `plan/DECISIONS.md`, one dated line each, kept current all
|
|
38
|
+
> film.
|
|
39
|
+
|
|
40
|
+
## 2. Research fan-out (plan step; launch in parallel within minutes of the brief)
|
|
41
|
+
|
|
42
|
+
Every research agent is read-only, writes one file into `research/`, backs every claim with a file and line or a
|
|
43
|
+
measurement, never invents a number, and writes a progress line every 20 minutes. Run at most about 6 heavy agents; a
|
|
44
|
+
research agent may fan out read-only helpers with numbered questions ("return a structured report of 250-400 lines,
|
|
45
|
+
every bullet with path:line, UI strings quoted").
|
|
46
|
+
|
|
47
|
+
- **R-GAME, the game bible (20-30 min):** "Become the expert on {GAME} as a player and as a trailer director would need.
|
|
48
|
+
Read the project's instructions and design docs, then the source; skim recent development notes for intent. Write
|
|
49
|
+
`research/GAME.md` (under about 1,500 lines): the pitch in the game's own words; the core loop end to end with every
|
|
50
|
+
set piece's timing; every weapon, ability and upgrade path; characters, friendlies, enemy types, boss phases, and
|
|
51
|
+
which voice ships as audio against subtitle-only; the map with a coordinate convention, named places, the ten most
|
|
52
|
+
cinematic places, lighting and time of day, the game's own cinematic cameras; reusable audio with paths; brand assets;
|
|
53
|
+
**known risks that would hurt footage** (crashes, stuck AI, animations people complained about, stand-in models, build
|
|
54
|
+
text, developer shortcuts that skip set pieces). Search code comments and QA notes for past complaints. Do not run the
|
|
55
|
+
game."
|
|
56
|
+
- **R-CAPTURE, the capability map (about 30 min, one short probe):** "Answer the capability checklist C1-C19 for this
|
|
57
|
+
game with file:line evidence: command bridge, clocks, frame stepping, fixed-rate traps, free camera and cuts, HUD per
|
|
58
|
+
element, staging, probe, quality lock, readback, audio, repeatability, crash classes, boot gates, prior capture
|
|
59
|
+
tooling. Recommend an architecture with throughput numbers and the minimal film-build hooks (file, field, default off).
|
|
60
|
+
Run at most one short headless probe (stepped against real time, per-frame command injection, readback cost)."
|
|
61
|
+
- **R-MUSIC, measure the track (about 20 min each):** "Measure {track} like a music editor cutting a trailer to it.
|
|
62
|
+
Deliver `research/MUSIC.md` (duration from samples, integrated loudness, true peak, range, tempo checked at half and
|
|
63
|
+
double, downbeat phase, splices, a bar map in seconds and 60 fps frames, sections, every hit, drop, stop and hole, the
|
|
64
|
+
feel of each section, an honest mapping to the brief that says where the real transitions are), `research/grid.json`,
|
|
65
|
+
a click-check WAV verified by measurement, an energy plot and the ending check. Never play audio aloud." With no track:
|
|
66
|
+
run the music decision and measure the 2-3 candidates.
|
|
67
|
+
- **R-REFS, measure the references (about 75 min with labellers):** "Find, download (private 480p proxies kept locally)
|
|
68
|
+
and measure {10 or more} official trailers of the genre (floor: the classics; bar: the newest flagship releases) and
|
|
69
|
+
{5-10} community edits. Use adaptive cut detection with strobe rejection; never trust ffmpeg's scene score alone on
|
|
70
|
+
dark footage. Spawn labellers from one rubric on disk (shot types for this genre, feature beats, HUD seconds,
|
|
71
|
+
transitions). Deliver `research/REF-TRAILERS.md` and `research/REF-EDITS.md` with the per-film table, the act
|
|
72
|
+
template, a steal list of 20-25 measured moments each mapped to something in the game (file:line), and the avoid list.
|
|
73
|
+
Measure the references' loudness too."
|
|
74
|
+
- **R-TASTE, the owner's eye, after the measurements:** "Read the owner-eye chapter and the notes ledger. Map each house
|
|
75
|
+
rule to this film as HARD, SOFT or N/A. List every conflict between the house rules and the genre's measured norms,
|
|
76
|
+
each with a default and a one-line ask. Write `research/TASTE.md` with a pre-flight checklist and the critic and proxy
|
|
77
|
+
briefs adapted to this film." **Run it after R-REFS lands:** OG Clash ran it before, at 12 of 37 downloads, and the
|
|
78
|
+
brief overruled its defaults within hours.
|
|
79
|
+
- **R-SOUND, voices and the sound inventory (about 20 min):** "Find how the game casts voices (voice ids, model,
|
|
80
|
+
settings, processing) and its shipped voice; measure every game sound file (duration, loudness, true peak, phone-band
|
|
81
|
+
share, sub share, key against the track) organised by the film's beats with the code that triggers each; flag sub-only
|
|
82
|
+
cues, key clashes, other studios' names, and gaps that need new sound. If the person approved paid voice, make one test
|
|
83
|
+
line per role through the capped ledger (OG Clash's tests cost under $3). Check intelligibility with a speech recogniser with and without a name prompt.
|
|
84
|
+
Deliver `research/VOICES.md` and `research/SOUND-INVENTORY.md`."
|
|
85
|
+
- **R-ANIM, animation audits (after the rig exists):** "Audit every character and enemy clip the plan might use, on
|
|
86
|
+
rendered frames: contact sheets, motion metrics, a verdict of USABLE, CAMERA CARE (with the framing), NO or NOT
|
|
87
|
+
REPRODUCED, and staging rules. Write the deliverable as soon as the first half is graded."
|
|
88
|
+
|
|
89
|
+
## 3. Shot builder (one per sequence of shots)
|
|
90
|
+
|
|
91
|
+
> Read first, in order: the common brief; the shot-spec contract (the filmable chapter); the rig's README; the shared
|
|
92
|
+
> shot library (import it, never fork it; changes go through the director); `plan/PLAN.md` (the film's one language);
|
|
93
|
+
> `plan/shots.json` (your shots: timeline frames a..b at 60 fps, kind first person or cinematic, the pair for
|
|
94
|
+
> first-to-third-person hand-offs, payoff frames where the action peaks); `research/GAME.md`; `research/CAPTURE.md`;
|
|
95
|
+
> the animation audits; the craft chapter; the owner-eye chapter; the notes ledger; the film build's hooks file.
|
|
96
|
+
>
|
|
97
|
+
> Your job: for each shot you own, write the spec, shoot 2-4 drafts at 720p on the film build, look at them, iterate,
|
|
98
|
+
> then shoot one take at the master format of the version you expect to select, then write
|
|
99
|
+
> `capture/selects/{n}.json` with take, proxy, take in and out, timeline in and out, payoffs (timeline, take, what),
|
|
100
|
+
> measurements (camera px/f per frame, payoff evidence), build, previous select, notes, and a self-review.
|
|
101
|
+
>
|
|
102
|
+
> Conventions: recorded frame 0 is timeline frame a − 30 (30-frame handles both ends); payoffs on the listed frame ±1
|
|
103
|
+
> (scripted) or ±3 (outcomes), measured from the probe. First-to-third-person pairs are one take with a camera cut and a
|
|
104
|
+
> HUD switch on the second shot's first frame. Speed ramps live in the take: real simulation only, 1x approach, payoff
|
|
105
|
+
> 1-3 frames before the beat, ease to 0.25x over 6-8 frames, hold 24-36 frames with the camera at 2 px/f or more, back
|
|
106
|
+
> to 1x over 10-12 frames; hitstop off; shutter scaled with the step. Every take enters on the wind-up, moves from frame
|
|
107
|
+
> 0 to the last (1 px/f or more), carries 2 px/f or more into the cut in the next shot's direction, performs one whole
|
|
108
|
+
> action and cuts on the payoff. First person keeps moving unless a scoped hold pays off within 0.3 s, with the
|
|
109
|
+
> cinematic aim assist so kills look skilled; one character's hands all film; the best finishes under the scene's real light. Cinematics: monotone cubic paths, roll at most 0.2 rad,
|
|
110
|
+
> no shake, no depth of field on the subject. Characters never idle, posed or seen from behind; only clips the audit
|
|
111
|
+
> passed, framed as it says. Enemies in motion, in numbers, at distance or on impact, one gait per horde, no visible
|
|
112
|
+
> feet on glitchy crowds, readable space between hero and enemies, spawned in the stepped preroll. Screen direction per the map. Nothing random, nothing stuck, no T-poses, no floating first-person arm,
|
|
113
|
+
> no debug overlays, no world markers that read as HUD, nothing popping in or vanishing. Persist every environment override in the spec or the select.
|
|
114
|
+
>
|
|
115
|
+
> Self-review (be harsh; it is the first gate): a full-resolution strip at the source frame rate around the payoff and
|
|
116
|
+
> both ends; motion per frame; the share of clipped highlights; flat white on any effect; the angular rate
|
|
117
|
+
> of animated heroes in slow spans (no frame under 40 % of the median); each
|
|
118
|
+
> applicable gate PASS or FAIL with frames; three honest lines (great, weak, with another hour). Reject your own takes
|
|
119
|
+
> freely. Flag anything the owner may call cheap to the director with the frame; if it is still unresolved, it goes to
|
|
120
|
+
> the owner before the cut ships.
|
|
121
|
+
>
|
|
122
|
+
> House rules: only your shot files and selects; your own port range; at most one master-resolution take in flight; a
|
|
123
|
+
> progress line every 20 minutes. Report in 120-300 words: per shot the select, payoff accuracy, the self-review, what
|
|
124
|
+
> is placeholder, what is unchecked, and the calls the owner might want to change.
|
|
125
|
+
|
|
126
|
+
## 4. Fixer (one per owner of a file set, per round)
|
|
127
|
+
|
|
128
|
+
> **The owner's notes, verbatim, at the top:** {quotes with ledger numbers, times, frames}.
|
|
129
|
+
>
|
|
130
|
+
> Read the common brief first (its decisions are binding). You own {files or shots}. Not yours: {everything else,
|
|
131
|
+
> especially the shared library and the timeline}.
|
|
132
|
+
>
|
|
133
|
+
> Findings to fix (numbered, from the filtered fix list): {shot and frames}: what is wrong (measured), the target (a
|
|
134
|
+
> number), the reference moment.
|
|
135
|
+
>
|
|
136
|
+
> **First confirm each defect at the cited frames on the current render.** If it is not there, say so and skip it.
|
|
137
|
+
>
|
|
138
|
+
> **Do not change:** {the must-not-change list, verbatim}.
|
|
139
|
+
>
|
|
140
|
+
> Specify the change and freeze the rest. Check on rendered frames (renders of 60 frames or fewer, or 720p drafts), never
|
|
141
|
+
> by reading code. Make the smallest change that answers the note ("a tad" means a tad); when one instance was flagged,
|
|
142
|
+
> sweep the class in your file set. Time box: if nothing lands within about {75} minutes, finish with what exists and
|
|
143
|
+
> say so. Report in 120-300 words: what changed (frame ranges, numbers before and after), what is placeholder, what is
|
|
144
|
+
> unchecked, and the calls the owner might want to change.
|
|
145
|
+
|
|
146
|
+
## 5. Blind harsh critic (fill the braces; paste the whole thing)
|
|
147
|
+
|
|
148
|
+
> You are a harsh, unbiased creative director reviewing {a N-second game trailer} for {GAME, one line}, in the role of
|
|
149
|
+
> the people who make {the genre's flagship official trailers} and of {the community's best montage editor}. You did
|
|
150
|
+
> not make it and have no stake in it. Be specific and severe; praise only what is at that bar. Read only: do not edit
|
|
151
|
+
> any project file, and do not look at any source code, plans, notes, briefs or history; judge only the film. Flattery
|
|
152
|
+
> is useless and vague taste notes are useless: every note must be specific, measured where possible, and actionable by
|
|
153
|
+
> a motion designer, editor or cinematographer.
|
|
154
|
+
>
|
|
155
|
+
> The film: {path} ({resolution} review render; the master will be {format}). {If unfinished: placeholder cards
|
|
156
|
+
> labelled "SHOT n" are not captured yet; skip them but judge how the real shots around them flow.} The track is
|
|
157
|
+
> {instrumental}; the drop lands at {s}.
|
|
158
|
+
>
|
|
159
|
+
> References (measure them, look at frames): {paths}. Their measurements: {files}. The owner's eye: {the owner-eye
|
|
160
|
+
> chapter} and {the notes ledger} (newer notes win). Notes the owner already gave on this cut, not to be reported again:
|
|
161
|
+
> {list}.
|
|
162
|
+
>
|
|
163
|
+
> Method: ffmpeg only; 2 fps overviews; 10-30 fps strips at every cut; full 60 fps strips across every speed ramp and
|
|
164
|
+
> around the drop; frame-exact grabs with `select=eq(n\,N)`; adaptive cut detection (the scene score alone misses 30-70 %
|
|
165
|
+
> of cuts on dark footage); optical flow for camera px/f; `signalstats` and `blurdetect`; beats and onsets; `ebur128`; a
|
|
166
|
+
> speech recogniser on the mix. `nice -n 10`. Never play audio aloud. No browsers, no renders. Append a progress line to
|
|
167
|
+
> {log} every 20 minutes.
|
|
168
|
+
>
|
|
169
|
+
> House constraints your fixes must respect (or say plainly that you propose an exception): {for example: no picture
|
|
170
|
+
> crossfades, opacity fades or dim overlays; no post motion blur or frame blending; no interpolated slow motion; no post
|
|
171
|
+
> shake; no added grain, flares or glitches; the HUD policy; the music never dips by accident, designed silences
|
|
172
|
+
> allowed}.
|
|
173
|
+
>
|
|
174
|
+
> Deliver {review/rNN/CRITIC.md}:
|
|
175
|
+
> 1. A measured headline: real shots, cut count, median and mean shot, the longest run of equal shots, first-person
|
|
176
|
+
> share (whole film and action section), cuts within ±2 frames of a beat, action peaks within ±2 frames of a beat,
|
|
177
|
+
> visible ramps, dead shots (camera under 1 px/f), luma jumps at cuts, repeated setups, first-person hand
|
|
178
|
+
> consistency, voice lines and words per minute, loudness per section, the loudest moment, designed silences; the
|
|
179
|
+
> references' numbers side by side.
|
|
180
|
+
> 2. A verdict and scores out of 10 for picture, motion, camera, edit (ramps, cut placement, sync), flow, aura, story,
|
|
181
|
+
> effects and grade, title, sound, against the official trailers and the montage edits separately; the biggest
|
|
182
|
+
> reason it is not at the bar.
|
|
183
|
+
> 3. As the owner: every problem as a timestamp (seconds and 60 fps frame), the one blunt line they would say, and the
|
|
184
|
+
> craft fix, ranked by how annoyed they would be; then the "you should know this by now" list; end with exactly
|
|
185
|
+
> `Proxy score: N/10` and whether they would call it production grade.
|
|
186
|
+
> 4. At least 15 fixes, each with exact frames, what is wrong (measured), the reference moment it falls short of (file
|
|
187
|
+
> and timestamp) and a buildable fix (frames, easing, playback rate, camera path, staging). Prefer small surgical
|
|
188
|
+
> fixes.
|
|
189
|
+
> 5. Taste checks critics usually miss, each with frames: cheap-looking effects (blurred glow balls, flat puffs, clipped
|
|
190
|
+
> white: report the share of pixels at or above 225 in limited range, 244 after conversion to full-range RGB); animation that reads as a puppet, a T-pose, a freeze or a foot
|
|
191
|
+
> glitch; characters idle or posed unnaturally; any frame with no sharp subject; a mechanic shorter than 1.2 s; sounds
|
|
192
|
+
> that stop dead on a cut; a title or insert that does not sit in the world (light, saturation, size, overlap);
|
|
193
|
+
> inconsistency between shots of one subject; screen direction; anything that randomly comes in; a held or drifting
|
|
194
|
+
> shot whose subject slides out of frame and leaves sky or empty ground; the hero dying, respawning or waiting on
|
|
195
|
+
> screen; a set so dark it reads black on a phone; two shots in one act framing the same place and people the same
|
|
196
|
+
> way; promised text (the title, a call to action) missing, unreadable or seen from behind; the hero sitting on the
|
|
197
|
+
> bottom edge or out of frame on a follow camera; a silence that starts late or with a chop; a slow-motion hit heard
|
|
198
|
+
> before it is seen.
|
|
199
|
+
> 6. Must not change: what already works and must survive, with frames.
|
|
200
|
+
> 7. Sound: section loudness; the bed's steadiness under voice (any accidental dip of 2 dB or more is a defect); voice
|
|
201
|
+
> intelligibility word by word; designed hits against picture impacts (±2 frames); the phone-band share of hits;
|
|
202
|
+
> tails at cuts; clicks; odd noises.
|
|
203
|
+
> 8. If a previous report exists: every earlier finding marked Fixed, Partly or Still there, with evidence.
|
|
204
|
+
|
|
205
|
+
**Owner-proxy add-on** (when run as a separate lens): "Be the owner. Read the owner-eye chapter and the notes ledger
|
|
206
|
+
in full first. For each problem: the timestamp (seconds and 60 fps frame), what they would say in one blunt line in
|
|
207
|
+
their voice, then the concrete fix in craft terms. Rank by how annoyed they would be. Then a separate list of things
|
|
208
|
+
they would still ask for that are not there yet. Score out of 10 against {the bar}, `Proxy score: N/10`, and say whether
|
|
209
|
+
they would call it production grade. Praise nothing they would not."
|
|
210
|
+
|
|
211
|
+
**Blind A/B add-on:** "Two cuts, A and B, unlabelled (the key is out of your view). Judge every shot and every seam:
|
|
212
|
+
which is better and why, with frames. Flag any section where the better cut is worse in some respect the other got
|
|
213
|
+
right, so nothing good is lost (what the loser did better). Tally per seam. Do not guess which is newer."
|
|
214
|
+
|
|
215
|
+
**Gap-to-11 add-on:** "The owner rated the previous film 6/10. Explain, frame by frame, what separates this cut from a
|
|
216
|
+
true 10/10 and an 11/10 (the trailer people rewatch and share). Cover story and emotional beats, the hook in the first
|
|
217
|
+
3 s, sync and edit rhythm, speed ramps, camera language, animation and acting, effects, grade and colour script,
|
|
218
|
+
gameplay readability, transitions, sound design (impacts, risers, silences, voice), the title, the ending and button,
|
|
219
|
+
pacing variety, anything cheap or random. Then what would make it 11/10: signature moments specific to this game's
|
|
220
|
+
footage. Then the measurable gates a future cut must pass."
|
|
221
|
+
|
|
222
|
+
## 6. Resume brief (written before the usage limit, not after)
|
|
223
|
+
|
|
224
|
+
> Resume brief #{n} ({director}, {UTC time}): {what this session must deliver}.
|
|
225
|
+
>
|
|
226
|
+
> The previous session {hit its usage limit / was killed by a restart} at {time} and every agent stopped mid-task. You
|
|
227
|
+
> are a fresh agent picking up a role. Read this, then the common brief, your role brief, and your role's last lines in
|
|
228
|
+
> `work/PROGRESS.log` and `work/REQUESTS.md`. Everything is on disk. **Do not redo what already exists: check first**
|
|
229
|
+
> (select timestamps, take QA files and proxies, the progress log's tail). Do not trust your role's old plans blindly.
|
|
230
|
+
>
|
|
231
|
+
> What changed since the stop: {storage state; build hash; machine share; the owner's newest notes, verbatim, with
|
|
232
|
+
> ledger numbers}. Round rules: {the current fix list's principles}. Owners: {role, shots or files, ports, state at the
|
|
233
|
+
> stop}. Unreviewed takes that landed after the stop: {list: review the proxy, select or reject; do not reshoot}. Scope,
|
|
234
|
+
> if frozen: {item, state, owner}; dropped: {list}; one cut when {items} are in; if one item runs more than about 45
|
|
235
|
+
> minutes behind, cut without it and say which. Finish line: {for example, the next full cut, then a blind critic and an
|
|
236
|
+
> A/B against cut {id} (worse shots revert), then send to the owner; the master only after they approve a cut}. When your
|
|
237
|
+
> items are done, write `{role} FINAL DONE` in the progress log and stop.
|
|
238
|
+
|
|
239
|
+
## 7. Notes from the film to the game team (append-only)
|
|
240
|
+
|
|
241
|
+
Copy this header into `handoff/GAME-NOTES.md` on day one, and ask the owner to paste the protocol into the game team's
|
|
242
|
+
own instructions, so it survives the game team changing tools or agents.
|
|
243
|
+
|
|
244
|
+
> The {GAME} film team is filming the game and sends game feedback through this file. Read it at the start of every
|
|
245
|
+
> round. Each note has an id (F-n), the date, a priority, what looks wrong, the owner's words verbatim, the evidence
|
|
246
|
+
> (frame paths), where it lives in the code (file:line at the frozen build), what "fixed" looks like, the film's interim
|
|
247
|
+
> workaround and the film shot it serves. Reply in `handoff/GAME-REPLIES.md` (append-only), one line per note: `F-n:
|
|
248
|
+
> {round that ships it} {what changed}` or `F-n: won't do, because ...`. When the film fixes something in its capture
|
|
249
|
+
> build, the patch is linked here so the game can take it as is. Priority: P1 is visible in the film now and looks
|
|
250
|
+
> cheap; P2 the film works around; P3 nice to have. Keep items that do not serve the film out of this file. The film
|
|
251
|
+
> reads both files and each new build receipt, and moves a shot onto a newer build only when that build is visibly
|
|
252
|
+
> better for it. Do not edit anything else in the film repo.
|
|
253
|
+
|
|
254
|
+
A note, filled in:
|
|
255
|
+
|
|
256
|
+
```
|
|
257
|
+
## F-1 ({date}, P1) {what looks wrong}
|
|
258
|
+
- Owner: "{their words}"
|
|
259
|
+
- Evidence: {frame paths}
|
|
260
|
+
- Code: {file:line at the frozen build}
|
|
261
|
+
- Fixed looks like: {a measurable description}
|
|
262
|
+
- Film workaround: {flag or framing}
|
|
263
|
+
- Serves: shot {n}
|
|
264
|
+
- Patch: {link, if the film fixed it: behind one flag, no globals, resolution-relative sizes, bounded pools, tested at
|
|
265
|
+
gameplay frame rates and full load, with before and after crops and a measurement}
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
On day one, file a P1 note for every hero moment that depends on game behaviour (kills, deaths, boss mechanics,
|
|
269
|
+
pickups). When the game team declines a note, record it and keep the film-build workaround. On OG Clash, 10 of 11 notes
|
|
270
|
+
shipped within about 36 hours once each had its own owner on the game side; notes that named a cause at file:line and a
|
|
271
|
+
measured defect ("head climbs in a straight line, R² 0.98") shipped fastest, and the game reworked a kill because the
|
|
272
|
+
note named the film shot it served. What failed: six rounds of "pending the next release" while nobody owned the notes,
|
|
273
|
+
one note never assigned, and replies drifting into unrelated items. The film never waits on the game.
|