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_pipeline_patterns.py

View on GitHub
#!/usr/bin/env python3
"""Tests for pipeline patterns: deterministic idle, action coaching, padding gate, provenance.

Run:
    python3 -m pytest skills/game/game-dev/scripts/test_pipeline_patterns.py -x -q
"""

from __future__ import annotations

import sys
from pathlib import Path

import numpy as np
import pytest
from PIL import Image, ImageDraw

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

import deterministic_idle
import sprite_prompt
from sprite_verify import verify_padding


# ---------------------------------------------------------------------------
# Pattern 1: Deterministic Breathing Idle
# ---------------------------------------------------------------------------
class TestDeterministicIdle:
    """Tests for deterministic_idle.py breathing loop generation."""

    @staticmethod
    def _make_portrait(size: int = 512) -> Image.Image:
        """Create a synthetic portrait with a visible character silhouette."""
        img = Image.new("RGBA", (size, size), (0, 0, 0, 0))
        draw = ImageDraw.Draw(img)
        # Head
        cx = size // 2
        head_r = size // 10
        head_top = size // 6
        draw.ellipse(
            (cx - head_r, head_top, cx + head_r, head_top + 2 * head_r),
            fill=(200, 150, 100, 255),
        )
        # Body
        body_w = size // 4
        body_top = head_top + 2 * head_r
        body_bot = size - size // 8
        draw.rectangle(
            (cx - body_w // 2, body_top, cx + body_w // 2, body_bot),
            fill=(60, 60, 180, 255),
        )
        return img

    def test_generates_4_frames(self) -> None:
        """generate_idle_frames produces 4 frames with correct dimensions."""
        portrait = self._make_portrait(512)
        frames = deterministic_idle.generate_idle_frames(portrait, num_frames=4)
        assert len(frames) == 4
        for f in frames:
            assert f.size == (512, 512)
            assert f.mode == "RGBA"

    def test_frames_differ(self) -> None:
        """Breathing frames are not identical to the base (inhale/exhale differ)."""
        portrait = self._make_portrait(512)
        frames = deterministic_idle.generate_idle_frames(portrait, num_frames=4)
        # Frame 0 is base copy, frame 1 is inhale -- they should differ
        arr0 = np.array(frames[0])
        arr1 = np.array(frames[1])
        assert not np.array_equal(arr0, arr1), "inhale frame should differ from neutral"

    def test_strip_output(self, tmp_path: Path) -> None:
        """write_strip produces a horizontal strip of correct dimensions."""
        portrait = self._make_portrait(256)
        frames = deterministic_idle.generate_idle_frames(portrait, num_frames=4)
        strip_path = tmp_path / "strip.png"
        deterministic_idle.write_strip(frames, strip_path)
        assert strip_path.exists()
        strip = Image.open(strip_path)
        assert strip.size == (256 * 4, 256)

    def test_animation_outputs(self, tmp_path: Path) -> None:
        """write_animation produces GIF and WebP files."""
        portrait = self._make_portrait(128)
        frames = deterministic_idle.generate_idle_frames(portrait, num_frames=4)
        gif_path = tmp_path / "anim.gif"
        webp_path = tmp_path / "anim.webp"
        deterministic_idle.write_animation(frames, gif_path, fps=5)
        deterministic_idle.write_animation(frames, webp_path, fps=5)
        assert gif_path.exists()
        assert webp_path.exists()

    def test_cli_end_to_end(self, tmp_path: Path) -> None:
        """CLI main() produces all expected output files."""
        portrait = self._make_portrait(256)
        input_path = tmp_path / "portrait.png"
        portrait.save(input_path)
        out_dir = tmp_path / "idle_out"

        rc = deterministic_idle.main(
            [
                "--input",
                str(input_path),
                "--output-dir",
                str(out_dir),
                "--body-ratio",
                "0.74",
                "--frames",
                "4",
                "--fps",
                "5",
            ]
        )
        assert rc == 0
        assert (out_dir / "idle-strip.png").exists()
        assert (out_dir / "animation.gif").exists()
        assert (out_dir / "animation.webp").exists()
        assert (out_dir / "idle-meta.json").exists()
        assert (out_dir / "frames" / "frame-000.png").exists()
        assert (out_dir / "frames" / "frame-003.png").exists()

    def test_empty_image_returns_copy(self) -> None:
        """build_breath_frame on an empty image returns a copy without crashing."""
        empty = Image.new("RGBA", (64, 64), (0, 0, 0, 0))
        result = deterministic_idle.build_breath_frame(empty, 1.006, 1, 0.74)
        assert result.size == (64, 64)

    def test_few_frames(self) -> None:
        """num_frames=2 produces only 2 frames."""
        portrait = self._make_portrait(128)
        frames = deterministic_idle.generate_idle_frames(portrait, num_frames=2)
        assert len(frames) == 2

    def test_single_frame(self) -> None:
        """num_frames=1 produces a single base copy."""
        portrait = self._make_portrait(128)
        frames = deterministic_idle.generate_idle_frames(portrait, num_frames=1)
        assert len(frames) == 1


# ---------------------------------------------------------------------------
# Pattern 2: Per-Action Negative-Prompt Coaching
# ---------------------------------------------------------------------------
class TestActionCoaching:
    """Tests for ACTION_COACHING dict and prompt injection."""

    def test_coaching_dict_covers_all_presets(self) -> None:
        """ACTION_COACHING has entries for all preset states."""
        for _preset_name, preset in sprite_prompt.ANIMATION_PRESETS.items():
            for row in preset["rows"]:
                state = row["state"]
                # Not all states need coaching (running-right/left are variants)
                # but core states should be covered
                if state in sprite_prompt.ACTION_COACHING:
                    assert isinstance(sprite_prompt.ACTION_COACHING[state], str)

    def test_coaching_injected_in_row_strip_prompt(self) -> None:
        """compose_row_strip_prompt includes ACTION COACHING for known states."""
        meta = sprite_prompt.PromptMetadata(
            mode="row-strip",
            style_preset="modern-hi-bit",
            description="test fighter",
            action="combat idle",
            grid_cols=6,
            grid_rows=1,
            seed=0,
        )
        prompt = sprite_prompt.compose_row_strip_prompt(meta, state="idle", frames=6, action="combat idle")
        assert "ACTION COACHING:" in prompt
        assert "NOT a T-pose" in prompt

    def test_coaching_not_injected_for_unknown_state(self) -> None:
        """compose_row_strip_prompt omits ACTION COACHING for unknown states."""
        meta = sprite_prompt.PromptMetadata(
            mode="row-strip",
            style_preset="modern-hi-bit",
            description="test",
            action="some unknown action",
            grid_cols=4,
            grid_rows=1,
            seed=0,
        )
        prompt = sprite_prompt.compose_row_strip_prompt(
            meta, state="totally-unknown-state", frames=4, action="some unknown"
        )
        assert "ACTION COACHING:" not in prompt

    def test_coaching_after_vfx_rules(self) -> None:
        """ACTION COACHING appears after VFX containment rules in the prompt."""
        meta = sprite_prompt.PromptMetadata(
            mode="row-strip",
            style_preset="modern-hi-bit",
            description="test",
            action="dash",
            grid_cols=8,
            grid_rows=1,
            seed=0,
        )
        prompt = sprite_prompt.compose_row_strip_prompt(meta, state="dash-right", frames=8, action="rightward dash")
        vfx_pos = prompt.find("EFFECTS RULES:")
        coaching_pos = prompt.find("ACTION COACHING:")
        assert vfx_pos < coaching_pos, "coaching should appear after VFX rules"


# ---------------------------------------------------------------------------
# Pattern 3: CI Padding Validator Gate
# ---------------------------------------------------------------------------
class TestVerifyPadding:
    """Tests for verify_padding gate."""

    @staticmethod
    def _make_sheet(
        cols: int,
        rows: int,
        cell_size: int,
        fill_pct: float = 0.7,
    ) -> Image.Image:
        """Create a synthetic sheet with characters filling fill_pct of each cell."""
        sheet = Image.new("RGBA", (cols * cell_size, rows * cell_size), (0, 0, 0, 0))
        draw = ImageDraw.Draw(sheet)
        margin = int(cell_size * (1 - fill_pct) / 2)
        for r in range(rows):
            for c in range(cols):
                x0 = c * cell_size + margin
                y0 = r * cell_size + margin
                x1 = (c + 1) * cell_size - margin
                y1 = (r + 1) * cell_size - margin
                draw.rectangle((x0, y0, x1, y1), fill=(100, 150, 200, 255))
        return sheet

    def test_passes_for_well_filled_cells(self) -> None:
        """Cells filled at 70% pass the 15% padding threshold."""
        sheet = self._make_sheet(4, 2, 256, fill_pct=0.7)
        result = verify_padding(sheet, 4, 2, 256)
        assert result["passed"] is True
        assert len(result["frames_with_excess_padding"]) == 0

    def test_fails_for_tiny_sprites(self) -> None:
        """Cells filled at only 30% (35% padding per side) fail."""
        sheet = self._make_sheet(4, 1, 256, fill_pct=0.3)
        result = verify_padding(sheet, 4, 1, 256)
        assert result["passed"] is False
        assert len(result["frames_with_excess_padding"]) == 4

    def test_skips_expected_empty_cells(self) -> None:
        """Expected empty cells are excluded from padding analysis."""
        sheet = Image.new("RGBA", (4 * 256, 256), (0, 0, 0, 0))
        # Only fill first 2 cells
        draw = ImageDraw.Draw(sheet)
        for c in range(2):
            m = 20
            draw.rectangle((c * 256 + m, m, (c + 1) * 256 - m, 256 - m), fill=(100, 100, 200, 255))
        result = verify_padding(
            sheet,
            4,
            1,
            256,
            expected_empty_cells=[(0, 2), (0, 3)],
        )
        assert result["passed"] is True

    def test_reports_max_padding_pct(self) -> None:
        """Result includes the max padding percentage across all frames."""
        sheet = self._make_sheet(2, 1, 256, fill_pct=0.5)
        result = verify_padding(sheet, 2, 1, 256)
        assert result["max_padding_pct"] > 0

    def test_custom_threshold(self) -> None:
        """Custom max_padding_pct threshold works."""
        sheet = self._make_sheet(2, 1, 256, fill_pct=0.7)
        # 70% fill -> 15% padding per side. Should pass at 15% but fail at 10%.
        result_pass = verify_padding(sheet, 2, 1, 256, max_padding_pct=15.0)
        result_fail = verify_padding(sheet, 2, 1, 256, max_padding_pct=10.0)
        assert result_pass["passed"] is True
        assert result_fail["passed"] is False
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