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/test_rc4_mass_centroid_default.py

View on GitHub
#!/usr/bin/env python3
"""Regression tests for ADR-208 RC-4 (mass-centroid is the default anchor mode).

ADR-208 flips the default anchor mode in `normalize_spritesheet` from
`ground-line` (legacy) to `mass-centroid`. The mass centroid integrates
over all opaque pixels, so a single limb extension only nudges it by a few
pixels (vs the dozens that bbox-bottom shifts on action sheets). The
empirical drop on the canonical luchadora-highflyer/05-specials sample:
anchor stddev 17.5 -> 0.6 px.

Tests:
  1. `normalize_spritesheet`'s `anchor_mode` parameter defaults to
     "mass-centroid".
  2. `sprite_pipeline.py --anchor-mode` argparse default is
     "mass-centroid".
  3. `sprite_process.py normalize --anchor-mode` argparse default is
     "mass-centroid".
  4. End-to-end: a synthetic sheet with a "fist" extending downward on one
     frame produces a tighter centroid stddev under mass-centroid than
     under ground-line.

Run with pytest:

    pytest skills/game/game-dev/scripts/test_rc4_mass_centroid_default.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_pipeline
import sprite_process
import sprite_verify


def test_normalize_spritesheet_default_anchor_mode_is_mass_centroid() -> None:
    """`normalize_spritesheet`'s default `anchor_mode` is `mass-centroid`."""
    sig = inspect.signature(sprite_anchor.normalize_spritesheet)
    default = sig.parameters["anchor_mode"].default
    assert default == "mass-centroid", f"expected default 'mass-centroid'; got {default!r}"


def test_sprite_pipeline_argparse_default_anchor_mode() -> None:
    """`sprite_pipeline.py --anchor-mode` argparse default is `mass-centroid`."""
    parser = sprite_pipeline.build_parser()
    actions = {a.dest: a for a in parser._actions}
    anchor_action = actions["anchor_mode"]
    assert anchor_action.default == "mass-centroid", anchor_action.default


def test_sprite_process_normalize_argparse_default_anchor_mode() -> None:
    """`sprite_process.py normalize --anchor-mode` argparse default is `mass-centroid`."""
    parser = sprite_process.build_parser()
    # Find the normalize subparser.
    subparsers = [a for a in parser._actions if isinstance(a, type(parser._subparsers))]
    # Easier: parse and inspect.
    args = parser.parse_args(
        [
            "normalize",
            "--mode",
            "spritesheet",
            "--input-dir",
            "/tmp/_unused",
            "--output-dir",
            "/tmp/_unused",
        ]
    )
    assert args.anchor_mode == "mass-centroid", args.anchor_mode


def _make_action_frames_with_one_lunge(cell: int = 256, n_frames: int = 4) -> list[Image.Image]:
    """Build n_frames frames where one frame has a "fist" extending below the body.

    The lunge frame's bbox-bottom is dominated by the fist (low y), so
    bbox-bottom anchoring would pin the fist instead of the body trunk
    and the centroid would shift visibly upward. Mass-centroid anchoring
    integrates over all opaque pixels and pins the trunk-centroid stable.
    """
    frames: list[Image.Image] = []
    for i in range(n_frames):
        img = np.zeros((cell, cell, 4), dtype=np.uint8)
        # Body trunk: rectangle from y=64 to y=192, x=96 to x=160 (centered)
        img[64:192, 96:160, :3] = (200, 100, 80)
        img[64:192, 96:160, 3] = 255
        # Head: top of trunk
        img[40:64, 110:146, :3] = (220, 180, 150)
        img[40:64, 110:146, 3] = 255
        # Lunge: on frame 1, add a "fist" extending DOWN past the body
        # (bbox-bottom is at y=240 instead of y=192).
        if i == 1:
            img[192:240, 130:150, :3] = (220, 180, 150)
            img[192:240, 130:150, 3] = 255
        frames.append(Image.fromarray(img, "RGBA"))
    return frames


