@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.
Files changed (385) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/README.md +12 -4
  3. package/dist/.claude-plugin/marketplace.json +26 -0
  4. package/dist/skills/manifest.json +1409 -145
  5. package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
  6. package/dist/skills/opengame-accessibility/SKILL.md +48 -32
  7. package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
  8. package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
  9. package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
  10. package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
  11. package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
  12. package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
  13. package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
  14. package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
  15. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
  16. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
  17. package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
  18. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
  19. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
  20. package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
  21. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
  22. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
  23. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
  24. package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
  25. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
  26. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
  28. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
  29. package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
  31. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
  32. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
  33. package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
  34. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
  35. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
  36. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
  37. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
  38. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
  39. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
  40. package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
  41. package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
  42. package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
  43. package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
  44. package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
  45. package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
  46. package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
  47. package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
  48. package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
  49. package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
  50. package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
  51. package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
  52. package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
  53. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
  54. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
  55. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
  56. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
  57. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
  58. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
  59. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
  60. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
  61. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
  62. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
  63. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
  64. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
  65. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
  66. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
  67. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
  68. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
  69. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
  70. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
  71. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
  72. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
  73. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
  74. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
  75. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
  76. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
  77. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
  78. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
  79. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
  80. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
  81. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
  82. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
  83. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
  84. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
  85. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  86. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
  87. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
  88. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
  89. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  90. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  91. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  92. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  93. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  94. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  95. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  96. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  97. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
  98. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
  99. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
  100. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
  101. package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
  102. package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
  103. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
  104. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
  105. package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
  106. package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
  107. package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
  108. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
  109. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
  110. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
  111. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
  112. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
  113. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
  114. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
  115. package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
  116. package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
  117. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
  118. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
  119. package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
  120. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
  121. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
  122. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
  123. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
  124. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
  125. package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
  126. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
  127. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
  128. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
  129. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
  130. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
  131. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
  132. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
  133. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
  134. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
  135. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
  136. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
  137. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
  138. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
  139. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
  140. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
  141. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
  142. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
  143. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
  144. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
  145. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
  146. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
  147. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
  148. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
  149. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
  150. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
  151. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
  152. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
  153. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
  154. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
  155. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
  156. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
  157. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
  158. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
  159. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
  160. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  161. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  162. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
  163. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
  164. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  165. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  166. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  167. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
  168. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
  169. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
  170. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  171. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
  172. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  173. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
  174. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
  175. package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
  176. package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
  177. package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
  178. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
  179. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
  180. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
  181. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
  182. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
  183. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
  184. package/dist/skills/opengame-api/CHANGELOG.md +12 -0
  185. package/dist/skills/opengame-api/SKILL.md +39 -13
  186. package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
  187. package/dist/skills/opengame-assets/SKILL.md +79 -31
  188. package/dist/skills/opengame-assets/references/pipeline.md +67 -0
  189. package/dist/skills/opengame-audio/CHANGELOG.md +11 -0
  190. package/dist/skills/opengame-audio/SKILL.md +129 -41
  191. package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
  192. package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
  193. package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
  194. package/dist/skills/opengame-capture/SKILL.md +44 -20
  195. package/dist/skills/opengame-capture/references/pipeline.md +33 -1
  196. package/dist/skills/opengame-capture/references/threejs.md +17 -1
  197. package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
  198. package/dist/skills/opengame-characters/SKILL.md +94 -39
  199. package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
  200. package/dist/skills/opengame-characters/references/player-og.md +1 -1
  201. package/dist/skills/opengame-cli/CHANGELOG.md +20 -0
  202. package/dist/skills/opengame-cli/SKILL.md +12 -11
  203. package/dist/skills/opengame-deploy/CHANGELOG.md +30 -0
  204. package/dist/skills/opengame-deploy/SKILL.md +43 -23
  205. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  206. package/dist/skills/opengame-deploy/references/manifest.md +9 -3
  207. package/dist/skills/opengame-deploy/references/packaging.md +32 -30
  208. package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
  209. package/dist/skills/opengame-depth/SKILL.md +61 -33
  210. package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
  211. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  212. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  213. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  214. package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
  215. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  216. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  217. package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
  218. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  219. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  220. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  221. package/dist/skills/opengame-jam/CHANGELOG.md +12 -0
  222. package/dist/skills/opengame-jam/SKILL.md +48 -33
  223. package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
  224. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  225. package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
  226. package/dist/skills/opengame-loading/SKILL.md +78 -38
  227. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  228. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  229. package/dist/skills/opengame-look/CHANGELOG.md +9 -0
  230. package/dist/skills/opengame-look/SKILL.md +122 -51
  231. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  232. package/dist/skills/opengame-look/references/painterly.md +69 -0
  233. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  234. package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
  235. package/dist/skills/opengame-maps/SKILL.md +78 -0
  236. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  237. package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
  238. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  239. package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
  240. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  241. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  242. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  243. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  244. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  245. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  246. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  247. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  248. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  249. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  250. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  251. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  252. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  253. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  254. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  255. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  256. package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
  257. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  258. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  259. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  260. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  261. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  262. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  263. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  264. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  265. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  266. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  267. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  268. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  269. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  270. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  271. package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
  272. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  273. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  274. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  275. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  276. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  277. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  278. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  279. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  280. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  281. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  282. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  283. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  284. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  285. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  286. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  287. package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
  288. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  289. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  290. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  291. package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
  292. package/dist/skills/opengame-performance/SKILL.md +106 -65
  293. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  294. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  295. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  296. package/dist/skills/opengame-production/CHANGELOG.md +13 -0
  297. package/dist/skills/opengame-production/SKILL.md +119 -54
  298. package/dist/skills/opengame-production/references/team.md +107 -0
  299. package/dist/skills/opengame-production/references/templates.md +106 -16
  300. package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
  301. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  302. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  303. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  304. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  305. package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
  306. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  307. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  308. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  309. package/dist/skills/opengame-router/CHANGELOG.md +12 -0
  310. package/dist/skills/opengame-router/SKILL.md +14 -7
  311. package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
  312. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  313. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  314. package/dist/skills/opengame-sdk/CHANGELOG.md +16 -0
  315. package/dist/skills/opengame-sdk/SKILL.md +27 -10
  316. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  317. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  318. package/dist/skills/opengame-sdk/references/leaderboards.md +11 -1
  319. package/dist/skills/opengame-sdk/references/radio.md +1 -1
  320. package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
  321. package/dist/skills/opengame-stability/SKILL.md +59 -27
  322. package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
  323. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  324. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  325. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  326. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  327. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  328. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  329. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  330. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  331. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  332. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  333. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  334. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  335. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  336. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  337. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  338. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  339. package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
  340. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  341. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  342. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  343. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  344. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  345. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  346. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  347. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  348. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  349. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  350. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  351. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  352. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  353. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  354. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  355. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  356. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  357. package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
  358. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  359. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  360. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  361. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  362. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  363. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  364. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  365. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  366. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  367. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  368. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  369. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  370. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  371. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  372. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  373. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  374. package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
  375. package/dist/skills/opengame-verification/SKILL.md +113 -48
  376. package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
  377. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  378. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  379. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  380. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  381. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  382. package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
  383. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  384. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  385. package/package.json +1 -1
