Skip to content

notque/vexjoy-agent / skills/game/game-dev

game-dev

Flagged

Game development: design, asset pipelines, Phaser, Unity CLI and builds, vanilla JS frontend, GM mode, match booking.

FileKindSize
SKILL.mdskill md14.7 KB
references/anchor-alignment.mdmarkdown16.0 KB
references/animate-scaffolds.mdmarkdown2.0 KB
references/arcade-physics.mdmarkdown7.4 KB
references/artifacts-and-prototyping.mdmarkdown1.5 KB
references/asset-sources.mdmarkdown7.9 KB
references/audit-and-red-team.mdmarkdown795 B
references/autonomous-improvement.mdmarkdown10.3 KB
references/backend-chain.mdmarkdown10.4 KB
references/bg-removal-local.mdmarkdown22.7 KB
references/build-scaffolds.mdmarkdown2.0 KB
references/capabilities/01-design-red-team-audit.mdmarkdown3.9 KB
references/capabilities/02-emotional-canvas-moodboard.mdmarkdown3.7 KB
references/capabilities/03-game-design-attribution-audit.mdmarkdown3.6 KB
references/capabilities/04-game-design-bartle-archetype-audit.mdmarkdown3.7 KB
references/capabilities/05-game-design-big-five-personality-audit.mdmarkdown3.6 KB
references/capabilities/06-game-design-brainstorm-methods.mdmarkdown3.9 KB
references/capabilities/07-game-design-core-loop-extractor.mdmarkdown3.7 KB
references/capabilities/08-game-design-craft-critique.mdmarkdown3.5 KB
references/capabilities/09-game-design-creative-unblocker.mdmarkdown3.5 KB
references/capabilities/10-game-design-design-pillars-extractor.mdmarkdown3.5 KB
references/capabilities/11-game-design-emotional-canvas.mdmarkdown3.6 KB
references/capabilities/12-game-design-failure-loop-audit.mdmarkdown3.8 KB
references/capabilities/13-game-design-fairness-frustration-audit.mdmarkdown3.6 KB
references/capabilities/14-game-design-fantasy-extractor.mdmarkdown3.6 KB
references/capabilities/15-game-design-feature-prioritization.mdmarkdown3.6 KB
references/capabilities/16-game-design-five-options.mdmarkdown3.5 KB
references/capabilities/17-game-design-flow-audit.mdmarkdown3.6 KB
references/capabilities/18-game-design-fogg-behavior-audit.mdmarkdown3.6 KB
references/capabilities/19-game-design-friction-journey-audit.mdmarkdown3.8 KB
references/capabilities/20-game-design-ftue-hero-journey-audit.mdmarkdown3.7 KB
references/capabilities/21-game-design-goal-density-and-immediacy-audit.mdmarkdown3.5 KB
references/capabilities/22-game-design-goal-framing.mdmarkdown3.5 KB
references/capabilities/23-game-design-granular-player-motivation-audit.mdmarkdown4.0 KB
references/capabilities/24-game-design-grow-design.mdmarkdown3.5 KB
references/capabilities/25-game-design-ideal-outcome-backcasting.mdmarkdown3.4 KB
references/capabilities/26-game-design-kpi-coverage-audit.mdmarkdown3.8 KB
references/capabilities/27-game-design-leaderboard-audit.mdmarkdown3.9 KB
references/capabilities/28-game-design-leaderboard-builder.mdmarkdown3.8 KB
references/capabilities/29-game-design-molyneux-lens.mdmarkdown3.5 KB
references/capabilities/30-game-design-multiplayer-feature-audit.mdmarkdown3.8 KB
references/capabilities/31-game-design-novelty-spectrum-audit.mdmarkdown3.6 KB
references/capabilities/32-game-design-one-page-design-doc.mdmarkdown3.8 KB
references/capabilities/33-game-design-one-thing-to-remove.mdmarkdown3.6 KB
references/capabilities/34-game-design-option-generation.mdmarkdown3.5 KB
references/capabilities/35-game-design-peak-end-audit.mdmarkdown3.6 KB
references/capabilities/36-game-design-perceived-randomness-audit.mdmarkdown3.7 KB
references/capabilities/37-game-design-pitch-deck-audit.mdmarkdown3.8 KB
references/capabilities/38-game-design-player-motivation-audit.mdmarkdown3.5 KB
references/capabilities/39-game-design-player-need-satisfaction-audit.mdmarkdown3.6 KB
references/capabilities/40-game-design-player-persona-extractor.mdmarkdown4.2 KB
references/capabilities/41-game-design-player-perspective-reframe.mdmarkdown3.7 KB
references/capabilities/42-game-design-player-segment-perception-audit.mdmarkdown3.6 KB
references/capabilities/43-game-design-player-values-mapper.mdmarkdown3.8 KB
references/capabilities/44-game-design-premium-pass-audit.mdmarkdown3.8 KB
references/capabilities/45-game-design-prosocial-session-chapters.mdmarkdown3.7 KB
references/capabilities/46-game-design-prototype-intent-audit.mdmarkdown3.7 KB
references/capabilities/47-game-design-prototyping-companion.mdmarkdown3.6 KB
references/capabilities/48-game-design-roadblock-reframing.mdmarkdown3.5 KB
references/capabilities/49-game-design-smart-goal-audit.mdmarkdown3.6 KB
references/capabilities/50-game-design-social-satisfaction-matrix.mdmarkdown3.7 KB
references/capabilities/51-game-design-systematizing-empathizing-audit.mdmarkdown3.6 KB
references/capabilities/52-game-design-thinking-fast-and-slow-audit.mdmarkdown3.6 KB
references/capabilities/53-game-design-transformative-reuse.mdmarkdown3.6 KB
references/capabilities/54-game-design-unknown-unknowns-prototyping.mdmarkdown3.6 KB
references/capabilities/55-game-design-zeigarnik-effect-audit.mdmarkdown3.6 KB
references/capabilities/56-game-dev-budget-estimator.mdmarkdown3.8 KB
references/capabilities/57-game-dev-first-steps.mdmarkdown3.6 KB
references/capabilities/58-game-dev-team-gap.mdmarkdown3.6 KB
references/capabilities/59-game-dev-time-estimator.mdmarkdown3.8 KB
references/capabilities/60-moodboard-generator.mdmarkdown4.0 KB
references/capabilities/61-software-team-conflict-patterns.mdmarkdown3.8 KB
references/capability-catalog.mdmarkdown18.4 KB
references/capability-map.mdmarkdown1.7 KB
references/capability-matrix.mdmarkdown12.5 KB
references/capacitor-ios.mdmarkdown7.3 KB
references/cognition-and-choice.mdmarkdown1.2 KB
references/cognitive-and-behavioral-lenses.mdmarkdown1.2 KB
references/combat-effects-upgrade.mdmarkdown13.3 KB
references/combat-effects-upgrade/css-3d-card-transforms.mdmarkdown10.1 KB
references/combat-effects-upgrade/css-particle-migration.mdmarkdown13.3 KB
references/combat-effects-upgrade/framer-motion-combat-juice.mdmarkdown11.9 KB
references/concept-and-loop.mdmarkdown1.5 KB
references/core-loop-and-pillars.mdmarkdown835 B
references/core-patterns.mdmarkdown8.2 KB
references/cpu-systems-harmony.mdmarkdown3.4 KB
references/creative-and-options.mdmarkdown2.0 KB
references/creative-direction.mdmarkdown1.3 KB
references/deploy.mdmarkdown5.3 KB
references/design-artifacts.mdmarkdown1.0 KB
references/emotion-and-presentation.mdmarkdown1.1 KB
references/error-catalog.mdmarkdown22.6 KB
references/fairness-and-failure.mdmarkdown1.2 KB
references/fairness-and-learning.mdmarkdown1.3 KB
references/fal-ai-image.mdmarkdown7.1 KB
references/frame-detection.mdmarkdown20.0 KB
references/full-diagnostic.mdmarkdown4.2 KB
references/game-asset-generator.mdmarkdown9.5 KB
references/game-audio.mdmarkdown7.5 KB
references/game-feel-patterns.mdmarkdown12.2 KB
references/game-pipeline.mdmarkdown11.5 KB
references/game-qa.mdmarkdown6.7 KB
references/game-sprite-pipeline.mdmarkdown33.4 KB
references/gm-brilliant-implementation.mdmarkdown13.4 KB
references/grid-shapes.mdmarkdown8.0 KB
references/meshyai.mdmarkdown7.3 KB
references/motion-pipeline.mdmarkdown7.6 KB
references/output-formats.mdmarkdown9.4 KB
references/pacing-and-return.mdmarkdown1.6 KB
references/performance.mdmarkdown7.8 KB
references/phaser-gamedev.mdmarkdown7.5 KB
references/pipeline-spec.jsonconfig23.5 KB
references/pixel-art-sprites.mdmarkdown8.7 KB
references/pixijs-combat-renderer.mdmarkdown12.1 KB
references/pixijs-combat-renderer/combat-visual-effects.mdmarkdown7.8 KB
references/pixijs-combat-renderer/pixi-2d-lighting.mdmarkdown6.6 KB
references/pixijs-combat-renderer/pixi-particle-systems.mdmarkdown9.2 KB
references/pixijs-combat-renderer/pixi-performance.mdmarkdown4.8 KB
references/pixijs-combat-renderer/pixi-post-processing.mdmarkdown6.3 KB
references/pixijs-combat-renderer/pixi-react-integration.mdmarkdown5.2 KB
references/planning-and-communication.mdmarkdown1.6 KB
references/planning-and-production.mdmarkdown1.8 KB
references/player-and-social.mdmarkdown2.3 KB
references/polish-scaffolds.mdmarkdown1.9 KB
references/progression-and-economy.mdmarkdown1.0 KB
references/promo-video.mdmarkdown6.6 KB
references/prompt-rules.mdmarkdown15.2 KB
references/quality-gates.mdmarkdown6.4 KB
references/rive-skeletal-animator.mdmarkdown7.6 KB
references/rive-skeletal-animator/rive-animation-library.mdmarkdown8.1 KB
references/rive-skeletal-animator/rive-async-patterns.mdmarkdown5.6 KB
references/rive-skeletal-animator/rive-character-pipeline.mdmarkdown5.6 KB
references/rive-skeletal-animator/rive-performance.mdmarkdown5.4 KB
references/rive-skeletal-animator/rive-react-setup.mdmarkdown9.9 KB
references/rive-skeletal-animator/rive-vs-spine-decision.mdmarkdown6.0 KB
references/road-to-aew-integration.mdmarkdown7.8 KB
references/social-and-competitive-design.mdmarkdown1.1 KB
references/social-and-competitive.mdmarkdown1.5 KB
references/spritesheets.mdmarkdown6.2 KB
references/stage-contracts.mdmarkdown11.1 KB
references/style-presets.mdmarkdown5.1 KB
references/subagent-delegation.mdmarkdown2.2 KB
references/tilemaps-and-physics.mdmarkdown13.6 KB
references/tilemaps.mdmarkdown7.0 KB
references/unity-batchmode-builds.mdmarkdown9.2 KB
references/unity-cli.mdmarkdown10.9 KB
references/unity-licensing.mdmarkdown5.0 KB
references/vfx-containment.mdmarkdown3.1 KB
references/workflow-dag.mdmarkdown4.1 KB
references/worldlabs.mdmarkdown7.9 KB
references/wrestler-archetypes.mdmarkdown7.2 KB
scripts/deterministic_idle.pyscript7.8 KB
scripts/fal_queue_image_run.pyscript9.4 KB
scripts/imgdiff.pyscript5.0 KB
scripts/meshy-generate.mjsscript11.1 KB
scripts/optimize-glb.mjsscript3.8 KB
scripts/portrait_pipeline.pyscript31.2 KB
scripts/qa_artifacts.pyscript14.4 KB
scripts/road_to_aew_integration.pyscript6.6 KB
scripts/row_job_status.pyscript8.6 KB
scripts/sprite_anchor.pyscript30.1 KB
scripts/sprite_assemble.pyscript16.0 KB
scripts/sprite_bg.pyscript28.5 KB
scripts/sprite_canvas.pyscript11.9 KB
scripts/sprite_generate.pyscript13.9 KB
scripts/sprite_pipeline.pyscript54.9 KB
scripts/sprite_process.pyscript13.5 KB
scripts/sprite_prompt.pyscript41.8 KB
scripts/sprite_slicing.pyscript38.7 KB
scripts/sprite_verify.pyscript58.5 KB
scripts/test_content_aware_extraction.pyscript13.4 KB
scripts/test_no_status_laundering.pyscript6.9 KB
scripts/test_phases_4_5_7_8.pyscript16.4 KB
scripts/test_pipeline_glue.pyscript20.9 KB
scripts/test_pipeline_patterns.pyscript10.9 KB
scripts/test_rc3_frames_distinct_threshold.pyscript14.2 KB
scripts/test_rc4_mass_centroid_default.pyscript8.3 KB
scripts/test_rc5_despill_pre_upscale.pyscript7.9 KB
scripts/test_slice_grid_cells.pyscript6.4 KB
scripts/test_slicer_strict_pitch_default.pyscript11.6 KB
scripts/test_verifier_cell_parity.pyscript9.0 KB
scripts/test_verify_gates.pyscript23.2 KB
scripts/tests/test_fal_queue_image_run.pyscript908 B
scripts/video_extract_frames.pyscript4.3 KB
scripts/video_process_frames.pyscript7.6 KB
scripts/video_select_frames.pyscript6.4 KB
scripts/with_server.pyscript5.8 KB

