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 md13.2 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/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.5 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.0 KB
references/pixel-art-sprites.mdmarkdown8.7 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/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

scripts/fal_queue_image_run.py

View on GitHub
#!/usr/bin/env python3
"""
fal_queue_image_run.py — fal.ai queue-based image generation with cost tracking

Submits an image generation job to fal.ai, polls for result, downloads output,
and logs billing info from response headers.

Requires: FAL_KEY in env or ~/.env
Dependencies: pip install requests python-dotenv Pillow

Usage:
    python3 fal_queue_image_run.py \\
        --model fal-ai/nano-banana-2 \\
        --prompt "pixel art warrior, game sprite, transparent background" \\
        --output public/assets/warrior.png

    python3 fal_queue_image_run.py \\
        --model fal-ai/gpt-image-1 \\
        --prompt "medieval castle, concept art" \\
        --size landscape_4_3 \\
        --output public/assets/castle.png \\
        --chroma-key  # remove #00FF00 background after generation
"""

import argparse
import json
import os
import sys
import time
import urllib.error
import urllib.request
from pathlib import Path

# ── Env loading ──────────────────────────────────────────────────────────────


def load_env():
    """Load ~/.env file into os.environ (without requiring python-dotenv)."""
    env_path = Path.home() / ".env"
    if not env_path.is_file():
        return
    for line in env_path.read_text().splitlines():
        line = line.strip()
        if not line or line.startswith("#"):
            continue
        eq = line.find("=")
        if eq == -1:
            continue
        key = line[:eq].strip()
        val = line[eq + 1 :].strip().strip("\"'")
        if key not in os.environ:
            os.environ[key] = val


FAL_KEY: str | None = None

POLL_INTERVAL = 3  # seconds
MAX_POLLS = 200  # 10 minutes


def _ensure_fal_key() -> str:
    """Load env, check for FAL_KEY, and return it. Exits on missing key."""
    global FAL_KEY
    load_env()
    FAL_KEY = os.environ.get("FAL_KEY")
    if not FAL_KEY:
        print("Error: FAL_KEY not found in env or ~/.env", file=sys.stderr)
        print("Get your key at fal.ai", file=sys.stderr)
        sys.exit(1)
    return FAL_KEY


# ── HTTP helpers ─────────────────────────────────────────────────────────────


def fal_request(method: str, url: str, body: dict | None = None) -> tuple[dict, dict]:
    """Make a fal.ai request. Returns (response_json, headers)."""
    data = json.dumps(body).encode() if body else None
    headers = {
        "Authorization": f"Key {FAL_KEY}",
        "Content-Type": "application/json",
    }
    req = urllib.request.Request(url, data=data, headers=headers, method=method)
    try:
        with urllib.request.urlopen(req) as resp:
            resp_headers = dict(resp.headers)
            resp_body = json.loads(resp.read())
            return resp_body, resp_headers
    except urllib.error.HTTPError as e:
        body_text = e.read().decode()
        raise RuntimeError(f"fal.ai {e.code}: {body_text}") from e


def download_file(url: str, output_path: Path) -> None:
    """Download a file from URL to output_path."""
    output_path.parent.mkdir(parents=True, exist_ok=True)
    req = urllib.request.Request(url)
    with urllib.request.urlopen(req) as resp:
        output_path.write_bytes(resp.read())
    size = output_path.stat().st_size
    if size == 0:
        raise RuntimeError(f"Downloaded file is empty: {output_path}")
    print(f"Downloaded {size / 1024:.1f}KB -> {output_path}")


# ── Chroma-key removal ───────────────────────────────────────────────────────


def remove_chroma_key(image_path: Path, tolerance: int = 60) -> None:
    """Remove #00FF00 green background, convert to RGBA PNG."""
    try:
        import struct

        from PIL import Image
    except ImportError:
        print("Warning: Pillow not installed. Skipping chroma-key removal.", file=sys.stderr)
        print("Install: pip install Pillow", file=sys.stderr)
        return

    img = Image.open(image_path).convert("RGBA")
    pixels = img.load()
    w, h = img.size

    removed = 0
    for y in range(h):
        for x in range(w):
            r, g, b, a = pixels[x, y]
            # Match green: low red, high green, low blue
            if r < tolerance and g > (255 - tolerance) and b < tolerance:
                pixels[x, y] = (0, 0, 0, 0)
                removed += 1

    img.save(image_path, "PNG")
    pct = removed / (w * h) * 100
    print(f"Chroma-key: removed {removed} green pixels ({pct:.1f}% of image)")


