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/tilemaps.md

View on GitHub
# Tilemaps Reference — Phaser Gamedev

Tiled JSON integration, layer system, collision, animated tiles, and object layers for Phaser 3.60+.

---

## Loading a Tiled Map

**Tiled** exports maps as JSON. Load the JSON and the tileset image separately in Boot's `preload()`:

```typescript
// In BootScene.preload():
this.load.tilemapTiledJSON('map', 'assets/map.json');
this.load.image('tiles', 'assets/tileset.png');

// If your tileset has multiple images:
this.load.image('tiles-outdoor', 'assets/outdoor.png');
this.load.image('tiles-indoor', 'assets/indoor.png');
```

**Critical**: The first argument to `load.image()` must match the **tileset name** inside the Tiled JSON's `tilesets[].name` field exactly. A mismatch produces a blank map with no error.

---

## Creating the Map and Layers

```typescript
// In GameScene.create():

// Create the tilemap from the loaded JSON
const map = this.make.tilemap({ key: 'map' });

// Add tileset — name must match Tiled's internal tileset name
const tileset = map.addTilesetImage('outdoor', 'tiles')!;
// Second arg 'tiles' matches the load.image() key

// Create layers — names must match layer names in Tiled
const bgLayer = map.createLayer('Background', tileset, 0, 0)!;
const groundLayer = map.createLayer('Ground', tileset, 0, 0)!;
const decorLayer = map.createLayer('Decoration', tileset, 0, 0)!;
const fgLayer = map.createLayer('Foreground', tileset, 0, 0)!;

// Foreground layer renders on top of player — set depth
fgLayer.setDepth(10);

// Set world bounds to map size
this.physics.world.setBounds(0, 0, map.widthInPixels, map.heightInPixels);
this.cameras.main.setBounds(0, 0, map.widthInPixels, map.heightInPixels);
```

**Standard 4-layer structure** (from simple to complex):

| Layer Name | Purpose | Depth |
|------------|---------|-------|
| Background | Sky, distant scenery — no collision | 0 |
| Ground | Walkable platforms and walls — has collision | 1 |
| Decoration | Props on top of ground, no collision | 2 |
| Foreground | Elements in front of player (trees, rooftops) | 10+ |

---

## Collision from Tilemap

**Method 1 — by custom property** (recommended, most flexible):

In Tiled, select tiles that should collide, open Properties, add boolean property `collides = true`.

```typescript
// Collide all tiles that have the custom "collides" property set to true
groundLayer.setCollisionByProperty({ collides: true });

// Wire player to collide with the ground layer
this.physics.add.collider(player, groundLayer);
```

**Method 2 — by tile index**:

```typescript
// Collide specific tile indices (0-based from tileset)
groundLayer.setCollision([1, 2, 3, 15, 16]);
```

**Method 3 — by exclusion** (all tiles collide except listed):

```typescript
groundLayer.setCollisionByExclusion([-1]); // -1 = empty tile
```

**Tileset margin and spacing**: If your tileset has margin/spacing configured in Tiled, verify the values match exactly when calling `addTilesetImage()`:

```typescript
// With margin=2, spacing=2 in Tiled:
const tileset = map.addTilesetImage('outdoor', 'tiles', 32, 32, 2, 2)!;
// Args: name, key, tileWidth, tileHeight, margin, spacing
```

---

## Animated Tiles

Tile animations are configured in Tiled's tileset editor (select a tile → Animation panel → add frames). Phaser 3.60+ plays them automatically when you add the `AnimatedTiles` plugin, or you can handle them manually.

**Without plugin** — manual animated tile via `setTileIndexCallback`:

```typescript
// Cycle frames every 200ms using Phaser's time events
let waterFrame = 0;
const waterFrames = [40, 41, 42, 43]; // tile indices for water animation

this.time.addEvent({
  delay: 200,
  loop: true,
  callback: () => {
    waterFrame = (waterFrame + 1) % waterFrames.length;
    // Replace all tiles of index 40 with current frame
    groundLayer.replaceByIndex(waterFrames[(waterFrame - 1 + 4) % 4], waterFrames[waterFrame]);
  },
});
```

**With plugin** — automatic (recommended for maps with many animated tiles):

```typescript
// In BootScene.preload():
this.load.scenePlugin('AnimatedTiles',
  'https://cdn.jsdelivr.net/npm/phaser-animated-tiles/dist/AnimatedTiles.min.js',
  'animatedTiles', 'animatedTiles'
);

// In GameScene.create():
(this.sys as any).animatedTiles.init(map);
// Plugin reads animation data from Tiled JSON automatically
```

---

## Object Layers — Spawn Points and Trigger Zones

Tiled's **Object Layer** lets you place non-tile objects: spawn points, doors, item locations, trigger boxes.

**In Tiled**: Layer → Add Object Layer → insert rectangles/points with custom properties.

```typescript
// Retrieve all objects from an object layer
const spawnObjects = map.getObjectLayer('Spawns')!.objects;

// Find the player spawn point (a point object named "PlayerSpawn")
const playerSpawn = spawnObjects.find(o => o.name === 'PlayerSpawn')!;
const player = this.physics.add.sprite(playerSpawn.x!, playerSpawn.y!, 'player');

// Spawn enemies from objects with type "Enemy"
const enemySpawns = spawnObjects.filter(o => o.type === 'Enemy');
enemySpawns.forEach(spawn => {
  const enemy = this.enemies.create(spawn.x!, spawn.y!, 'enemy');
  // Read custom properties
  const patrolDist = spawn.properties?.find((p: any) => p.name === 'patrolDist')?.value ?? 100;
  enemy.setData('patrolDist', patrolDist);
});

// Trigger zones — rectangles that fire events when player overlaps
const triggerLayer = map.getObjectLayer('Triggers')!.objects;
triggerLayer.forEach(obj => {
  const zone = this.add.zone(obj.x!, obj.y!, obj.width!, obj.height!);
  this.physics.add.existing(zone, true); // static body
  this.physics.add.overlap(player, zone, () => {
    const action = obj.properties?.find((p: any) => p.name === 'action')?.value;
    if (action === 'nextLevel') this.scene.start('Game', { level: this.level + 1 });
  });
});
```

---

## Multi-Tileset Maps

A single map can use multiple tilesets:

```typescript
// Load multiple tileset images in preload():
this.load.image('tiles-ground', 'assets/ground.png');
this.load.image('tiles-props', 'assets/props.png');

// In create():
const tilesetGround = map.addTilesetImage('ground', 'tiles-ground')!;
const tilesetProps = map.addTilesetImage('props', 'tiles-props')!;

// Pass array when creating layers that use multiple tilesets
const groundLayer = map.createLayer('Ground', [tilesetGround, tilesetProps], 0, 0)!;
```

---

## Common Pitfalls

| Pitfall | Symptom | Fix |
|---------|---------|-----|
| Tileset name mismatch | Blank map, no error | `addTilesetImage` first arg must match Tiled's `tilesets[].name` exactly |
| Missing `setCollisionByProperty` | Player falls through ground | Call it before `physics.add.collider` |
| Property name typo | Collision silently skipped | Open Tiled, verify property is named `collides` (lowercase) |
| Wrong margin/spacing | Tiles render as grey boxes | Check Tiled tileset settings, pass matching values to `addTilesetImage` |
| Layer name mismatch | `createLayer` returns null | Check exact layer name in Tiled, including capitalization |
| Not setting world/camera bounds | Camera shows black void | Set bounds to `map.widthInPixels` × `map.heightInPixels` |
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