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/road-to-aew-integration.md

View on GitHub
# road-to-aew Integration

Project-aware deploy and manifest regen for the road-to-aew Slay-the-Spire-style deckbuilder. Loaded only when `--target road-to-aew` is set.

## Project state (as of 2026-04)

- 87 enemy wrestler sprites at `public/assets/characters/enemies/<snake_case>.png`.
- 8 player sprites at `public/assets/characters/player/{male,female}/<snake_case>.png`.
- All single full-body portrait PNGs, RGBA transparent bg.
- Resolution range: ~470-815px wide × 935-994px tall (matches the portrait-mode dimension gate).
- Manifest at `src/game/sprites/enemySpriteManifest.ts`, regenerated via `npm run generate:sprites`.
- Style target: Slay-the-Spire-inspired hand-painted (see `slay-the-spire-painted` preset in `style-presets.md`).

## Naming convention

`snake_case` derived from the character display name:

```
"Bangkok Belle Nisa" → bangkok_belle_nisa
"General Gideon"     → general_gideon
"The Giant Pyotr"    → giant_pyotr  (definite article dropped)
"D'Marcus James"     → dmarcus_james (apostrophe stripped)
```

`road_to_aew_integration.py snake-case <display-name>` runs the conversion. The rules:

1. Drop leading articles: `The`, `A`, `An`.
2. Lowercase everything.
3. Replace whitespace with `_`.
4. Strip non-alphanumeric except `_` (apostrophes, periods, commas removed).
5. Collapse runs of `_` into single `_`.
6. Strip leading/trailing `_`.

## Deploy paths

| Character class | Path |
|------------------|------|
| Enemy | `~/road-to-aew/public/assets/characters/enemies/<snake_case>.png` |
| Player male | `~/road-to-aew/public/assets/characters/player/male/<snake_case>.png` |
| Player female | `~/road-to-aew/public/assets/characters/player/female/<snake_case>.png` |

Selection logic:

| Flag | Path resolved |
|------|---------------|
| `--target road-to-aew` (default) | enemies dir |
| `--target road-to-aew --player male` | player/male dir |
| `--target road-to-aew --player female` | player/female dir |
| `--target road-to-aew --target-dir <path>` | use `<path>` instead of `~/road-to-aew` |

## Manifest regeneration

After deploying a new sprite, the manifest at `src/game/sprites/enemySpriteManifest.ts` must be refreshed. Two modes:

### Auto-regen (`--regen-manifest`)

```bash
python3 portrait_pipeline.py \
    --prompt "..." --target road-to-aew --regen-manifest
```

The skill runs:

```bash
cd ~/road-to-aew && npm run generate:sprites
```

Stdout/stderr is forwarded. Exit code propagates — non-zero from manifest regen surfaces as `IntegrationError`.

### Manual regen (default)

Without `--regen-manifest`, the skill prints a reminder:

```
[deploy] Sprite written: ~/road-to-aew/public/assets/characters/enemies/bangkok_belle_nisa.png
[deploy] Run `cd ~/road-to-aew && npm run generate:sprites` to refresh the manifest.
```

The user runs the command when they want to ship the manifest update.

Why default to manual: regen takes 5-15 seconds and triggers TypeScript compilation, which produces noise. Batch generation of 10 wrestlers should regen once at the end, not 10 times. The user picks the moment.

## Tier and archetype mapping

road-to-aew has procedural archetype + tier enums in `src/game/types/wrestler.ts`. The skill's `--archetype` and `--tier` flags map directly:

| Skill flag | road-to-aew enum value |
|------------|-------------------------|
| `--archetype powerhouse` | `WrestlerArchetype.POWERHOUSE` |
| `--archetype technical` | `WrestlerArchetype.TECHNICAL` |
| `--archetype high-flyer` | `WrestlerArchetype.HIGH_FLYER` (snake_case in the enum) |
| `--archetype brawler` | `WrestlerArchetype.BRAWLER` |
| `--archetype striker` | `WrestlerArchetype.STRIKER` |
| `--archetype submission` | `WrestlerArchetype.SUBMISSION` |
| `--archetype showman` | `WrestlerArchetype.SHOWMAN` |
| `--archetype giant` | `WrestlerArchetype.GIANT` |
| `--archetype player` | `WrestlerArchetype.PLAYER` |
| `--tier act1` | `Tier.INDIES` |
| `--tier act2` | `Tier.ROH` |
| `--tier act3` | `Tier.AEW` |