references/capacitor-ios.md

View on GitHub
# Capacitor iOS Reference

Export a browser-based game (Three.js or Phaser) to iOS via Capacitor 5+. Capacitor wraps your `dist/` output in a native WKWebView and handles the bridge to iOS APIs.

---

## Setup

```bash
# Install Capacitor
npm install @capacitor/core @capacitor/ios

# Initialize (run once per project)
# web-dir must match your build output directory
npx cap init "My Game" com.yourname.mygame --web-dir dist

# Add iOS platform
npx cap add ios
```

---

## capacitor.config.ts

```typescript
import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId:   'com.yourname.mygame',
  appName: 'My Game',
  webDir:  'dist',
  server: {
    androidScheme: 'https',  // use https for consistency
  },
  ios: {
    contentInset: 'automatic',
    scrollEnabled: false,  // prevent scroll on game canvas
  },
};

export default config;
```

---

## Build Cycle

Every time you change web code, repeat this cycle:

```bash
# 1. Build web output
npm run build

# 2. Sync web assets to native project
npx cap sync

# 3. Open Xcode (do the actual iOS build from there)
npx cap open ios
```

`npx cap sync` copies `dist/` to `ios/App/App/public/` and updates Capacitor plugin configurations. Run it every time you change web output.

---

## SPM (Swift Package Manager)

