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

View on GitHub
#!/usr/bin/env python3
"""Per-row job manifest for subagent orchestration (Phase 4).

Tracks per-row generation status so the orchestration layer can delegate
individual rows to subagents and resume on failure. The manifest is a
JSON file (``row-jobs.json``) in the work directory.

Subcommands:
    init            Create manifest from preset
    status          Print summary of row statuses
    mark            Update a row's status
    list-pending    List rows that still need work (pending or failed)

Usage:
    python3 row_job_status.py init --preset fighter --output-dir /tmp/work
    python3 row_job_status.py status --work-dir /tmp/work
    python3 row_job_status.py mark --work-dir /tmp/work --row 0 --status done
    python3 row_job_status.py list-pending --work-dir /tmp/work
"""

from __future__ import annotations

import argparse
import json
import logging
import sys
from datetime import datetime, timezone
from pathlib import Path

logger = logging.getLogger("sprite-pipeline.row_job_status")

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

import sprite_prompt

VALID_STATUSES = ("pending", "in-progress", "done", "failed")
MANIFEST_FILENAME = "row-jobs.json"


def _manifest_path(work_dir: Path) -> Path:
    """Return path to the row-jobs manifest."""
    return work_dir / MANIFEST_FILENAME


def init_manifest(preset_name: str, work_dir: Path) -> dict:
    """Create a row-jobs manifest from a named preset.

    Args:
        preset_name: Preset key (e.g., "fighter", "rpg-character").
        work_dir: Directory to write row-jobs.json into.

    Returns:
        The manifest dict that was written.
    """
    preset = sprite_prompt.resolve_preset(preset_name)
    rows = preset["rows"]

    jobs = []
    for idx, row_def in enumerate(rows):
        jobs.append(
            {
                "row_index": idx,
                "state": row_def["state"],
                "frames": row_def["frames"],
                "action": row_def["action"],
                "status": "pending",
                "updated_at": None,
                "output_path": None,
                "error": None,
            }
        )

    manifest = {
        "preset": preset_name,
        "total_rows": len(rows),
        "created_at": datetime.now(timezone.utc).isoformat(),
        "jobs": jobs,
    }

    work_dir.mkdir(parents=True, exist_ok=True)
    out = _manifest_path(work_dir)
    out.write_text(json.dumps(manifest, indent=2), encoding="utf-8")
    logger.info("[row-jobs] init: %d rows from preset %r -> %s", len(rows), preset_name, out)
    return manifest


def load_manifest(work_dir: Path) -> dict:
    """Load the manifest from work_dir.

    Raises:
        FileNotFoundError: If row-jobs.json does not exist.
    """
    path = _manifest_path(work_dir)
    if not path.exists():
        raise FileNotFoundError(f"No manifest at {path}. Run 'init' first.")
    return json.loads(path.read_text(encoding="utf-8"))


def save_manifest(work_dir: Path, manifest: dict) -> None:
    """Write manifest back to work_dir."""
    path = _manifest_path(work_dir)
    path.write_text(json.dumps(manifest, indent=2), encoding="utf-8")


def mark_row(
    work_dir: Path,
    row_index: int,
    status: str,
    output_path: str | None = None,
    error: str | None = None,
) -> dict:
    """Update a row's status in the manifest.

    Args:
        work_dir: Directory containing row-jobs.json.
        row_index: Zero-based row index.
        status: One of pending, in-progress, done, failed.
        output_path: Path to output strip (set on done).
        error: Error message (set on failed).

    Returns:
        The updated manifest.

    Raises:
        ValueError: On invalid status or row_index.
    """
    if status not in VALID_STATUSES:
        raise ValueError(f"Invalid status {status!r}. Choose from {VALID_STATUSES}")

    manifest = load_manifest(work_dir)
    jobs = manifest["jobs"]
    if row_index < 0 or row_index >= len(jobs):
        raise ValueError(f"row_index {row_index} out of range [0, {len(jobs)})")

    job = jobs[row_index]
    job["status"] = status
    job["updated_at"] = datetime.now(timezone.utc).isoformat()
    if output_path is not None:
        job["output_path"] = output_path
    if error is not None:
        job["error"] = error

    save_manifest(work_dir, manifest)
    return manifest