The metadata sidecar JSON includes both flag-form and enum-form values so manifest-side code can look up either.

## Wrestling style enum

road-to-aew also has `WrestlingStyle` (striker, grappler, high_flyer, brawler). This is independent of archetype and is used for combat-system mechanics. The skill does not generate this — it is hand-set in the manifest by the user. Listed here for awareness.

## Image transform on render

Enemy sprites are rendered facing the player via:

```jsx
<img src={`/assets/characters/enemies/${sprite}.png`}
     style={{ transform: 'scaleX(-1)' }} />
```

This means the generated sprite should face screen-right (player faces enemy from the left). The `slay-the-spire-painted` preset's "3/4 isometric perspective from slightly above" is direction-neutral; the transform handles facing.

`giant` archetype additionally applies `scale(1.2)` for towering presence — the skill does not need to apply this; the React renderer handles it.

## Existing sprite library inspection

To avoid duplicate IDs, run before adding a new wrestler:

```bash
python3 road_to_aew_integration.py list-existing | grep -i "bangkok"
```

This lists all existing sprite IDs and matches against the candidate name. Empty output means the ID is free.

## Rive infrastructure

road-to-aew has Rive `.riv` skeletal-animation infrastructure scaffolded at `src/game/rive/`. It is not currently deployed — every wrestler is a static portrait. Future Rive activation is out of scope for this skill (per ADR-197 deferred-questions section).

If/when Rive is activated, this reference will be updated to include a `--rive-export` flag that decomposes the portrait into Rive-ready bone groups.

## Example end-to-end run

```bash
# Generate Bangkok Belle Nisa (Act 2 ROH heel showman)
python3 portrait_pipeline.py \
    --display-name "Bangkok Belle Nisa" \
    --description "kabuki-inspired makeup, Thai national colors woven into the showman gear, mid-30s confident expression" \
    --style slay-the-spire-painted \
    --archetype showman \
    --gimmick heel \
    --tier act2 \
    --target road-to-aew \
    --regen-manifest \
    --seed 42

# Output:
# [phase A] Codex CLI generation: 28.4s
# [phase B] Magenta chroma key: 1.2s
# [phase C] Trim and center: 0.08s
# [phase D] Dimension validation: PASS (612x980, aspect 1:1.6)
# [phase E] Deployed: ~/road-to-aew/public/assets/characters/enemies/bangkok_belle_nisa.png
# [phase E] Manifest regenerated: src/game/sprites/enemySpriteManifest.ts updated (88 entries)
```

<!-- no-pair-required: section header; pair lives in subsection -->
## Signals and Fixes

### Signal: Hard-coding the road-to-aew path

**What it looks like:** `output_path = Path("/home/feedgen/road-to-aew/...")` hard-coded into the skill scripts.

**Why wrong:** Other users / environments have road-to-aew checked out elsewhere. The skill becomes unportable.

**Do instead**: Resolve `--target-dir` at runtime; default to `~/road-to-aew` (`Path.home() / "road-to-aew"`); allow override via flag. The deploy step refuses to guess if the resolved path does not exist — explicit error with the resolved value, not silent fallback.

### Signal: Regenerating every sprite during a batch

**What it looks like:** Loop over 50 wrestlers; each iteration runs `npm run generate:sprites`.

**Why wrong:** TypeScript compilation runs 50 times, taking 5-15s each = 5-12 minutes of pure manifest-rebuild overhead. The manifest content is the same as the final state regardless of how many times it ran mid-batch.

**Do instead**: Run the batch with `--regen-manifest=false` (skill default); regen once at the end with a single `cd ~/road-to-aew && npm run generate:sprites`. The skill prints the reminder so the user does not forget. For automation, wrap the batch + final regen in a single shell script.

## Reference loading hint

Load when:
- `--target road-to-aew` is in the active command
- The user asks about deploying to road-to-aew
- A `IntegrationError` is being debugged
- ID-collision check is needed before generating
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