@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,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.
@@ -0,0 +1,129 @@
1
+ # Core: the trailer method in one chapter
2
+
3
+ Read this whole. It decides what else applies.
4
+
5
+ The method comes from the OG Clash launch trailer: a 62 s cinematic trailer of a co-op zombies game (C compiled to
6
+ WebAssembly, rendered with WebGPU), made by agents in 47 hours over 4 chained sessions, with about 80 subagents, about
7
+ 100 owner notes, 63 renders and 2 blind critic rounds. It shipped, and two days later its owner rated it 6/10. The
8
+ skills `opengame-trailer-plan`, `opengame-trailer-make` and `opengame-trailer-review-and-improve` exist so the next
9
+ film starts above that. The target is 11/10: the trailer people rewatch and share.
10
+
11
+ ## 1. The loop (not optional)
12
+
13
+ The owner's loop, in their words: "spawn an adversarial, harsh critic ... Do it." Then "Address the feedback." Then
14
+ "Try to self-improve." Then "Get feedback again from a harsh, blind, unbiased critic." Then "But don't make things
15
+ worse. Only strictly make things better." For trailers they added: "keep looping using adversarial subagents to give
16
+ you harsh criticism on flow and aura and quality and production level ... until its same Level as a black ops
17
+ official trailer AND a kaiser edit".
18
+
19
+ - **Blind critics** see the rendered file, the references and the owner's notes, nothing else. They run on every cut,
20
+ need no GPU, and start the moment a cut passes QA.
21
+ - **Gates** are measured by you on every cut. They catch what critics miss: cheapness, animation, time to read,
22
+ integration, consistency.
23
+ - **Filter** every proposal through the rules and log what you reject. The owner's explicit calls outrank critics.
24
+ - **Blind A/B: only strictly better.** Any shot judged worse than the previous cut reverts.
25
+ - **Never make the owner wait** on a finished cut for another loop. Send it labelled pre-review and keep looping.
26
+ - **The method learns every round.** Every note goes into a notes ledger; anything the owner caught that nothing else
27
+ did becomes a gate. No note is given twice.
28
+
29
+ ## 2. The bar
30
+
31
+ - **Measured references, not memories.** The floor is the genre's classic official trailers; the bar is its newest
32
+ flagship official trailers; the edit bar is the community's best editor. For OG Clash: the World at War "Der Riese"
33
+ trailer as the floor, the Black Ops 6 and 7 zombies map trailers as the bar, and the zombies montages of Kaiser (a
34
+ FaZe montage editor) and NoahsEdits as the edit bar. References are for measurement only: never cut another studio's
35
+ footage into the film, and never recreate another studio's game, characters, logo or shots.
36
+ - **Calibration.** The shipped OG Clash trailer: 6/10 from its owner; 5.5/10 against the Black Ops trailers and 4/10
37
+ against a Kaiser edit from a blind critic. That is the floor of this method.
38
+
39
+ ## 3. Principles
40
+
41
+ 1. **Story, not a feature list.** A hook in the first 3 s (a question or an image), a promise, an escalation, a
42
+ **turn** (the reversal), a payoff that shows the impact frame, and a **button** after the title. At least one
43
+ **character moment** and one **signature moment** only this game can do. The 6/10 film had every system and no arc.
44
+ 2. **Performed on the beat.** Cuts on the beat are table stakes. The action inside the shot hits the beat, and cuts
45
+ marry hits and whooshes. A critic's line on the OG Clash first cut: "the cuts are on the beat but nothing actually
46
+ happens on the beat."
47
+ 3. **Every shot performs one whole action; every cut carries motion.** Enter on the wind-up, cut on the payoff, give
48
+ the shot a reason to arrive. Nothing still that should move; nothing random.
49
+ 4. **Speed ramps are the signature, and they must be legible.** Real simulation slow motion, never interpolated;
50
+ fast, slow, fast inside one shot; motion through the slow span; nothing freezing.
51
+ 5. **Contrast makes it big.** Two to four designed silences followed by slams, a loudness spread of at least 8 LU,
52
+ the loudest moment on the climax or the title, a colour world per act, a breath before the end.
53
+ 6. **Only show what the engine does well.** Audit animations and effects on frames before planning; frame out what
54
+ fails (feet, holds, puppets); never invent effects on a hero; when something is called cheap, remove it first.
55
+ 7. **Everything sharp and readable.** No depth-of-field mush; a mechanic held at least 1.2-1.5 s; clear geography and space.
56
+ 8. **One world.** The title and every insert are physical objects in the world: 3D, lit and graded like it, never
57
+ overlapping a character, still at rest.
58
+ 9. **Characters talk; nobody announces.** Voice density follows the brief (references run 5-8 lines a minute; the OG
59
+ Clash brief asked for many lines and shipped 13 in 62 s), in-world, on the right shot, never a wall over the drop.
60
+ 10. **Sound never cuts out and never sounds cheap.** Tails through cuts, a designed hit on every big event, the music
61
+ never dipping by accident.
62
+ 11. **Shoot it, don't record it.** Freeze the build, fork a capture-only film build, step the clock, script every shot
63
+ as code, fix cheap effects at the source and hand the patch back to the game team. `opengame-capture` lists the
64
+ hooks a game needs to be filmable; build them into the game if you own it.
65
+ 12. **Show progress constantly.** A review page from hour one, a preview every 30-60 minutes, ETAs from measured
66
+ throughput, files and pictures rather than pipeline talk.
67
+ 13. **The format is asked, default 1080p at 60 fps, 16:9.** 4K60 or 30 fps on request.
68
+
69
+ ## 4. Beyond 10/10: what an 11/10 has
70
+
71
+ A competent trailer at the bar passes the gates. An 11/10 also has at least two of these, designed in the plan:
72
+
73
+ - **A silence drop on the climax:** the music cuts to total silence on the impact frame for about 0.6 s (one small
74
+ sound from the world), then the slam. The shareable 3 seconds.
75
+ - **A match-cut chain:** 4-6 one-beat shots, each entering through the previous shot's shape (circles, slashes, eyes),
76
+ ending in the logo. The one idea people remember.
77
+ - **A tone-clash button:** a last beat after the end card that plays on the game's personality. For OG Clash, plush
78
+ heroes against a grim world: a marshmallow toasted over the dead boss's glowing chest, a hand reaching in from
79
+ off-screen, a bonk, a cut on the beat.
80
+ - **A one-take first-to-third-person move:** first person pulls out of the head into an orbit around the action,
81
+ possible only because the film build owns the camera.
82
+ - **A count-up build:** an in-world counter (round, score, combo) ticking on consecutive beats into the turn.
83
+ - **A spoken title:** one character says the name as the logo lands, then half a second of nothing.
84
+ - **A crew-identity beat:** name cards slammed on a held moment, or each hero's signature line on their own shot.
85
+
86
+ ## 5. Which chapter covers what
87
+
88
+ | Module | Where |
89
+ |---|---|
90
+ | Story, structure, rhythm, the archetype | craft (structure, rhythm); archetypes (plan, make, review) |
91
+ | Music | music (plan, make, review); craft (music and the clock) |
92
+ | Capture of the game | filmable; `opengame-capture` for the in-game hooks |
93
+ | Ramps, camera, first and third person | craft |
94
+ | Characters, enemies, animation | craft; filmable (the animation audit) |
95
+ | Effects and light, transitions, grade | craft |
96
+ | Title | title (plan, make, review) |
97
+ | Voice, sound and mix | craft; finishing (the mix) |
98
+ | Ending, button, end card | craft |
99
+ | Edit, render, QA, delivery | finishing |
100
+ | Raw gameplay montage, share card, social cuts | archetypes |
101
+ | Unusual games | edge cases |
102
+ | Team, machine, sessions, talking to the owner | ops; briefs |
103
+ | Review | review; gates; briefs (critic) |
104
+ | Measuring anything | measure |
105
+
106
+ Every chapter above is carried by all three trailer skills except the reference set, which only `opengame-trailer-plan`
107
+ carries (the table of measured trailers and edits).
108
+
109
+ ## 6. Working rules
110
+
111
+ - **All three skills, every trailer, in order:** plan, then make, then review-and-improve, the last repeated each
112
+ round. Keep a log with one UTC line per skill invocation (`film/SKILLS.log`) plus the plan, the storyboard, the gate
113
+ results and a review file per round. When a batch of quick trailers was made with a trimmed process that skipped
114
+ the skills, the owner asked "are u sure we did the skills?" and the answer was no.
115
+ - **The loop is done when it reaches the bar, not when it stops.** Review-and-improve runs until two fresh blind
116
+ critics both score 8.5/10 or better, or a round cap you agreed with the owner. A rescope that stops it is recorded
117
+ as a stop, not a finish. One exception: a throwaway engine-test trailer the owner explicitly scopes as one shot (the
118
+ OG test trailers were 30 minutes each, no revisions) runs the three skills once inside that budget.
119
+ - Settle the format, archetype, music and must-show list in the plan (one message of questions, each with a default).
120
+ - Research fans out in minutes; references and music are measured before the shot list.
121
+ - Briefs on disk before agents; state on disk always; one owner per file set; one director.
122
+ - Heavy jobs (browsers, captures, renders, encodes) go through your machine's job queue if it has one, with thread
123
+ caps. Render and capture on internal disk; an archive drive is optional and may disappear.
124
+ - Never play audio aloud; never print secrets. Paid generation (music, voice, video, image, 3D) runs only on the
125
+ person's own account, with their explicit go-ahead on the spend, through a capped ledger. OG Clash's voice and
126
+ effects came to $2.79 of a $200 cap the owner approved in writing.
127
+ - Review cuts first; render the master only after the owner says a cut is good.
128
+ - Tear everything down at delivery (watchers, schedules, background jobs) and feed what you learned back into the plan
129
+ templates and gates you keep for the next film.