@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,109 @@
1
+ # Charting
2
+
3
+ How OH wrote charts that the owner called "great", with the numbers that held. Every
4
+ value here is a reference configuration from OH, a five-lane keyboard game on A S J K L
5
+ with four levels; scale them for other lane counts and inputs.
6
+
7
+ ## Why transcription failed
8
+
9
+ Six rounds, about 17 agent-hours and up to 162 GB of separated stems went into charting
10
+ mixed recordings. Precision and recall of "the lead's notes", onset within 50 ms:
11
+
12
+ | Method | Precision / recall |
13
+ |---|---|
14
+ | Loudest onsets of the whole mix, lanes by brightness | the owner: "completely random keys at random times" |
15
+ | Melody tracker on separated stems | 0.50 / 0.61 |
16
+ | Logistic regression on 18 per-note features, best one-voice path | 0.61 to 0.63 / 0.61 to 0.65 |
17
+ | Boosted trees, retrained on riffs, then an onset rule (held out) | 0.66 / 0.45 to 0.63 / 0.57 |
18
+ | Lead at or above the band, against 2 dB or more under it | 0.78 / 0.59 against 0.50 / 0.30 |
19
+ | A large multi-instrument transcription model | 0.22 / 0.26 |
20
+
21
+ Timing was never the problem; choosing which notes was. Strummed songs have no single
22
+ line to find. Two hidden faults cost more than the method: the pipeline's own clean-up
23
+ removed two thirds of the notes it later reported missing, and the game filtered out
24
+ notes it judged "not heard in the whole mix". A paid stem service measured at one call
25
+ would have cost about $2,100 for the whole catalogue; the owner chose a free separator,
26
+ and an approved test of the paid one placed only 41% of melody notes at the same times.
27
+
28
+ So: if you can, compose. If you cannot, get stems or scores from the rights holder.
29
+
30
+ ## Genre calibration without audio
31
+
32
+ Aggregate counts from the published note charts of 38 songs of a commercial five-lane
33
+ game. No audio was fetched and nothing was copied into the game; use counts like these,
34
+ never a chart.
35
+
36
+ | | Easy | Medium | Hard | Expert |
37
+ |---|---|---|---|---|
38
+ | Notes a second, median (p10 to p90) | 1.61 (1.32 to 2.18) | 2.44 (1.94 to 3.03) | 3.40 (2.31 to 4.42) | 3.98 (2.59 to 5.21) |
39
+ | Median gap | 480 ms | 323 ms | 214 ms | 189 ms |
40
+ | Busiest second | 4 | 5 | 8 | 10 |
41
+ | Sustain share | 21% | 15% | 11% | 9% |
42
+
43
+ - Lower levels sit on Expert note times 99.5% of the time.
44
+ - Expert lane moves of 0, 1, 2 and 3 or more lanes: about 28, 50, 14 and 7%.
45
+ - 98.4% of Expert notes sit on a sixteenth or triplet grid.
46
+ - To fit your thinning, feed each published Expert chart to your own reduction and compare
47
+ strike for strike with the published easier levels. OH's first rules kept 60, 47 and
48
+ 32% of Expert where the published levels keep 85, 61 and 41%; the refit kept 82, 66
49
+ and 44%.
50
+
51
+ ## Composing songs as data
52
+
53
+ - A small score language: notes by pitch and length, bars checked by assertion, phrase
54
+ marks, and a `/` where the playing hand may move.
55
+ - One featured part per song, never humanised ("the lead is the song"). Only the band is
56
+ humanised.
57
+ - Samples trimmed to onset and tuned (OH's libraries were off by up to 20 to 30 cents).
58
+ - After the owner found the first song "a bit boring": at least 118 bpm, richer harmony,
59
+ full song forms, and a hook of two bars and at most five pitches that comes back and
60
+ lands long.
61
+ - The lead's register mattered more than its timbre: leads at MIDI medians 83 to 90, where
62
+ hand-written songs sat at 72 to 81, lost 0.4 to 0.9 of a listener model's score.
63
+ - A listener model is a compass, not proof. A synthesised snare cost about 0.27; one
64
+ text-and-audio model scored two different styles 0.9995 alike and was useless. The owner
65
+ hears a sample of each style before it is made in bulk.
66
+ - Freely licensed sample libraries only (CC0, and CC BY with a visible credit), with the
67
+ licence on file per song. Mark `*.wav -text` in `.gitattributes`: line-ending conversion
68
+ corrupted 121 of one library's 1,776 files.
69
+
70
+ ## The chart from the notes
71
+
72
+ 1. **Expert** is the featured part at its sounding time.
73
+ 2. **Keys by pitch, phrase by phrase.** Up to five pitches get a key each, spaced by
74
+ interval (a step or third next door, a fourth to a sixth skips one); wider phrases
75
+ share keys where the tune steps least; a returning phrase returns on the same keys.
76
+ 3. **Hand gates** (OH `check.py`):
77
+ - same key at least 150, 150, 190 and 300 ms apart (Expert, Hard, Medium, Easy);
78
+ - any two notes at least 85 ms apart;
79
+ - busiest second at most 10 notes.
80
+ 4. **Chords**: two keys whose width shows the interval; accent chords from a tone the
81
+ band holds, a third to a sixth below, on whole beats, grouped per repeated phrase;
82
+ 8% of featured notes at tier 1 to 28% at tier 8.
83
+ 5. **Holds**: at 1.5 beats and 0.5 s, or 1 beat and 0.8 s, ending 40 ms before the next note.
84
+ 6. **Nested reductions**, weighted by metric position, holds, syncopation, phrase edges and
85
+ turning points:
86
+
87
+ | Level | Keep | Cap in a phrase | Chords |
88
+ |---|---|---|---|
89
+ | Hard | 0.86 | 7.5 notes a second | as Expert |
90
+ | Medium | 0.66 | 5.0 | at most 12% |
91
+ | Easy | 0.52 (at most 86 to 88% of Medium) | 2.8 | none |
92
+
93
+ Checker bands: Hard 0.75 to 0.93, Medium 0.38 to 0.76, Easy 0.25 to 0.58.
94
+ 7. **Musical gates**: at least half of eight-note windows recur; at most 20% of bars carry
95
+ a motif heard nowhere else; hand alternation 0.28 to 0.60; one-key runs at most 5; the
96
+ lead silent at most two bars; 120 to 150 s a song.
97
+
98
+ ## Tiers
99
+
100
+ Place songs by measured Expert density, never by intent: 2.2 to 2.9 notes a second at
101
+ tier 1 rising to 5.1 to 6.3 at tier 8. A song that plays under its tier moves down; it is
102
+ never padded. OH's first composed song ran 1.38, 1.89, 2.34 and 2.82 notes a second by
103
+ level.
104
+
105
+ ## Delivery
106
+
107
+ Render, mix, master, chart, gate, then stage under a hash name and promote into one
108
+ atomic index. OH made about ten songs an hour on one job slot, with half the drafts
109
+ refused by the gates.
@@ -0,0 +1,92 @@
1
+ # Timing
2
+
3
+ The song clock, calibration, the count-in and codec delay, as OH built them. Values are
4
+ OH's reference configuration.
5
+
6
+ ## The song clock
7
+
8
+ The clock is the audio hardware's, never the frame's: a key press is stamped by the
9
+ browser when it happens and converted to song time afterwards, so a slow frame cannot
10
+ make a hit late.
11
+
12
+ ```js
13
+ const ctx = new AudioContext({ latencyHint: "interactive" });
14
+ let zero = 0; // context time at which song time is 0
15
+ let offset = 0; // the player's calibration, in seconds
16
+ let smoothed = 0;
17
+
18
+ function start(buffer, leadIn) {
19
+ const source = ctx.createBufferSource();
20
+ source.buffer = buffer;
21
+ source.connect(ctx.destination);
22
+ zero = ctx.currentTime + Math.max(0.05, leadIn);
23
+ source.start(zero);
24
+ }
25
+
26
+ /** Song time for a performance.now()-based timestamp, such as event.timeStamp. */
27
+ function timeAt(perfMs) {
28
+ const ts = ctx.getOutputTimestamp?.();
29
+ if (ts && ts.contextTime > 0) return ts.contextTime + (perfMs - ts.performanceTime) / 1000 - zero - offset;
30
+ const latency = ctx.outputLatency || ctx.baseLatency || 0;
31
+ return ctx.currentTime - zero - latency - offset;
32
+ }
33
+
34
+ /** Once a frame: predict forward, glide, and snap only when far off. */
35
+ function frameTime(dt) {
36
+ const measured = timeAt(performance.now());
37
+ smoothed += dt;
38
+ if (Math.abs(measured - smoothed) > 0.040) smoothed = measured;
39
+ else smoothed += (measured - smoothed) * 0.08;
40
+ return smoothed;
41
+ }
42
+
43
+ addEventListener("keydown", (event) => judge(laneOf(event.code), timeAt(event.timeStamp)));
44
+ ```
45
+
46
+ - Judge in the handler; the frame loop only marks a note missed once it is past the last
47
+ window.
48
+ - Stamp key releases the same way, so holds end at the real release.
49
+ - Self-play cannot test any of this: it lands every note at zero.
50
+
51
+ **Measured in OH** with real key presses sent through the browser's debugging protocol at
52
+ times scheduled off the game's own audio clock, on one 105-note Expert song: mean 1.1 ms,
53
+ p95 2.5 ms, no misses; a 250 ms stall every 1.5 s gave 1.8 ms mean and no misses; 4x CPU
54
+ throttling gave 2.1 ms; offsets of ±80 ms gave 105 of 105 Perfect; the drawn clock
55
+ stayed within 4 ms of the heard one.
56
+
57
+ ## Count-in and resume
58
+
59
+ - Count in on the song's own beat grid, carried back from its first beat. OH's composed
60
+ songs all had their first beat at 0.30 s while the count-in counted from 0, which put
61
+ the clicks about 62% of a beat off at 124 bpm until a sweep of every song found it.
62
+ - Lead-in 2.6 s. On resume, restart the audio after `max(1.2, min(2.4, 3 beats))` s of
63
+ count-in.
64
+
65
+ ## Calibration
66
+
67
+ - A dot falls onto a ring while a click plays on the play clock. Left and right move the
68
+ offset 10 ms, up and down 1 ms, over -200 to +400 ms.
69
+ - Offer it before the first song, in plain words. Do not use a tap test: it measures the
70
+ tapper as much as the speakers.
71
+ - `[` and `]` nudge the audio offset 10 ms during play. A separate picture offset (-100
72
+ to +100 ms) moves only the drawn notes.
73
+ - The ring must be fully drawn at the moment of landing; OH's first version faded it in
74
+ at exactly that moment.
75
+
76
+ ## Codec delay and loudness
77
+
78
+ - MP3 encoders pad the start. OH's 256 kbit/s CBR files carried 1,105 samples (25.06 ms)
79
+ of codec silence. Trim it only when the encoder tag is unambiguous and the decoded audio
80
+ agrees within 0.3 ms; otherwise leave it and say so.
81
+ - Master to one integrated loudness and true peak, measured on the decoded file, not the
82
+ master: OH used -14 LUFS ±0.6 with a ceiling of -0.99 dBTP, and re-mastered any song
83
+ whose decoded MP3 overshot. Pad the last frame.
84
+ - Check by decoding clicks placed at 1.000 s and 60.000 s in every browser you can run,
85
+ within 2 ms. Name the browsers you could not run; OH never ran Safari.
86
+
87
+ ## Recording proof
88
+
89
+ Screencasts from a headless browser are not real time: OH's ran at 25 fps with a 1 to
90
+ 4.6 s offset between video and page, and had no audio stream. Prove timing with in-page
91
+ logs on the song clock and with the real-key timing run above. Audio is judged by a
92
+ person, or by recordings of the master bus aligned to game events (`opengame-audio`).
@@ -0,0 +1,54 @@
1
+ > Carried from `opengame-router` 1.0.8. Read it when: Build, test and submit a browser game on OpenGame. Routes game work to the deploy guide, whole-game review and relevant craft skills. Use when someone asks to make a game, improve a game, check it, deploy it or enter an OpenGame jam.
2
+
3
+
4
+ # Work on an OpenGame game
5
+
6
+ OpenGame opens on 18 November 2026. Any signed-in account can use the CLI,
7
+ uploads and jam entries now. Until 18 November, a CLI or API request with no account
8
+ hears "OpenGame opens for creators on 18 November." Sign in with `opengame login` first.
9
+ That is not a fault in the game.
10
+
11
+ Read [the working process](references/process.md) before changing the game. Keep the
12
+ user's scope and budget. Read only the specialists that apply to the next change.
13
+
14
+ The starting set is this router, `opengame-deploy` and `opengame-quality-bar`.
15
+ Run `opengame skills list --json` to see the installed CLI's catalog. Use
16
+ `opengame help --json` for its skill selection options before installing a specialist.
17
+
18
+ | Work | Skill |
19
+ | --- | --- |
20
+ | Check, deploy, private preview, submit | `opengame-deploy` |
21
+ | A CLI command, its output or its exit code | `opengame-cli` |
22
+ | Calling the API from your own tool or CI | `opengame-api` |
23
+ | Review the whole game | `opengame-quality-bar` |
24
+ | Controls, feedback, camera motion | `opengame-game-feel` |
25
+ | Lighting or color | `opengame-lighting`, `opengame-look` |
26
+ | Collision and movement | `opengame-world-physics` |
27
+ | Maps and levels: spawns, sightlines, guidance, a map that plays wrong | `opengame-maps` |
28
+ | Geometry, props or stairs | `opengame-scene-audit` |
29
+ | Frame time or memory | `opengame-performance` |
30
+ | Models, textures or audio assets | `opengame-assets`, `opengame-audio` |
31
+ | Characters, animation, or the player's own OG | `opengame-characters` |
32
+ | Menus or HUD | `opengame-front-end` |
33
+ | Keyboard, focus or accessibility | `opengame-accessibility` |
34
+ | Rules, goals or progression | `opengame-depth` |
35
+ | Integrating with OpenGame: the SDK, the player and every name field, boards, achievements, events, fullscreen and keys in the frame | `opengame-sdk` |
36
+ | Tests and evidence | `opengame-verification` |
37
+ | First-person guns, sights and viewmodels | `opengame-weapons` |
38
+ | Enemy AI, navigation, hordes, bosses, deaths | `opengame-enemies` |
39
+ | Rhythm and music games: charts, timing, calibration | `opengame-rhythm` |
40
+ | Multiplayer: lobbies, rooms, bots standing in for players | `opengame-multiplayer` |
41
+ | Boot time, streaming, caching, progress bar | `opengame-loading` |
42
+ | Touch, phone memory, Safari on a real phone | `opengame-mobile` |
43
+ | Crashes, pool budgets, error reporting | `opengame-stability` |
44
+ | Screenshots, captures, filming the game | `opengame-capture` |
45
+ | A launch trailer: plan it, make it, review each cut | `opengame-trailer-plan`, `opengame-trailer-make`, `opengame-trailer-review-and-improve` |
46
+ | A gameplay montage cut to a song | `opengame-montage-plan`, `opengame-montage-make`, `opengame-montage-review-and-improve` |
47
+ | A long build with agents and owner feedback rounds | `opengame-production` |
48
+ | Jam fields and eligibility | `opengame-jam` |
49
+
50
+ `opengame-all-in-one` carries every skill in this table as one install, with the order
51
+ to use them in, for a big build that will touch most of them.
52
+
53
+ Run the whole-game review before handing over a finished game. Mark checks that do
54
+ not apply with a reason. Missing tools or evidence mean unverified.
@@ -0,0 +1,38 @@
1
+ # Working process
2
+
3
+ Start by reading the user's request, repository instructions and current changes.
4
+ Keep other people's edits. When several agents share a checkout, agree on file
5
+ ownership before editing. Use the host's permissions and available tools.
6
+
7
+ Choose the smallest change that completes the request. Ask for missing information
8
+ only when it changes what can be done safely or correctly. Keep publication and
9
+ account actions within the user's authorization. A deploy is a private preview;
10
+ public release needs its own approval.
11
+
12
+ Use the user's time, spend and reporting limits. Set a bounded checkpoint before
13
+ starting uncertain research or a paid call. Stop at that checkpoint and report the
14
+ result. Do not invent permission, credentials, a budget or tools that are absent.
15
+
16
+ Inspect the result through the player's route. Keep evidence of input, state changes
17
+ and the frame the player sees. Run relevant checks in sequence. A changed check
18
+ needs a deliberate failing case before its passing result is useful.
19
+
20
+ Ask an independent reviewer to examine the result when the host permits delegation.
21
+ Give them the running artifact and its acceptance criteria. If independent review
22
+ is unavailable, say so and review the diff separately from the implementation.
23
+
24
+ Report what changed, what was observed and what remains uncertain. State blocked
25
+ work and the next useful action. Continue within the agreed scope; do not repeat
26
+ unchanged checks or start another polish pass without a concrete gap.
27
+
28
+ Keep public packages free of credentials, personal data and private transcripts.
29
+ Publish distilled lessons and synthetic examples. Inspect the packed files as well
30
+ as the source before releasing them.
31
+
32
+ ## Long builds with feedback rounds
33
+
34
+ When a game is built over many rounds of the owner's feedback, most lost rounds have
35
+ process causes. OG Clash took about 190 numbered builds to reach its final game. Read
36
+ `opengame-production` before the first build: it covers the bar file written in the
37
+ first hour, the ask register, one integrator, frozen rounds with receipts, the latest
38
+ playable address, usage limits, machine load and status updates.
@@ -0,0 +1,136 @@
1
+ > Carried from `opengame-scene-audit` 1.1.1. Read it when: Audit a 3D browser game's geometry with a script, and its flicker on film. Finds props floating off what is drawn, buried props, overlapping solids, faces tied on the shipped vertex grid, missing colliders and invisible walls, cameras inside solids and duplicate actors, walks every staircase, and proves each check on a planted defect. Use when the person says things float, z-fighting, flicker, invisible walls, I walk through things, the screen goes black, or before calling a level finished.
2
+
3
+
4
+ # Scene audit
5
+
6
+ A scene that looks right in a still can be full of geometry that is wrong: a crate
7
+ hovering a hand's width above the floor, two wall panels in one plane flickering as the
8
+ camera moves, a fence nobody can collide with, a wall of collision with nothing drawn on
9
+ it. Most of these are answerable from the scene's own geometry, headless, in seconds.
10
+ [helpers/scene-audit.js](helpers/scene-audit.js) does it; copy it into the game.
11
+ Flicker is the exception: it lives in motion, and only a film on a stepped clock judges it.
12
+
13
+ Rules carry five tags; `opengame-quality-bar` explains them and the game codes.
14
+
15
+ ## Running it
16
+
17
+ In the browser, against the scene the game actually builds:
18
+
19
+ ```js
20
+ import * as THREE from 'three'
21
+ import { runSceneAudit, fromThreeScene, formatReport } from './scene-audit.js'
22
+
23
+ const scene = fromThreeScene(THREE, world, { colliders: collisionBoxes, groundY: 0 })
24
+ scene.routes = [{ name: 'tower stairs', from: [4, 0, 12], to: [4, 6, -2] }]
25
+ const report = runSceneAudit(scene)
26
+ console.log(formatReport(report))
27
+ ```
28
+
29
+ Mark meshes through `userData`: `collider: true` for collision geometry,
30
+ `nocollide: 'foliage'` for drawn things a body may pass, `hangs: 'lamp on a chain'` for
31
+ things held up by design, `group: 'truck'` for parts of one object that touch on
32
+ purpose, `decal: true` for layered decals, and `gridStep` for the vertex grid a part is
33
+ shipped on when the format quantises positions. A collider the player can see the reason
34
+ for (a fence line, a cliff edge) carries `userData.nodraw` with that reason. In Node,
35
+ build the same `{ parts, colliders, routes }` shape from the level's own layout data; the
36
+ file imports nothing.
37
+
38
+ `report.ok` is true when the applicable checks caught their planted defects, examined
39
+ the scene and found no defects. For a level with no stairs or ramps, pass
40
+ `{ notApplicable: { stairs: "This level has no stairs or ramps" } }`. List a reason for
41
+ each omitted check. An empty check without a reason remains a failure. Findings name the
42
+ part, the world position and why.
43
+
44
+ The adapter reads each visible mesh as one world-space box plus its triangles. It skips
45
+ skinned meshes (characters are judged in `opengame-characters`), and reads an
46
+ `InstancedMesh` as one box around all its instances, so expand instanced props that
47
+ matter into one part per instance before auditing them. A mesh hidden in the scene graph
48
+ but marked `collider` is read as a collider nothing draws, and a `Box3` collider may carry a
49
+ `nodraw` property. Boxes are a first pass: a whole-map merged mesh or a terrain mesh read
50
+ as one box hides every collider under its top, so split those into chunks (or leave
51
+ terrain to `groundY`), and run the engine-side sweeps in the rules below for the rest.
52
+
53
+ ## Rules
54
+
55
+ ### Every check proves itself first
56
+ - **Invariant:** No check reports on the real scene until it has found a known defect planted in it, an applicable check that examined nothing is a failure, and a check never measures with the same inputs the fix it judges used.
57
+ - **Technique:** Before measuring, plant a floating crate, a buried prop, two interpenetrating crates, two coplanar panels, a collider-less wall and an undrawn collider at an open site chosen from the real scene, and a staircase with one riser too tall. Report how many things each check examined. When a check reaches zero by gaining filters or exemptions, plant a defect of each filtered kind and show it is still flagged before believing the zero.
58
+ - **Reference configuration:** DK's first coplanar audit clipped triangles with inverted winding and measured 0 m² on every prop, including one already known to have 0.4 m². AW plants a defect for each of its eight checks into every map under test, and its plants have found two bugs in the checks themselves. OS's integrity audit reached 0/0/0 by adding filters, and its lead refused it until every planted hole was flagged; its plant-grounding check read the same invisible card corners the grounding pass had moved and printed "0 still floating" over about 3,600 floating plants.
59
+ - **Applies when:** Every audit, every run.
60
+ - **Verify:** `formatReport` prints `plant caught` and a non-zero examined count for every check.
61
+
62
+ ### No camera inside a solid
63
+ - **Invariant:** No camera (gameplay, cinematic, spawn, menu or capture) has its near plane inside geometry, and no framed shot is mostly blocked by near cover.
64
+ - **Technique:** Before using a camera position, test a sphere the size of the near plane against the colliders and cast from the subject to the camera; pull the camera in, or reject the position. Aim framed shots from the subject's live joints, so a change of scale moves the camera with it. Reject shots where near cover fills a large share of the frame, and run the same test on every capture camera and every spawn's first view before anyone judges them. In a debug build, log every frame whose camera is inside a collider. In three.js run the test against the physics world (Rapier's shape-intersection queries) or `Box3.containsPoint` on collider boxes, and raycast from the subject with `Raycaster.far` set to the camera distance.
65
+ - **Reference configuration:** OC's game-over screen rendered a black 3D layer from r57 to r66, about 7 hours, because its camera was 0.3 m inside a stone ledge: black at 66.33 m, the full scene at 66.22 m. OC's victory camera ended inside rubble, then inside the boss. OC rejects a shot with more than 25% near cover. OS fails a capture camera or spawn view with more than 25% of the frame within 6 m, written after judges found five of ten first-person spawn views facing a boulder, a wall or grass; 13 of one map's first 39 staged cameras sat in walls, roofs or on cliffs.
66
+ - **Applies when:** Every 3D game with scripted, menu, capture, spawn or follow cameras.
67
+ - **Verify:** Sample every authored camera and every ending camera at each boss scale and arena variant: the audit reports zero cameras inside solids, and the captures contain no black frame with the HUD still drawn.
68
+
69
+ ### Nothing floats, measured on what is drawn
70
+ - **Invariant:** Every part's visible base is held up by the visible surface through some chain of contact, whatever placed it (authored, generated, at load or at runtime), unless it hangs by design and keeps hanging.
71
+ - **Technique:** Seed the supported set from parts resting on the ground or a published floor, then spread support through contact until nothing changes; two parts touching in mid-air do not hold each other up. Seat from drawn geometry: for an alpha card, the lowest opaque texel of each level of detail, never the card's corners. Cast centre and footprint rays against the terrain and the top level of detail; hide an instance over a ledge, otherwise tilt it a little and sink its low edge. Audit with a different measure from the one the placer used, against drawn triangles and excluding the object's own mesh. Keep the `hangs` exemption through every grounding pass. A prop that touches can still look afloat without contact shading, so check contact occlusion reaches it, alpha-tested materials included.
72
+ - **Reference configuration:** AW: a base more than 0.12 m (a hand's width) above its support floats; parts within 0.08 m touch; ten AW boulders hung 0.13 m over a cliff path for nine rounds because each rock's base touched its own cap. OS: "we cant have foliage/grass things floating on any fucking map! wtf si this bs?" (owner). Cards carried invisible skirts of 0.2 to 1.07 m below the blades; measured on the drawn base, floating plants went from 3,059 to 75 to 0 on 16 of 17 maps. Seating used 5 rays, a lean of at most 20 degrees and a 5 cm sink: "Losing a tuft is better than one floating." Runtime barriers floated 8 m up on roofs, and one grounding pass dragged a hanging plant "across a window". Ambient occlusion with a 1.1 m reach "left props floating" until 2.4 m, and alpha-tested materials had none at all.
73
+ - **Applies when:** Any 3D scene with props, procedural dressing, terrain edited after dressing, or anything placed at load or runtime.
74
+ - **Verify:** The float check reports zero, a planted floater on each placement path is flagged, and standing-eye frames agree with it (OS took 24 a map).
75
+
76
+ ### Nothing is sunk
77
+ - **Invariant:** A prop stands on the floor, not in it, while foundations and footings may go as deep as they need.
78
+ - **Technique:** Compare each prop's base with the floor under its centre; anything larger than a prop is structure and is not judged.
79
+ - **Reference configuration:** AW: a prop's base more than 0.25 m under the floor is buried; anything over 2.5 m in plan or height is structure.
80
+ - **Applies when:** Any scene with props on floors or terrain.
81
+ - **Verify:** The buried check reports zero.
82
+
83
+ ### Solids do not share volume
84
+ - **Invariant:** Two solid objects that are not one authored object do not occupy the same space.
85
+ - **Technique:** Judge overlap two ways, because each misses what the other sees: depth past the thinner part's own thickness catches a wall through a wall; a fraction of the smaller part catches two equal crates inside each other. A wall corner overlapping by one thickness is a joint, not a defect.
86
+ - **Reference configuration:** AW: shared volume above 0.02 m³ and either more than 20% of the smaller part or deeper than the thinner part plus 0.05 m. AW's depth-only version missed its own planted defect.
87
+ - **Applies when:** Any scene with placed solids.
88
+ - **Verify:** The interpenetration check reports zero.
89
+
90
+ ### No two faces within the shipped grid of one plane
91
+ - **Invariant:** No two visible faces facing the same way lie within two steps of the vertex grid they ship on (or a fixed tolerance, whichever is larger) and overlap, measured on the positions drawn after cooking and every load-time pass, and no zero-thickness double-sided sheet ships.
92
+ - **Technique:** Measure what the renderer draws: learn the format's position encoding, decode the cooked file, and flag same-facing faces within two grid steps of one plane, inside models and across them. Fix in this order: delete the hidden or back-to-back face first, then lift what must stay well clear of the tolerance (never less than the reference lift below, and at least two or three grid steps), and keep polygon offset for a dedicated overlay such as a decal. Make the fix the last step of every exporter so a re-export cannot bring a tie back. Prefer reversed floating-point depth where the renderer supports it, and recheck draw order after switching. The helper compares parts with each other: set `gridStep` per part (or for the scene), and scan inside each model in the exporter.
93
+ - **Reference configuration:** AW and DK work on float positions: faces within 2 mm of one plane with more than 0.02 m² of overlap; DK found 187.7 m² of fighting surface, 150 m² of it from every crate drawing its rails twice; AW holds wall decals 4 to 90 mm off the wall. OS stored positions at 16 bits per axis over each part's box, so grids ran from about 1.2 to 20 mm: the owner's stripe was faces 1.5 mm apart on a 1.22 mm grid, which an exact-tie check called safe, and a fixed 2 mm lift "rounded back into exact ties". That is why the rule counts grid steps. OS lifts at least 1 cm, two to three grid steps, and the owner pasted the rule twice: "never two visible surfaces in the same plane, lift decals ~1 cm along the normal or draw them with polygon offset (factor -1, units -4)". Lifting before deleting turned 8 spike pixels into 28,089; ties "re-grew" after re-exports until the fix ran last; across 1,192 models ties went from 98,914 to 721. LC: reversed depth made a 1 cm gap at 100 m draw 0 wrong pixels where the old buffer's steps were 24 mm there, but it also reversed draw order and the sky drew over everything; a z-fight mend that put jambs every quarter metre of a doorway made a slat wall bodies walked through, on main for 8 hours.
94
+ - **Applies when:** Every scene with opaque geometry, distant scenery included, and above all formats that quantise positions and kit-built, generated or merged maps.
95
+ - **Verify:** The decoded scan reads zero on the file that landed, the coplanar check reports zero area, and the motion path in the next rule shows the band gone.
96
+
97
+ ### Flicker is judged in motion, on a repeatable path, from every camera
98
+ - **Invariant:** No surface flickers, crawls or swaps while the camera moves, from any camera the game uses (play, aiming and zoom, spawn cinematics, menus, map edges, places a player cannot reach), and each reported flicker's cause is named before it is mended.
99
+ - **Technique:** Script a fixed sequence (still, turn, strafe, walk, and a zoomed pan) on the game's clock with a fixed step, so before and after film identical frames. Count A-B-A reversals after compensating motion with optical flow, mask the reticle and HUD, and score spike pixels per frame per spot. Then name each hotspot's cause with toggles in one session: stepping the near plane re-rolls only depth ties, turning the sun off removes shadow acne, turning temporal anti-aliasing off removes aliasing, and hiding one object at a time finds its owner. Prove the counter on a still frame first. Aliasing counts as flicker too; mend it with `opengame-look`'s thin-detail rule.
100
+ - **Reference configuration:** OS: "so much z fighting / flickering on so many maps still ... that needs to be 0 across all maps every inch..." and "u need to catch them all across every map even in areas u cant see while playing btu spawn in cinematics or around map" (owner). The owner's one word covered at least six causes: coplanar ties, back-face-lit sheets, sub-pixel trim, far-plane clipping, chain-link moiré and shadow stipple. Free-running captures varied 10 to 30%, the stepped path about 5%; the reticle mask removed 75 to 91% of false scoped spikes. The team's bar was 300 spike pixels per frame (0.015% of 1080p) and 13 of 17 maps passed it at the end; the owner never approved that bar, and his own was zero. LC: twenty world leads found 373 coplanar places while the flicker the owner saw was snow-edge noise, normal relief under a lamp at the lens, the lamp's shadow at contact range and ground relief ("nine guesses before that were wrong"), mended by fading sub-pixel relief and keeping normals from facing away from the viewer; with the camera pinned, the clock stopped and the lens moved a quarter pixel, flips fell from 1.64 to 0.00 per 1000 pixels walking. A recorder's grain counted as 209 flips per 1000 pixels and a 2 mm camera drift as flicker.
101
+ - **Applies when:** Any 3D game with temporal anti-aliasing, cascaded shadows, thin geometry, fine relief or zoom.
102
+ - **Verify:** A planted z-fight is flagged on the path, and every spot is under the bar or signed off with three consecutive 1:1 frames.
103
+
104
+ ### Stills catch joins, never motion
105
+ - **Invariant:** The places a person would inspect (contact points, joins, roofs, terrain edges, the skyline, and the view from every camera the game uses) have been inspected on fixed stills, and no still is offered as proof that nothing flickers.
106
+ - **Technique:** Place fixed cameras once per level (two at grazing angles along major walls, one looking up at a ceiling join, one along a terrain edge, one across the busiest floor at prop height, one at the skyline), plus each spawn view, cinematic and menu camera, captured every round so the same views compare before and after. Judge flicker, shimmer and popping only on the motion path of the rule above.
107
+ - **Reference configuration:** DK's report of a cabinet whose side fought its skin came from a player's photograph at exactly such a join. OS's still sweeps, with temporal anti-aliasing and the sun off, called maps "clean" or showed "faint specks" for eight days while the owner saw "a lot, IN MOTION"; anti-aliasing on raised the count 7.5 times. This rule was "Freeze the frame and look closely" and was offered as a flicker check; it no longer is.
108
+ - **Applies when:** Every 3D level.
109
+ - **Verify:** The same stills each round with the same camera transforms, reviewed by somebody who did not build the level, beside the motion path's numbers.
110
+
111
+ ### Collision is audited against the picture in both directions
112
+ - **Invariant:** Every drawn solid blocks a body or says why it does not, and no collider blocks where nothing is drawn unless the player can see why they are stopped.
113
+ - **Technique:** Compare the visible solids with the collision layer both ways. Drawn side: give each uncovered solid a collider or a `nocollide` reason, and report colliders that cover clearly less than their mesh. Undrawn side: report any collider with nothing drawn in it, or with only walk-through things (foliage, decals) drawn in it, unless it carries a `nodraw` reason the player can see. The `colliders` and `invisible` checks do both at box level. In the engine, sweep rays from every reachable cell comparing the first drawn face with the first solid, walk a probe body at every placed thing from four sides, report by category (invisible wall, invisible bullet stop, walk-through, low ceiling, open edge, a lid over a reachable roof), test size rules in each collider's own frame rather than its world box, and let each count only go down.
114
+ - **Reference configuration:** OS's most repeated map defect was the undrawn side: "theres random invisible like walls that u cant walk through on map btw?" and "still has a ton of invisible walls u cant walk or run or shoot through" (owner), about 40 collision notes in five days, from colliders of removed gates, clipped bushes and a substring match ("'pine' inside 'alpine' and 'tree' inside 'street'"); on one map player walls went from 1,195 to 2 and bullet-stopping cells from 526 to 38, each kept with a reason, yet at the end another map still had 178 shot-through cells, and a rotated railing had been read as a roof lid because a size rule used its world box. LC's ray grid, 271,936 rays from 4,249 standpoints, found 1,569 solids with nothing drawn on 30 colliders, then 0. AW's body-physics gate found bodies inside drawn opaque volume with no collider on every map; OC's palisade, fences, railings and roofs had none, and its building boxes covered 84% of the footprint. The walk bot only sees the routes you give it, so these checks are the ones that cover the whole level.
115
+ - **Applies when:** Every game with a walking body or projectiles.
116
+ - **Verify:** The colliders and invisible checks report zero with their plants caught, the walk bot reports no walk-throughs, and the engine's sweep counts are at or below the last good build.
117
+
118
+ ### Every staircase climbed forward-only
119
+ - **Invariant:** The walk bot reaches past the top of every flight, ramp and ladder holding forward, with no jump, and a route passes only when the body ends beyond the obstacle.
120
+ - **Technique:** Add a route for every staircase, ramp and narrow opening in the level, and one from each ladder's top onto the floor past it, with every goal beyond the landing, not on it. The bot is a capsule that steps up at most one step height and slides along whatever blocks it.
121
+ - **Reference configuration:** AW's body radius 0.35 m, height 1.8 m and step 0.42 m are the bot's defaults; pass the game's own numbers as `tolerances`. OC's owner raised stairs that needed a jump 3 times; OC settled on a 0.4 m step for the player and the zombies alike. OS's old walk passed a railing bug by stopping 0.42 m short, and a ladder with less than 1.2 m clear past its top could be climbed and not left. Run the routes again with the AI body's numbers when they differ from the player's (`opengame-world-physics`).
122
+ - **Applies when:** Any game with stairs, ramps, ladders or narrow openings.
123
+ - **Verify:** The stairs check examined as many routes as the level has flights and climbs, and reports zero.
124
+
125
+ ### Each actor is drawn once
126
+ - **Invariant:** Each screen shows the expected number of each actor: one boss, one player character, no frozen leftover copy.
127
+ - **Technique:** At the title, in play and on the results screen, count live root objects per actor type in the scene and compare with a table of expected counts. After any rebuild or clone, apply per-instance overrides again.
128
+ - **Reference configuration:** OC shipped "two titans one moving one frozen". A hidden-head flag that was not reset on a material rebuild gave one character a double head.
129
+ - **Applies when:** Every game with characters, bosses or scripted scenes.
130
+ - **Verify:** The count check passes on every screen, including after a character switch and a restart.
131
+
132
+ ## Tuning
133
+
134
+ Every tolerance is in `TOLERANCES` and can be overridden per run. Change them for a
135
+ different scale (a miniature world, a giant), or set `gridStep` to the grid the game
136
+ ships on, never to make a finding go away.