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

scripts/test_rc5_despill_pre_upscale.py

View on GitHub
#!/usr/bin/env python3
"""Regression tests for ADR-208 RC-5 (pre-upscale despill on the raw).

ADR-208 introduces `_pre_despill_raw_for_upscale` and wires it as the
default `pre_despill_raw=True` parameter on `slice_grid_cells`. The fix
zeroes magenta pixels to alpha=0 on the raw BEFORE per-cell LANCZOS
upscale; LANCZOS then interpolates between transparent and content
(alpha-aware) instead of between magenta and content (RGB-only). The
resulting fringe is alpha-faded character RGB instead of pink-tinted RGB.

A second post-anchor despill pass (`_post_anchor_despill_pink` in
sprite_anchor) handles the residual band that the shared-scale rescale
reintroduces.

Tests:
  1. `slice_grid_cells`'s `pre_despill_raw` defaults to True.
  2. Synthetic 1254x1254 raw with magenta bg + colored content, sliced
     into 8x8 / 256, post-pipeline wide_count is much lower with
     pre-despill ON than OFF.
  3. `_pre_despill_raw_for_upscale` zeroes magenta pixels' alpha to 0.
  4. `_post_anchor_despill_pink` is callable and reduces wide-pink count
     on a known-pink-cast input.

Run with pytest:

    pytest skills/game/game-dev/scripts/test_rc5_despill_pre_upscale.py -v
"""

from __future__ import annotations

import inspect
import sys
from pathlib import Path

import numpy as np
from PIL import Image

SCRIPT_DIR = Path(__file__).resolve().parent
sys.path.insert(0, str(SCRIPT_DIR))

import sprite_anchor
import sprite_slicing
import sprite_verify

GRID = 8
RAW_SIZE = 1254  # Codex's actual canvas size on a "2048 spec" output
CELL = 256


def test_slice_grid_cells_pre_despill_default_is_true() -> None:
    """`slice_grid_cells`'s `pre_despill_raw` parameter defaults to True."""
    sig = inspect.signature(sprite_slicing.slice_grid_cells)
    default = sig.parameters["pre_despill_raw"].default
    assert default is True, f"expected default True; got {default!r}"


def _make_synthetic_codex_raw(size: int = RAW_SIZE, grid: int = GRID) -> Image.Image:
    """Build a magenta-bg sheet with colored shapes per cell at ~grid pitch.

    Mimics the Codex output contract: 1254x1254 (or similar fractional)
    canvas, magenta background, character art per ~156.75-px pitch cell.
    Each cell gets a circle of a different color so frames are distinct.
    """
    img = np.full((size, size, 4), (255, 0, 255, 255), dtype=np.uint8)
    pitch = size / grid
    rng = np.random.default_rng(1234)
    for r in range(grid):
        for c in range(grid):
            cx = int((c + 0.5) * pitch)
            cy = int((r + 0.5) * pitch)
            radius = int(pitch * 0.35)
            # Random saturated color, deterministic per (r,c)
            color = tuple(int(x) for x in rng.integers(40, 220, size=3))
            yy, xx = np.ogrid[:size, :size]
            mask = (xx - cx) ** 2 + (yy - cy) ** 2 <= radius**2
            img[mask, 0] = color[0]
            img[mask, 1] = color[1]
            img[mask, 2] = color[2]
            img[mask, 3] = 255
    return Image.fromarray(img, "RGBA")


def test_pre_despill_zeroes_magenta_alpha() -> None:
    """`_pre_despill_raw_for_upscale` sets alpha=0 on magenta pixels."""
    img = Image.new("RGBA", (10, 10), (255, 0, 255, 255))
    out = sprite_slicing._pre_despill_raw_for_upscale(img, chroma_threshold=30)
    arr = np.array(out)
    # All pixels were magenta -> all alpha should now be 0
    assert (arr[..., 3] == 0).all(), f"expected all alpha=0 after pre-despill; got {arr[..., 3]}"


def test_pre_despill_preserves_content_alpha() -> None:
    """Non-magenta pixels keep their original alpha."""
    img = Image.new("RGBA", (10, 10), (50, 200, 80, 255))
    out = sprite_slicing._pre_despill_raw_for_upscale(img, chroma_threshold=30)
    arr = np.array(out)
    assert (arr[..., 3] == 255).all(), "non-magenta pixels should retain alpha"


