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

View on GitHub
# Meshy AI 3D Pipeline

Meshy AI generates 3D models from text or images, rigs humanoids, and animates them. API endpoint: `https://api.meshy.ai`. Auth: `Authorization: Bearer $MESHY_API_KEY`.

All requests require `MESHY_API_KEY` from `~/.env`. Assets are retained for **3 days only** — download GLB files immediately after generation completes.

---

## Text-to-3D (Two-Step Pipeline)

Generation is always two steps: **preview** (fast, low-poly, confirms the prompt works) then **refine** (full quality). Never skip the preview step — it validates the prompt before spending refine credits.

### Step 1: Submit Preview

```bash
curl -X POST https://api.meshy.ai/openapi/v2/3d-model-preview \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "object_prompt": "a fantasy warrior with a sword and shield",
    "style_prompt": "game-ready, low-poly, PBR textures",
    "art_style": "realistic",
    "should_remesh": true
  }'
# Returns: {"result": "task-uuid-here"}
```

**art_style options**: `realistic`, `cartoon`, `low-poly`, `sculpture`, `pbr`

### Step 2: Poll Preview Status

```bash
curl -H "Authorization: Bearer $MESHY_API_KEY" \
  https://api.meshy.ai/openapi/v2/3d-model-preview/TASK_ID
# Returns status: PENDING | IN_PROGRESS | SUCCEEDED | FAILED
# On SUCCEEDED: response includes model_urls.glb
```

Poll every 5 seconds. Preview typically completes in 30-90 seconds.

### Step 3: Submit Refine (using preview task ID)

```bash
curl -X POST https://api.meshy.ai/openapi/v2/3d-model \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "preview_task_id": "PREVIEW_TASK_ID",
    "enable_pbr": true,
    "texture_richness": "high"
  }'
# Returns: {"result": "refine-task-uuid"}
```

### Step 4: Poll Refine and Download

```bash
curl -H "Authorization: Bearer $MESHY_API_KEY" \
  https://api.meshy.ai/openapi/v2/3d-model/REFINE_TASK_ID
# On SUCCEEDED: response.model_urls.glb = download URL
```

Refine takes 2-5 minutes. Download the GLB immediately on SUCCEEDED.

### Full Script (non-blocking)

Use `scripts/meshy-generate.mjs` for polling logic. Quick inline version:

```bash
# Submit and save task ID
TASK=$(curl -s -X POST https://api.meshy.ai/openapi/v2/3d-model-preview \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"object_prompt":"warrior","art_style":"realistic","should_remesh":true}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['result'])")
echo "Task ID: $TASK"

# Poll until done (check manually or use the script)
node scripts/meshy-generate.mjs status $TASK
```

---

## Image-to-3D

Takes an image (URL, local file path, or base64) and generates a 3D model from it. Faster than text-to-3D when you have reference art.

```bash
# From URL
curl -X POST https://api.meshy.ai/openapi/v2/image-to-3d \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/character.png",
    "enable_pbr": true,
    "should_remesh": true
  }'

# From local file (base64 encode)
B64=$(base64 -w 0 /path/to/image.png)
curl -X POST https://api.meshy.ai/openapi/v2/image-to-3d \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"image_url\": \"data:image/png;base64,$B64\", \"enable_pbr\": true}"
```

Poll at `https://api.meshy.ai/openapi/v2/image-to-3d/TASK_ID` same as text-to-3D.

**Image requirements**: Clear subject on solid or transparent background, square or near-square aspect ratio preferred, PNG with transparency works best.

---

## Rigging (Humanoids Only)

Auto-rigging creates a skeleton for animation. **Only works if all conditions are met**:
- Bipedal (two legs, two arms, one head)
- Textured (not solid color)
- Clearly defined limbs (no capes/skirts covering legs, no merged geometry)
- Standing upright in a T-pose or A-pose

```bash
curl -X POST https://api.meshy.ai/openapi/v1/3d-model/TASK_ID/rig \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skeleton_type": "humanoid"}'
# Returns: {"result": "rig-task-uuid"}
```

Poll at `https://api.meshy.ai/openapi/v1/3d-model-rig/RIG_TASK_ID`. Download the rigged GLB on SUCCEEDED.

**Do not attempt rigging if**: the model is a vehicle, creature (non-bipedal), environment piece, or weapon/prop. The API will reject it or produce a broken skeleton.

---

## Animation

Animate a rigged model with preset motions. Requires a successfully rigged GLB task ID.

```bash
curl -X POST https://api.meshy.ai/openapi/v1/3d-model/RIG_TASK_ID/animate \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "animation_preset": "walk"
  }'
# animation_preset options: "walk" | "run" | "idle" | "jump" | "dance"
```

Poll at `https://api.meshy.ai/openapi/v1/3d-model-animation/ANIM_TASK_ID`. The resulting GLB includes embedded animation clips.

---

## Status Polling

```bash
# Check any task by type and ID
node scripts/meshy-generate.mjs status <task_id>

# Or raw curl for any endpoint
curl -H "Authorization: Bearer $MESHY_API_KEY" \
  "https://api.meshy.ai/openapi/v2/3d-model/TASK_ID"
```

Status values: `PENDING` (queued), `IN_PROGRESS` (generating), `SUCCEEDED` (done), `FAILED` (error — check `task_error.message`).

---

## Post-Processing: GLB Optimization

Run after every Meshy download. Reduces file size 80-95% via texture compression and mesh quantization.

```bash
node scripts/optimize-glb.mjs input.glb output-optimized.glb
```

The script runs `gltf-transform` with:
- Texture resize to 1024x1024 max
- WebP conversion (vs PNG/JPEG)
- Meshopt compression (quantization + filter)
- Dedup + prune for clean output

Requires `@gltf-transform/cli`: `npm install -g @gltf-transform/cli`

---

## .meta.json Sidecar

Save alongside every downloaded GLB:

```json
{
  "prompt": "a fantasy warrior with a sword and shield",
  "style": "realistic",
  "preview_task_id": "abc123",
  "refine_task_id": "def456",
  "rig_task_id": "ghi789",
  "anim_task_id": "jkl012",
  "animation_preset": "walk",
  "generated_at": "2026-04-04T12:00:00Z",
  "source": "meshyai",
  "original_url": "https://assets.meshy.ai/...",
  "expires_at": "2026-04-07T12:00:00Z"
}
```

`expires_at` is 3 days from generation. If the GLB is lost, resubmit using `prompt` and `style`.

---

## Fallback Chain

When Meshy fails or `MESHY_API_KEY` is missing:

1. Meshy API (text-to-3D or image-to-3D)
2. Sketchfab search (see `references/asset-sources.md`)
3. Poly.pizza search (see `references/asset-sources.md`)
4. `new THREE.BoxGeometry(1,1,1)` placeholder (always works, no download needed)

All fallbacks write to the same output path. The game's asset loader does not care which fallback was used.

---

## Error Reference

| Error | Cause | Fix |
|-------|-------|-----|
| 401 Unauthorized | Invalid or missing `MESHY_API_KEY` | Check `~/.env`, regenerate at app.meshy.ai |
| 402 Payment Required | Credit quota exhausted | Buy credits or use fallback chain |
| task_error: "Invalid prompt" | Prompt violates content policy | Rephrase without weapons/violence details |
| task_error: "Rigging failed" | Model doesn't meet humanoid criteria | Skip rigging, use un-rigged GLB |
| 0-byte GLB download | URL expired (>3 days) | Regenerate using `.meta.json` prompt |
| PENDING indefinitely (>10 min) | Service overload | Retry or use fallback chain |
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