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/fal-ai-image.md

View on GitHub
# fal.ai Image Generation

fal.ai provides queue-based image generation via 8 model endpoints. Requires `FAL_KEY` in `~/.env`. Auth header format is `Key $FAL_KEY` — not Bearer.

---

## Authentication

```bash
# Correct format
curl -H "Authorization: Key $FAL_KEY" https://queue.fal.run/...

# Wrong — this returns 401
# -H "Authorization: Bearer $FAL_KEY"
```

Get `FAL_KEY` at fal.ai. Add to `~/.env`.

---

## Model Endpoints

| Model | Endpoint | Best for | Speed |
|-------|----------|----------|-------|
| GPT Image 1.5 | `fal-ai/gpt-image-1` | Transparency, complex prompts, instruction-following | Slow (~30s) |
| Nano Banana 2 | `fal-ai/nano-banana-2` | Speed, game sprites, icons | Fast (~5s) |
| Nano Banana Pro | `fal-ai/nano-banana-pro` | Better quality than Nano 2, still fast | Medium (~12s) |
| Grok Imagine (XAI) | `fal-ai/grok-imagine` | Photorealism, characters | Medium (~15s) |
| Flux Schnell | `fal-ai/flux/schnell` | General purpose, fast | Fast (~4s) |
| Flux Dev | `fal-ai/flux/dev` | Higher quality Flux | Medium (~20s) |
| Stable Diffusion XL | `fal-ai/stable-diffusion-xl` | SDXL default | Medium (~15s) |
| Ideogram v2 | `fal-ai/ideogram/v2` | Text in images, logos, typography | Slow (~25s) |

**Selection guide**:
- Transparency needed (sprite, icon, UI element): **GPT Image 1.5** — only model that reliably outputs PNG with alpha
- Maximum speed (prototype iteration): **Nano Banana 2**
- Chroma-key workflow: **Nano Banana 2** with `#00FF00` background prompt
- Text in image: **Ideogram v2**
- Photorealistic character: **Grok Imagine**

---

## Queue-Based API

All fal.ai endpoints use a queue. Submit a job, poll for result.

### Step 1: Submit to Queue

```bash
curl -X POST https://queue.fal.run/fal-ai/nano-banana-2 \
  -H "Authorization: Key $FAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "pixel art warrior character, game sprite, transparent background, 64x64",
    "image_size": "square",
    "num_images": 1
  }'

# Response:
# {
#   "request_id": "req-abc123",
#   "status": "IN_QUEUE",
#   "queue_position": 0,
#   "response_url": "https://queue.fal.run/fal-ai/nano-banana-2/requests/req-abc123"
# }
```

### Step 2: Poll for Result

```bash
curl -H "Authorization: Key $FAL_KEY" \
  https://queue.fal.run/fal-ai/nano-banana-2/requests/REQ_ID

# When complete:
# {
#   "status": "COMPLETED",
#   "output": {
#     "images": [{"url": "https://fal.media/...", "width": 1024, "height": 1024}]
#   },
#   "metrics": {"inference_time": 4.2}
# }
```

### Step 3: Download

```bash
curl -o output.png "$(RESULT_URL_FROM_ABOVE)"
```

### Full Script (use `scripts/fal_queue_image_run.py`)

```bash
python3 scripts/fal_queue_image_run.py \
  --model fal-ai/nano-banana-2 \
  --prompt "pixel art warrior, game sprite, green background #00FF00" \
  --output public/assets/warrior-sprite.png \
  --size square
```

---

## Chroma-Key Workflow (Sprite Transparency)

When the model doesn't support native transparency, use a chroma-key green background then remove it in post.

### Step 1: Generate with Green Background

```bash
python3 scripts/fal_queue_image_run.py \
  --model fal-ai/nano-banana-2 \
  --prompt "pixel art warrior, game sprite, #00FF00 green background, no shadow, flat lighting" \
  --output /tmp/warrior-chroma.png \
  --size square
```

**Key prompt additions for clean chroma-key**:
- `"#00FF00 green background"` or `"solid lime green background"`
- `"no shadow"` (shadows bleed into the background, making removal imprecise)
- `"flat lighting"` (prevents green light spill on the character)