def test_full_pipeline_pre_despill_reduces_wide_pink(tmp_path: Path) -> None:
    """End-to-end: pre-despill + post-anchor despill drives wide_count well below 100."""
    raw = _make_synthetic_codex_raw()
    raw_path = tmp_path / "raw.png"
    raw.save(raw_path)

    # Slice with strict-pitch (default pre_despill_raw=True).
    cells = sprite_slicing.slice_grid_cells(raw, GRID, GRID, CELL)
    assert len(cells) == GRID * GRID

    frames_dir = tmp_path / "frames_raw"
    frames_dir.mkdir(exist_ok=True)
    paths: list[Path] = []
    for i, cell in enumerate(cells):
        p = frames_dir / f"sheet_frame_{i:02d}.png"
        cell.save(p)
        paths.append(p)

    # Run the standard remove-bg + normalize chain.
    import sprite_process

    nobg_dir = tmp_path / "frames_nobg"
    rc = sprite_process.main(
        [
            "remove-bg",
            *(str(p) for p in paths),
            "--output-dir",
            str(nobg_dir),
            "--bg-mode",
            "chroma",
            "--chroma-threshold",
            "80",
        ]
    )
    assert rc == 0

    norm_dir = tmp_path / "frames_normalized"
    rc = sprite_process.main(
        [
            "normalize",
            "--mode",
            "spritesheet",
            "--input-dir",
            str(nobg_dir),
            "--output-dir",
            str(norm_dir),
            "--cell-size",
            str(CELL),
            "--anchor-mode",
            "mass-centroid",
        ]
    )
    assert rc == 0

    # Assemble final sheet
    out_dir = tmp_path / "out"
    rc = sprite_process.main(
        [
            "assemble",
            "--frames-dir",
            str(norm_dir),
            "--grid",
            f"{GRID}x{GRID}",
            "--cell-size",
            str(CELL),
            "--output-dir",
            str(out_dir),
            "--name",
            "sheet",
            "--no-strips",
        ]
    )
    assert rc == 0

    sheet_path = out_dir / "sheet_sheet.png"
    mag = sprite_verify.verify_no_magenta(sheet_path, threshold_strict=0, threshold_wide=30)
    # ADR-208 RC-5: the spritesheet orchestrator threshold is 30.
    assert mag["wide_count"] <= 30, (
        f"expected wide_count <= 30 with pre-despill on; got wide_count={mag['wide_count']}, "
        f"strict_count={mag['strict_count']}"
    )


def test_post_anchor_despill_helper_exists_and_callable() -> None:
    """`_post_anchor_despill_pink` is the documented RC-5 cleanup helper."""
    helper = sprite_anchor._post_anchor_despill_pink
    # Build a 10x10 RGBA array with pink-cast pixels at silhouette edge.
    arr = np.zeros((10, 10, 4), dtype=np.uint8)
    arr[:, :, 0] = 220  # R high
    arr[:, :, 1] = 80  # G low
    arr[:, :, 2] = 150  # B moderate
    arr[:, :, 3] = 220  # alpha > 200 (relaxed criterion)
    out = helper(arr)
    # Pink-cast should be neutralized: R and B pulled down to G.
    assert (out[..., 0] == 80).all(), f"R should be pulled to G; got {out[..., 0]}"
    assert (out[..., 2] == 80).all(), f"B should be pulled to G; got {out[..., 2]}"


def main() -> int:
    """Standalone runner (works without pytest)."""
    import tempfile

    no_arg_tests = [
        test_slice_grid_cells_pre_despill_default_is_true,
        test_pre_despill_zeroes_magenta_alpha,
        test_pre_despill_preserves_content_alpha,
        test_post_anchor_despill_helper_exists_and_callable,
    ]
    tmp_tests = [
        test_full_pipeline_pre_despill_reduces_wide_pink,
    ]
    failures: list[tuple[str, str]] = []
    for t in no_arg_tests:
        try:
            t()
            print(f"PASS {t.__name__}")
        except AssertionError as e:
            print(f"FAIL {t.__name__}: {e}")
            failures.append((t.__name__, str(e)))
    for t in tmp_tests:
        with tempfile.TemporaryDirectory() as td:
            try:
                t(Path(td))
                print(f"PASS {t.__name__}")
            except AssertionError as e:
                print(f"FAIL {t.__name__}: {e}")
                failures.append((t.__name__, str(e)))
    if failures:
        print(f"\n{len(failures)} FAIL")
        return 1
    print(f"\nAll {len(no_arg_tests) + len(tmp_tests)} tests passed.")
    return 0


if __name__ == "__main__":
    sys.exit(main())
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