Capacitor 5+ uses SPM by default — no CocoaPods needed.

If you see a `Podfile`, you're using an older Capacitor version. Migrate:

```bash
npx cap migrate  # upgrades to latest Capacitor
```

To verify SPM is in use:
```bash
ls ios/App/         # Should NOT contain Podfile (or Podfile.lock)
ls ios/App/Packages # Should contain Package.swift references
```

---

## Asset Contract

The `assets_index.json` manifest must exist and use only relative paths. Both the web game and the native wrapper read from it.

```json
{
  "version": "1.0",
  "assets": {
    "player":      "assets/player.png",
    "enemy":       "assets/enemy.png",
    "tileset":     "assets/tileset.png",
    "bgm":         "assets/music.ogg",
    "hit":         "assets/hit.wav"
  }
}
```

**Critical rule**: All paths must be relative, never absolute. In a WKWebView, `/assets/player.png` resolves to the iOS filesystem root, not the app bundle. Use `assets/player.png` (no leading slash).

Check for violations:
```bash
grep -r '"/' dist/ --include="*.json" --include="*.js" | grep -v "http" | grep -v "https"
```

---

## Touch Controls

Map touch events to game input. The game canvas receives touch events; map them to virtual input.

```javascript
// src/input/TouchControls.js
import { emit } from '../EventBus.js';

export function initTouchControls(canvas) {
  // Virtual joystick (left side of screen)
  let joystickOrigin = null;

  canvas.addEventListener('touchstart', (e) => {
    for (const touch of e.changedTouches) {
      if (touch.clientX < canvas.width / 2) {
        joystickOrigin = { x: touch.clientX, y: touch.clientY, id: touch.identifier };
      } else {
        // Right side = action button
        emit('PLAYER_ACTION', { x: touch.clientX, y: touch.clientY });
      }
    }
    e.preventDefault();
  }, { passive: false });

  canvas.addEventListener('touchmove', (e) => {
    for (const touch of e.changedTouches) {
      if (joystickOrigin && touch.identifier === joystickOrigin.id) {
        const dx = touch.clientX - joystickOrigin.x;
        const dy = touch.clientY - joystickOrigin.y;
        const dist = Math.sqrt(dx * dx + dy * dy);
        const deadzone = 10;
        if (dist > deadzone) {
          emit('PLAYER_MOVE', { dx: dx / 60, dy: dy / 60 }); // normalized -1 to 1
        }
      }
    }
    e.preventDefault();
  }, { passive: false });

  canvas.addEventListener('touchend', (e) => {
    for (const touch of e.changedTouches) {
      if (joystickOrigin && touch.identifier === joystickOrigin.id) {
        joystickOrigin = null;
        emit('PLAYER_MOVE', { dx: 0, dy: 0 });
      }
    }
  });
}
```