def test_mass_centroid_stays_stable_against_lunge_outlier(tmp_path: Path) -> None:
    """Synthetic 4-frame sheet with one lunge frame: mass-centroid stddev < 8 px."""
    frames = _make_action_frames_with_one_lunge(cell=256, n_frames=4)
    frame_paths: list[Path] = []
    for i, fr in enumerate(frames):
        p = tmp_path / f"sheet_frame_{i:02d}.png"
        fr.save(p)
        frame_paths.append(p)

    output_dir = tmp_path / "normalized_centroid"
    sprite_anchor.normalize_spritesheet(
        frame_paths,
        output_dir,
        cell_w=256,
        cell_h=256,
        anchor_mode="mass-centroid",
    )

    # Re-assemble into a sheet for verification
    cell = 256
    sheet = Image.new("RGBA", (4 * cell, cell), (0, 0, 0, 0))
    for i in range(4):
        cell_img = Image.open(output_dir / f"sheet_frame_{i:02d}.png").convert("RGBA")
        sheet.paste(cell_img, (i * cell, 0), cell_img)
    sheet_path = tmp_path / "centroid_sheet.png"
    sheet.save(sheet_path)
    res = sprite_verify.verify_anchor_consistency(sheet_path, 4, 1, cell, max_centroid_y_stddev_px=8.0)
    assert res["passed"], f"mass-centroid should pass anchor stddev <= 8; got {res}"
    # Also assert the absolute stddev is well under 8 (the "drift-free" claim).
    assert res["stddev"] < 8.0, f"mass-centroid stddev {res['stddev']} not < 8 px"


def test_ground_line_drifts_against_lunge_outlier(tmp_path: Path) -> None:
    """Same synthetic input under ground-line anchor: stddev > mass-centroid's.

    This is the negative control proving the default flip matters: the
    same input that mass-centroid drives near-zero produces measurable
    drift under the legacy ground-line strategy.
    """
    frames = _make_action_frames_with_one_lunge(cell=256, n_frames=4)
    frame_paths: list[Path] = []
    for i, fr in enumerate(frames):
        p = tmp_path / f"sheet_frame_{i:02d}.png"
        fr.save(p)
        frame_paths.append(p)

    output_dir_centroid = tmp_path / "normalized_centroid"
    sprite_anchor.normalize_spritesheet(
        frame_paths, output_dir_centroid, cell_w=256, cell_h=256, anchor_mode="mass-centroid"
    )
    output_dir_groundline = tmp_path / "normalized_groundline"
    sprite_anchor.normalize_spritesheet(
        frame_paths, output_dir_groundline, cell_w=256, cell_h=256, anchor_mode="ground-line"
    )

    cell = 256

    def _stddev(out_dir: Path) -> float:
        sheet = Image.new("RGBA", (4 * cell, cell), (0, 0, 0, 0))
        for i in range(4):
            cell_img = Image.open(out_dir / f"sheet_frame_{i:02d}.png").convert("RGBA")
            sheet.paste(cell_img, (i * cell, 0), cell_img)
        sheet_path = out_dir.parent / f"{out_dir.name}_sheet.png"
        sheet.save(sheet_path)
        return float(sprite_verify.verify_anchor_consistency(sheet_path, 4, 1, cell)["stddev"])

    centroid_stddev = _stddev(output_dir_centroid)
    groundline_stddev = _stddev(output_dir_groundline)
    # mass-centroid's stddev should be smaller than ground-line's on this
    # input. The exact magnitude is implementation-dependent so we assert
    # the *ordering* (which is the contract the default flip is built on).
    assert centroid_stddev <= groundline_stddev, (
        f"mass-centroid stddev ({centroid_stddev}) should be <= ground-line stddev ({groundline_stddev})"
    )


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

    no_arg_tests = [
        test_normalize_spritesheet_default_anchor_mode_is_mass_centroid,
        test_sprite_pipeline_argparse_default_anchor_mode,
        test_sprite_process_normalize_argparse_default_anchor_mode,
    ]
    tmp_tests = [
        test_mass_centroid_stays_stable_against_lunge_outlier,
        test_ground_line_drifts_against_lunge_outlier,
    ]
    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