@@ -0,0 +1,92 @@
1
+ # Title: a 3D title that lives in the world
2
+
3
+ The OG Clash title took six owner notes and four rebuilds. Its camera match was exact from day one (0.068 px mean
4
+ error) and it still looked like "a sticker". The lesson: **a correct camera track is not enough; the title must behave
5
+ like a physical object in that world.** The OG Snipers montage's end title took 23 hand-ins over three days and was
6
+ nearly cut altogether. Settle the title from stills on the real plate on day one.
7
+
8
+ ## How the OG Clash title evolved, so you can skip it
9
+
10
+ 1. Broken, dashed lightning strands (141 fragments) became traced continuous bolts.
11
+ 2. A particle "forge-in" borrowed from the game's loading screen: "how it appears those particles is terrible it should
12
+ probably just be there... and no shimmer please".
13
+ 3. A static lockup with crackle on the beat: "it cant ovelrap with characters like this and also we need to make sure
14
+ its perfectly motinon tracked and angled", then "this does not look motion tracked properly and its too big and it
15
+ doesnt look like 3d ... not just an iamge thats motion tracked".
16
+ 4. A placement solver, solid geometry and lightning from the first frame: "can we make the lighting and camos and color
17
+ correction of the logo look like its part of the world".
18
+ 5. Matched to the world and composited before the grade. Approved.
19
+
20
+ ## The procedure (any engine; a 3D package such as Blender for the title)
21
+
22
+ 1. **Use the game's own logo art.** Segment it into pieces (by hand or with a segmentation model), separate painted
23
+ energy (lightning, fire) from the base colour, and keep the game's palette. Never use another game's or studio's
24
+ logo, type or emblem as a starting point.
25
+ 2. **Real geometry:** extrude the silhouettes in tiers with bevels, depth about 20 % of the logo's height; side and bevel
26
+ faces get their own materials (OG Clash: cracked stone at roughness about 0.85, iron at about 0.45, metallic); keep
27
+ self-illumination low (OG Clash went from 0.42 to 0.10 to 0.05); cast sun shadows.
28
+ 3. **The true camera, not a feature track.** Log the engine camera on every frame of the take (position, look target,
29
+ vertical field of view, roll). Rebuild the basis exactly (`f = normalize(look − pos); r0 = normalize(f × up);
30
+ u0 = r0 × f`, roll applied, field of view converted to sensor and lens, axes converted per engine). Prove it with
31
+ markers on logged joints (OG Clash: 0.068 px mean, 0.196 px max) and a background feature track (0.18 px RMS, 0.19 px
32
+ drift). Unreal is left-handed Z-up with a horizontal field of view; Unity is left-handed Y-up with a vertical one.
33
+ 4. **A fixed world object.** Anchor it in world space at a believable distance (OG Clash: 110 m out over the far pit, in
34
+ front of 125-182 m towers) with a fixed yaw toward the final camera (25°), **never camera-facing**. Size it like an
35
+ object at that distance: about 19-30 % of frame width at rest.
36
+ 5. **Never overlap a character on any frame.** Solve the placement per frame: project the logo's bounding box and a
37
+ conservative 3D box around characters and props on every frame of the take; search distance, height and screen
38
+ position for a minimum pixel gap above 0 (OG Clash: no overlap on 426 frames, the tightest gap 56.6 px). If the logo
39
+ must pass behind something, export a depth or object-ID matte from the engine.
40
+ 6. **Arrival:** the logo exists from the shot's first frame (pre-rolled so it is already in frame at the cut) and the
41
+ camera finds it (a crane up, a pull back). No particle assembly, no forge-in, no shimmer, no glint, no breathing.
42
+ **At rest it is still:** with the camera locked and the energy off, the frames are bit-identical.
43
+ 7. **Match the plate numerically** against scenery at the same depth, in ungraded plate space: the black floor lifted to
44
+ the haze floor; a highlight knee (OG Clash: 0.55, peak 0.80); saturation (0.40 brought to 0.25 against towers at
45
+ 0.14); emissive peaks below the brightest light in the shot (lava from 250 down to 196 under torches at 253); haze
46
+ toward the ambient (0.28); light wrap (0.30); softness (0.55 px, no sharper than the architecture); grain (0.010).
47
+ Light it like the shot: key and rim from the sky behind, a dim fill, fire bounce only on lower faces.
48
+ 8. **Composite before the grade,** so the film's look goes over plate and title together (a title composited after the
49
+ grade looked pasted on). Deliver straight alpha; a premultiplied render clips additive light through a straight-over
50
+ composite (`a' = max(a, max(rgb))`).
51
+ 9. **Structured energy on the beats:** trace the art's painted bolts into continuous forked strokes (skeletonise, prune
52
+ spurs under 13 px, bridge gaps up to 26 px); a thin core, an inner glow, a wide glow and a halo; a new strike every 3
53
+ frames; discrete strike bursts on beats from `grid.json` (13 strikes over a 7 s shot, the biggest on the bar
54
+ downbeat, the second on the home chord); **live from the logo's first visible frame**; nothing clipping (blue peak
55
+ at most 230 of 255). Write a strike list so sound lays one designed crackle per strike.
56
+ 10. **QA:** camera match (marker reprojection mean ≤ 0.1 px, maximum ≤ 0.25 px; background track ≤ 0.25 px RMS, no
57
+ drift); centring (the centroid of alpha above 0.25); drift ≤ 0.3 px/f against the anchor; crispness (Laplacian variance at least 0.9 of the
58
+ hold median); the settle frame; slide (ink centre against the anchor's projection); the gap to characters per frame;
59
+ strike visibility; stillness at rest.
60
+ 11. **Confirm it is in the cut.** OG Clash once rendered a 4K title that was never wired into the edit list; the cut went
61
+ out with no title.
62
+
63
+ **Cost on OG Clash:** about 2 s a frame at 1080p and 32 samples on a quiet machine with a real-time renderer (bolts
64
+ added 50 %); about 25 s a frame at 4K and 48 samples under load (2-3 hours for 360 frames). Preflight at 720p, review at
65
+ 1080p, render the master resolution only after approval. Render so a restart resumes (only missing frames, every image
66
+ verified); never delete a frame that is still being written.
67
+
68
+ ## What a montage owner wanted instead
69
+
70
+ On the OG Snipers montage the owner wanted the game's name only, as a material with a life of its own:
71
+
72
+ - "it should be floating in the air not on the ground this looks liek its not part of the scene" (letters at 0.7 m read
73
+ as standing on the ground).
74
+ - The letters come together from close by and keep closing to the last frame, faster at first ("even till the end its
75
+ coming together"), never a lock and hold.
76
+ - Mirror chrome that reflects the scene, coloured only by the effect that lights it, occluded by the scene's smoke, with
77
+ every visible strike heard ("chrome and have sfx for the lightning effect").
78
+ - A heavy condensed face with tight spacing, chosen from a sheet of four or five real fonts on the real plate.
79
+ - After five chrome and glass hand-ins the owner said "lets remove the text", then kept the previous glass version
80
+ sixteen minutes later. Offer a cut without the title early, and keep the last approved version as the default while a
81
+ new one is built beside it.
82
+ - Verify the title on the finished file against its approved comp: a fixed box's luma and saturation. A render that
83
+ graded the finished title comp a second time delivered a darker title than the one approved.
84
+
85
+ ## Where it sits
86
+
87
+ - Map and launch trailers: at 84-90 % of runtime, on the swell or after a silence, then a 4-6.5 s end card and a button.
88
+ Story trailers may open on it (Black Ops 3 put it at 27-36 %).
89
+ - Franchise marks (flat 2D logos) use the smash-cut style: an oversized cropped piece, then a crash-zoom or pull-out to
90
+ the lockup in 4-14 frames. A game's own 3D logo uses this chapter.
91
+ - A pixel-art game's title uses the game's own pixel font on its grid; a smooth vector title over pixel art breaks the
92
+ one world.
@@ -0,0 +1,5 @@
1
+ # opengame-trailer-review-and-improve changelog
2
+
3
+ ## 1.0.0
4
+
5
+ First public release: the review loop for any trailer cut, with blind critics, an owner proxy, measured gates, a filter, blind A/B and a notes ledger that turns every owner note into a check. Built from the OG Clash launch trailer and its gap-to-11 review.
@@ -0,0 +1,145 @@
1
+ ---
2
+ name: opengame-trailer-review-and-improve
3
+ description: Review and improve any cut of a game trailer. Covers logging the owner's notes word for word, blind critics measured against official trailers and the best editors, an owner proxy and a sound lens, gates for what critics miss (cheap effects, puppet animation, freezes, blur, cut-off sound, a title not in the world), filtering fixes, blind A/B so only better shots survive, and turning every note into a check. Use when notes arrive on a trailer cut, and before any trailer cut is sent.
4
+ metadata:
5
+ version: "1.0.0"
6
+ ---
7
+
8
+ # Trailer review and improve
9
+
10
+ Step 3 of 3, repeated every round: `opengame-trailer-plan`, then `opengame-trailer-make`, then **review and improve**.
11
+
12
+ This is the most important of the three. It is the owner's loop, in their words:
13
+
14
+ 1. "spawn an adversarial, harsh critic ... Do it."
15
+ 2. "Address the feedback."
16
+ 3. "Try to self-improve."
17
+ 4. "Get feedback again from a harsh, blind, unbiased critic."
18
+ 5. "But don't make things worse. Only strictly make things better."
19
+
20
+ And for a trailer: "keep looping using adversarial subagents to give you harsh criticism on flow and aura and quality and
21
+ production level ... until its same Level as a black ops official trailer AND a kaiser edit", because "i do NOT want to
22
+ have to keep watching shitty takes and giving u feedbaxk thqt u should be able to know ill give u".
23
+
24
+ On OG Clash the loop ran twice in 47 hours (3/10, then 4.5/10), never ran a blind A/B, and was dropped at a scope freeze;
25
+ the shipped film is a 6/10. Critics measured motion and timing; the owner caught cheapness, animation, time to read,
26
+ integration and consistency. This skill measures both. For notes on a montage cut to a song, use
27
+ `opengame-montage-review-and-improve`: its owner overrides several trailer defaults.
28
+
29
+ ## Read first
30
+
31
+ - [references/review.md](references/review.md): the procedure in depth, the filter, and the table of checks that would
32
+ have caught every OG Clash note.
33
+ - [references/gates.md](references/gates.md) and [references/measure.md](references/measure.md): the numbers, and how
34
+ to measure each one with ffmpeg, Python and a speech recogniser (no special tools needed).
35
+ - [references/briefs.md](references/briefs.md): the critic, owner-proxy, blind A/B, gap-to-11 and fixer briefs, word for
36
+ word.
37
+ - [references/owner-eye.md](references/owner-eye.md): how a demanding owner reviews, the anticipation table, the
38
+ pre-send checklist, the recurring notes with their rules.
39
+ - [references/core.md](references/core.md), [references/craft.md](references/craft.md) (what a fix should aim at),
40
+ [references/finishing.md](references/finishing.md) (QA and delivery), [references/ops.md](references/ops.md)
41
+ (cadence and talking to the owner) and [references/og-clash-record.md](references/og-clash-record.md) (the gap-to-11
42
+ report: the depth a review should reach).
43
+ - When a fix needs the making side: [references/filmable.md](references/filmable.md) (capture and the film build),
44
+ [references/title.md](references/title.md), [references/music.md](references/music.md),
45
+ [references/archetypes.md](references/archetypes.md) (formats, the raw gameplay montage, the share card) and
46
+ [references/edge-cases.md](references/edge-cases.md).
47
+
48
+ ## Round procedure
49
+
50
+ ### 0. Ingest the owner's notes first, word for word
51
+
52
+ - `date -u` first. A burst of screenshots and one-liners within a minute is one batch; say which cut it lands in.
53
+ - Append each note to the notes ledger: the next number, the rule in bold, their exact words with typos, the UTC time,
54
+ the cut, the timecode and frame, what the frame shows (look at it), the scope (this game or every film), and what it
55
+ supersedes. A note that applies to every film goes into your core rules too.
56
+ - Catch messages that arrived while you were working; filter out other agents' or sessions' messages; confirm which thread a note is
57
+ for when it mentions game features.
58
+ - Read negative notes narrowly; treat a hedged question as a note; sweep the whole class; make the smallest change that
59
+ answers the note; **when they call something cheap, try removing it first;** never paraphrase their words into a
60
+ stronger instruction.
61
+ - Write `work/NOTES-<cut>.md`: one line per note with an owner and how it will be checked on the render; carry over
62
+ anything asked and not yet done.
63
+ - Reply in one short message: what you understood, ambiguities each with a default, the ETA. After a big note, an
64
+ interim cut within about an hour.
65
+
66
+ ### 1. Blind review (parallel, no GPU, immediately on the newest cut that passes QA)
67
+
68
+ Launch the lenses from the briefs chapter: a **picture and edit critic** (in the role of the genre's official trailer
69
+ makers and its best montage editor), an **owner proxy** (be the owner; it ends with `Proxy score: N/10`), a **sound**
70
+ lens (measure like a mixer), and once per film a **gap-to-11** critic. Critics are blind: rendered files, reference films
71
+ and measurements, the notes ledger and the house constraints only; never code, plans or briefs. List the notes already
72
+ given. Give each lens its previous report to mark Fixed, Partly or Still there. Run critics on the models the person's
73
+ setup already has; do not buy API credit for them without asking.
74
+
75
+ ### 2. Gates: run them yourself, every round
76
+
77
+ The measured checks for what critics usually miss: motion on every frame and across every cut, slow-span motion and
78
+ per-character angular rate, flat white on hero effects, sharpness against the film's norm, mechanic shot lengths, screen
79
+ direction, first-person share, tails at cuts, accidental ducks, voice intelligibility on the mix, the title's gap,
80
+ stillness and world match, luma at cuts, flashes, loudness, the story beats present. A FAIL is a finding like any
81
+ critic's.
82
+
83
+ ### 3. Filter, merge, route
84
+
85
+ - Filter every proposal through the rules (the review chapter) and log each rejection: no post blur or frame blending,
86
+ no interpolated slow motion, no opacity or dissolve glue, no post shake, no invented effects, no accidental ducks, no
87
+ thresholds invented from taste, nothing that reverses a ledger line without a newer note. Do not import bans from
88
+ product videos blindly: engine whip blur, structured glow, in-world flashes and designed silences are legitimate here.
89
+ - Game values come from the game, never from a reviewer. Verify each claim on the current render before routing it.
90
+ - One ranked list: their notes, then what they would raise next, then craft findings. Write the fix list: 2-3
91
+ principles, global items and per-shot items with owners and numeric targets, and the **must-not-change** list.
92
+ - Route each fix with the fixer brief: their note word for word on top, confirm the defect first, the must-not-change list, a
93
+ time box.
94
+
95
+ ### 4. Fix, render, verify on the render
96
+
97
+ Fixers check rendered frames. Verify every notes line on the new render, frames and audio; anything you cannot see on a
98
+ frame stays open. Confirm the cut carries the latest select for every fix you announced.
99
+
100
+ ### 5. Blind A/B: only strictly better
101
+
102
+ A fresh critic gets the previous cut and the candidate as unlabelled A and B (the key out of view), judges every shot and
103
+ cut, and says what the losing cut did better. **Any shot judged worse reverts.** Their explicit choices outrank the
104
+ critic. Loop 1-3 times as time allows, **but never hold a cut they are waiting on:** send it as pre-review, say what was
105
+ skipped, keep looping.
106
+
107
+ ### 6. Deliver
108
+
109
+ The file the moment it is verified, playable inline (720p under 50 MB for a chat), with what changed mapped to their
110
+ notes, what is still open, where the full file is, and the next ETA from measured throughput. Per-shot clips of changed
111
+ shots while a full cut renders. The master only after they say a cut is good. On a scope freeze: the frozen list and the
112
+ dropped list, one cut, about 45 minutes for late items.
113
+
114
+ ### 7. When is it done
115
+
116
+ The loop is done when it reaches the bar, not when it stops: two fresh blind critics both at 8.5/10 or better, or the
117
+ round cap agreed with the owner, and the owner's approval. A rescope that stops it is logged in `film/SKILLS.log` as a
118
+ stop, not a finish. Throwaway engine-test trailers the owner scopes as one shot run one pass inside their budget.
119
+
120
+ ### 8. Feed the method (every round, before you finish)
121
+
122
+ - Every note into the ledger; every-film rules into your core rules; changed rules into the chapter they belong to,
123
+ noting the old version.
124
+ - **Anything the owner caught that no critic or gate did becomes a new measurable gate and a line in the critic brief's
125
+ taste checks.** This is how the next film starts higher.
126
+ - Ops notes for any failure that cost a round; new references, measured; the round's cut, verdict and lesson in the
127
+ film's history; at the end of the film, its gap-to-11 report. A line in `film/SKILLS.log` for this round.
128
+
129
+ ## How a demanding owner reviews (pre-empt it)
130
+
131
+ Frame crops with one blunt line, in bursts; timecodes from the player; hedged but right; literal about "no X"; freezes
132
+ scope and then hands over the last mile; wants to see progress constantly and gets angry at waiting, repeats and
133
+ regressions. Praise sounds like "sick", "aura", "flow", "production grade", "jawdropping". Complaints sound like "random",
134
+ "cheap", "terrible", "boring", "not smooth", "cut off", "unnatural", "doesnt look 3d". The full anticipation table is in
135
+ the owner-eye chapter; tick it with frames before every send.
136
+
137
+ ## Don't
138
+
139
+ - Don't send a cut you have not watched and measured, or a link you have not loaded.
140
+ - Don't let a critic see the code, the plan or the intent.
141
+ - Don't accept a change because it is new: only because a blind A/B says it is better, or the owner asked.
142
+ - Don't say a note is done on the strength of the code. Show the frame.
143
+ - Don't hold a finished cut for another loop while the owner waits.
144
+ - Don't answer "cheap" with more effects, and don't answer a hedge with silence.
145
+ - Don't let the same note come twice: if it did, the method did not learn; add the check that would have caught it.
@@ -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.