def get_status_summary(manifest: dict) -> dict[str, int]:
    """Return counts per status."""
    counts: dict[str, int] = {s: 0 for s in VALID_STATUSES}
    for job in manifest["jobs"]:
        s = job["status"]
        counts[s] = counts.get(s, 0) + 1
    return counts


def list_pending_rows(manifest: dict) -> list[dict]:
    """Return jobs that are pending or failed (need work)."""
    return [j for j in manifest["jobs"] if j["status"] in ("pending", "failed")]


# ---------------------------------------------------------------------------
# CLI subcommands
# ---------------------------------------------------------------------------
def cmd_init(args: argparse.Namespace) -> int:
    """init subcommand: create manifest from preset."""
    try:
        manifest = init_manifest(args.preset, Path(args.output_dir))
    except ValueError as e:
        logger.error("%s", e)
        return 1
    summary = get_status_summary(manifest)
    print(json.dumps({"action": "init", "preset": args.preset, "summary": summary}, indent=2))
    return 0


def cmd_status(args: argparse.Namespace) -> int:
    """status subcommand: print summary."""
    try:
        manifest = load_manifest(Path(args.work_dir))
    except FileNotFoundError as e:
        logger.error("%s", e)
        return 1
    summary = get_status_summary(manifest)
    print(json.dumps({"preset": manifest["preset"], "summary": summary}, indent=2))
    return 0


def cmd_mark(args: argparse.Namespace) -> int:
    """mark subcommand: update row status."""
    try:
        manifest = mark_row(
            Path(args.work_dir),
            args.row,
            args.status,
            output_path=args.output_path,
            error=args.error,
        )
    except (FileNotFoundError, ValueError) as e:
        logger.error("%s", e)
        return 1
    job = manifest["jobs"][args.row]
    print(json.dumps({"action": "mark", "row": args.row, "status": job["status"]}, indent=2))
    return 0


def cmd_list_pending(args: argparse.Namespace) -> int:
    """list-pending subcommand: rows needing work."""
    try:
        manifest = load_manifest(Path(args.work_dir))
    except FileNotFoundError as e:
        logger.error("%s", e)
        return 1
    pending = list_pending_rows(manifest)
    print(
        json.dumps(
            {"pending_count": len(pending), "rows": [{"row": j["row_index"], "state": j["state"]} for j in pending]},
            indent=2,
        )
    )
    return 0


def build_parser() -> argparse.ArgumentParser:
    """Build the CLI parser."""
    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
    sub = parser.add_subparsers(dest="cmd", required=True)

    init_p = sub.add_parser("init", help="Create manifest from preset")
    init_p.add_argument("--preset", required=True, choices=["fighter", "rpg-character", "platformer", "pet"])
    init_p.add_argument("--output-dir", required=True, help="Work directory to write row-jobs.json")
    init_p.set_defaults(func=cmd_init)

    status_p = sub.add_parser("status", help="Print status summary")
    status_p.add_argument("--work-dir", required=True, help="Work directory containing row-jobs.json")
    status_p.set_defaults(func=cmd_status)

    mark_p = sub.add_parser("mark", help="Update a row's status")
    mark_p.add_argument("--work-dir", required=True, help="Work directory containing row-jobs.json")
    mark_p.add_argument("--row", type=int, required=True, help="Zero-based row index")
    mark_p.add_argument("--status", required=True, choices=list(VALID_STATUSES))
    mark_p.add_argument("--output-path", help="Path to output strip (set on done)")
    mark_p.add_argument("--error", help="Error message (set on failed)")
    mark_p.set_defaults(func=cmd_mark)

    lp = sub.add_parser("list-pending", help="List rows needing work")
    lp.add_argument("--work-dir", required=True, help="Work directory containing row-jobs.json")
    lp.set_defaults(func=cmd_list_pending)

    return parser


def main(argv: list[str] | None = None) -> int:
    """CLI entry point."""
    if not logging.getLogger().handlers:
        logging.basicConfig(
            level=logging.INFO,
            format="[%(name)s] %(levelname)s: %(message)s",
            stream=sys.stderr,
        )
    parser = build_parser()
    args = parser.parse_args(argv)
    return args.func(args)


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