**Phaser-specific**: Phaser's Input Manager already handles multi-touch. Enable it:
```javascript
new Phaser.Game({
  input: {
    activePointers: 3,  // support 3 simultaneous touches
  },
});
```

---

## Debugging on iOS

**Safari Web Inspector** (best tool for native WebView debugging):

1. On iOS device: Settings → Safari → Advanced → Web Inspector → On
2. On Mac: Safari → Develop → [Your iPhone] → [App name]
3. Full JS console, DOM inspector, and network tab work in WKWebView

**Common issues visible in Web Inspector**:
- Absolute path 404s
- AudioContext creation failures (autoplay policy on iOS is stricter than desktop)
- Canvas context loss (iOS terminates background WebGL contexts aggressively)

**Console log forwarding** (alternative if Safari Web Inspector not available):
```javascript
// Forward console.log to Capacitor logger
if (window.Capacitor) {
  const orig = console.log;
  console.log = (...args) => {
    orig(...args);
    // Appears in Xcode output
    window.webkit?.messageHandlers?.log?.postMessage(args.join(' '));
  };
}
```

---

## iOS-Specific Gotchas

| Issue | Cause | Fix |
|---|---|---|
| AudioContext muted on load | iOS autoplay policy is stricter | First AudioContext creation must be inside touchstart/touchend handler |
| WebGL context lost on background | iOS kills background GPU contexts | Listen for `webglcontextlost`, restore on `webglcontextrestored` |
| Canvas is blurry on Retina | Missing `devicePixelRatio` scaling | `canvas.width = width * devicePixelRatio; ctx.scale(dpr, dpr)` |
| Touch events fire with 300ms delay | Legacy click delay | Add `<meta name="viewport" content="... touch-action: none">` or use `pointer` events |
| Assets load from wrong path | Absolute paths in WKWebView | All paths relative, verify with pre-deploy checklist |