# ── Main ──────────────────────────────────────────────────────────────────────


def main():
    _ensure_fal_key()

    parser = argparse.ArgumentParser(description="fal.ai queue-based image generation")
    parser.add_argument(
        "--model", default="fal-ai/nano-banana-2", help="Model endpoint (default: fal-ai/nano-banana-2)"
    )
    parser.add_argument("--prompt", required=True, help="Image generation prompt")
    parser.add_argument("--negative-prompt", default="", help="Negative prompt")
    parser.add_argument("--output", required=True, help="Output file path")
    parser.add_argument(
        "--size", default="square", help="Image size: square | landscape_4_3 | portrait_16_9 | 1024x1024"
    )
    parser.add_argument("--num-images", type=int, default=1)
    parser.add_argument("--seed", type=int, help="Random seed for reproducibility")
    parser.add_argument("--steps", type=int, help="Inference steps (model-dependent)")
    parser.add_argument("--chroma-key", action="store_true", help="Remove #00FF00 background after generation")
    parser.add_argument(
        "--chroma-tolerance", type=int, default=60, help="Green detection tolerance (0-255, default 60)"
    )
    args = parser.parse_args()

    output_path = Path(args.output)

    # Build request body
    body: dict = {
        "prompt": args.prompt,
        "image_size": args.size,
        "num_images": args.num_images,
    }
    if args.negative_prompt:
        body["negative_prompt"] = args.negative_prompt
    if args.seed is not None:
        body["seed"] = args.seed
    if args.steps is not None:
        body["num_inference_steps"] = args.steps

    # Submit to queue
    queue_url = f"https://queue.fal.run/{args.model}"
    print(f"[fal.ai] Submitting to {args.model}...")
    print(f"[fal.ai] Prompt: {args.prompt[:80]}{'...' if len(args.prompt) > 80 else ''}")

    result, headers = fal_request("POST", queue_url, body)
    request_id = result.get("request_id")
    if not request_id:
        raise RuntimeError(f"No request_id in response: {result}")
    print(f"[fal.ai] Request ID: {request_id}")

    # Poll for result
    status_url = f"https://queue.fal.run/{args.model}/requests/{request_id}"
    for i in range(MAX_POLLS):
        time.sleep(POLL_INTERVAL)
        data, resp_headers = fal_request("GET", status_url)
        status = data.get("status", "UNKNOWN")
        print(f"\r[fal.ai] {status} ({i * POLL_INTERVAL}s)...", end="", flush=True)

        if status == "COMPLETED":
            print()  # newline after status
            # Log billing info
            credits = resp_headers.get("x-fal-credits-used") or resp_headers.get("X-Fal-Credits-Used")
            units = resp_headers.get("x-fal-billing-units") or resp_headers.get("X-Fal-Billing-Units")
            if credits:
                print(f"[fal.ai] Cost: ${float(credits):.4f} ({units or '?'} units)")

            # Get image URL from output
            output = data.get("output", {})
            images = output.get("images", [])
            if not images:
                raise RuntimeError(f"No images in output: {data}")
            image_url = images[0]["url"]

            # Download
            download_file(image_url, output_path)

            # Optional: chroma-key removal
            if args.chroma_key:
                print("[fal.ai] Removing chroma-key background...")
                remove_chroma_key(output_path, args.chroma_tolerance)

            # Save .meta.json
            meta = {
                "prompt": args.prompt,
                "model": args.model,
                "request_id": request_id,
                "image_size": args.size,
                "generated_at": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
                "source": "fal-ai",
                "output_path": str(output_path),
                "credits_used": float(credits) if credits else None,
                "seed": args.seed,
                "chroma_key_applied": args.chroma_key,
            }
            meta_path = output_path.with_suffix(".meta.json")
            meta_path.write_text(json.dumps(meta, indent=2))
            print(f"Meta -> {meta_path}")
            print(f"\nDone: {output_path}")
            return

        if status == "FAILED":
            print()
            error = data.get("error") or data.get("detail", "Unknown error")
            raise RuntimeError(f"Generation failed: {error}")

    raise RuntimeError(f"Timed out after {MAX_POLLS * POLL_INTERVAL}s")


if __name__ == "__main__":
    try:
        main()
    except KeyboardInterrupt:
        print("\nCancelled.")
        sys.exit(1)
    except RuntimeError as e:
        print(f"\nError: {e}", file=sys.stderr)
        sys.exit(1)
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 321kUpdated 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: 197kUpdated 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