### Step 2: Remove Green Background

```python
from PIL import Image
import numpy as np

def remove_chroma_key(input_path: str, output_path: str, tolerance: int = 50) -> None:
    """Remove #00FF00 chroma-key background, output PNG with alpha."""
    img = Image.open(input_path).convert("RGBA")
    data = np.array(img)

    r, g, b, a = data[:,:,0], data[:,:,1], data[:,:,2], data[:,:,3]
    # Target: R < 100, G > 200, B < 100 (pure green range)
    mask = (r < tolerance) & (g > (255 - tolerance)) & (b < tolerance)
    data[mask] = [0, 0, 0, 0]  # Set to transparent

    Image.fromarray(data).save(output_path, "PNG")

remove_chroma_key("/tmp/warrior-chroma.png", "public/assets/warrior-sprite.png")
```

Requires: `pip install Pillow numpy`

---

## GPT Image 1.5 — Best for Transparency

GPT Image 1.5 supports native transparency via prompt instruction. No chroma-key removal needed.

```bash
curl -X POST https://queue.fal.run/fal-ai/gpt-image-1 \
  -H "Authorization: Key $FAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "pixel art warrior character, game sprite, transparent background, isolated subject, PNG format",
    "image_size": "1024x1024",
    "quality": "standard",
    "style": "vivid"
  }'
```

**GPT Image 1.5-specific parameters**:
- `quality`: `"standard"` or `"hd"` (hd costs more, slower)
- `style`: `"vivid"` (saturated, dramatic) or `"natural"` (realistic)
- `background`: `"transparent"` — explicit parameter to request PNG alpha (check current API docs)

---

## Common Parameters

Different models support different parameters. These are widely supported:

| Parameter | Values | Notes |
|-----------|--------|-------|
| `image_size` | `"square"`, `"landscape_4_3"`, `"portrait_16_9"`, `"1024x1024"` | Use `"square"` for sprites/icons |
| `num_images` | 1-4 | Most models: 1-4, some support up to 8 |
| `num_inference_steps` | 1-50 | Higher = better quality + slower. Default varies by model |
| `seed` | integer | Set for reproducibility |
| `negative_prompt` | string | What to avoid in the image |

---

## Cost Tracking

fal.ai includes billing info in response headers:

```bash
curl -v -H "Authorization: Key $FAL_KEY" \
  https://queue.fal.run/fal-ai/nano-banana-2/requests/REQ_ID 2>&1 \
  | grep -i "x-fal-"
# x-fal-billing-units: 1
# x-fal-credits-used: 0.003
```

`scripts/fal_queue_image_run.py` logs these automatically. Nano Banana 2 is cheapest (~$0.002/image). GPT Image 1.5 is most expensive (~$0.08/image hd).

---

## .meta.json Sidecar

```json
{
  "prompt": "pixel art warrior character, game sprite, transparent background",
  "model": "fal-ai/gpt-image-1",
  "request_id": "req-abc123",
  "image_size": "1024x1024",
  "generated_at": "2026-04-04T12:00:00Z",
  "source": "fal-ai",
  "output_path": "public/assets/warrior-sprite.png",
  "credits_used": 0.08,
  "seed": 42
}
```

---

## Error Reference

| Error | Cause | Fix |
|-------|-------|-----|
| 401 Unauthorized | Wrong auth format | Use `Key $FAL_KEY` not `Bearer $FAL_KEY` |
| 403 Forbidden | Invalid key | Regenerate at fal.ai |
| status: "FAILED", error: "content policy" | Prompt violates content policy | Rephrase prompt, remove violence/NSFW |
| status: "FAILED", error: "unsupported parameter" | Parameter not supported by this model | Check model docs, remove unsupported param |
| Green fringe after chroma removal | Tolerance too low | Increase `tolerance` from 50 to 80 in chroma removal |
| Transparent areas inside character | Tolerance too high | Decrease `tolerance` to 30 |
| Long wait (>60s for Nano Banana 2) | Queue congestion | Normal — fal.ai queues; poll every 3s |
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