---

## App Store Submission Checklist

- [ ] Build and run on physical device (not just simulator)
- [ ] App icon provided at all required sizes (use `capacitor-assets` tool)
- [ ] Launch screen configured (no blank white flash)
- [ ] Privacy manifest included (required for iOS 17+ for apps using APIs)
- [ ] Info.plist has required usage descriptions for any hardware APIs used
- [ ] Game tested offline (no localhost fetches in production build)
- [ ] Version and build number set in Xcode project settings

---

## Error Handling

### Error: npx cap sync Fails with "Cannot find module"
**Cause**: Capacitor CLI version mismatch between project and global
**Fix**: Use local CLI: `npx cap sync` (not `cap sync`). Ensure `@capacitor/cli` is in `devDependencies`.

### Error: App Shows White Screen in Simulator
**Cause**: `webDir` in `capacitor.config.ts` does not match actual build output directory, or `npm run build` was not run before `cap sync`
**Fix**: Check `dist/` contains `index.html`. Verify `webDir: 'dist'` in config. Run `npm run build` then `npx cap sync` again.

### Error: Audio Plays on Simulator But Not Device
**Cause**: iOS audio session not configured, or AudioContext created outside gesture
**Fix**: AudioContext creation must be inside `touchstart` or `touchend` handler — iOS is stricter than macOS. Add `@capacitor/haptics` if you also want haptic feedback on hit events.

### Error: CocoaPods Errors After Adding Plugin
**Cause**: Some older Capacitor plugins still use CocoaPods
**Fix**: Install CocoaPods as fallback: `sudo gem install cocoapods && cd ios/App && pod install`. Then open `ios/App/App.xcworkspace` (not `.xcodeproj`).
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall