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

references/rive-skeletal-animator.md

View on GitHub
# Rive Skeletal Animation

Rive skeletal animation for React apps: `@rive-app/react-canvas` runtime integration, Rive Editor rigging and animation workflows, state machine design for game characters, and performance budgets for 60fps mobile targets. Primary context: the Road to AEW wrestling game (React 19, Vite 7, Zustand, CombatEngine event dispatch), replacing Framer Motion sprite animations with Rive skeletal characters.

Not for: GPU particle and WebGL combat rendering (`pixijs-combat-renderer.md`); CSS or Framer Motion effects (`combat-effects-upgrade.md`); 2D sprite-sheet generation pipelines (Sprite mode in this skill); 3D scene animation (`frontend` skill, THREEJS mode).

Domains:
- **Rive Runtime API**: `useRive` hook, `useStateMachineInput`, `RiveComponent`, `.riv` file loading, async instance lifecycle
- **State Machine Design**: Boolean/Number/Trigger inputs, layer blending, transition conditions, default states, animation layering for combat
- **Character Rigging**: Bone hierarchies for bipedal wrestlers, vertex weighting at joints, mesh deformation for organic motion, IK constraints
- **Art Pipeline**: Sprite decomposition → Rive Editor rigging → animation → `.riv` export, file size targeting under 100KB per character
- **React 19 Integration**: Canvas mounting, Zustand store → Rive input bridging, CombatEngine event → animation trigger wiring
- **Performance**: 60fps mobile target, WebGL context limits, canvas size budgets, lazy runtime loading

## Phases

### ASSESS
- Read CLAUDE.md and any existing combat component files before touching anything, because project conventions override these defaults
- Identify current animation approach: which components use Framer Motion, what animation variants exist, what CombatEngine events are dispatched
- Confirm React version (19 assumed; patterns differ for 18), Vite config for WASM/asset loading, Zustand store shape
- Check `package.json` for `@rive-app/react-canvas`; if absent, install before any integration work

### PIPELINE
Load `rive-skeletal-animator/rive-character-pipeline.md` when the task involves art creation, rigging, or `.riv` export.

- Decompose sprite into separate body part layers before importing to Rive Editor
- Build bone hierarchy: Root → Spine → Chest → Shoulders → (Upper/Lower Arms, Hands) + (Upper/Lower Legs, Feet) + Head/Neck
- Weight vertices at joint areas with blended influence (50/50 at elbows, knees)
- Build animation clips for the standard wrestling animation set (see `rive-skeletal-animator/rive-animation-library.md`)
- Export `.riv` and place in `src/assets/characters/`; keep under 100KB per file

### INTEGRATE
Load `rive-skeletal-animator/rive-react-setup.md` when the task involves mounting Rive in React, wiring Zustand, or handling CombatEngine events.

- Replace `<img>` sprite + `<motion.div>` wrapper with `<RiveComponent>`; do not coexist, do not wrap Rive in Framer Motion
- Mount canvas at the same pixel dimensions as the original sprite (400×400 for PlayerCharacter, 900px for EnemyCharacter)
- Connect Zustand combat state to Rive inputs via `useStateMachineInput`; state changes drive inputs, not imperative calls scattered across components
- Wire CombatEngine events to trigger inputs (attacks, hits, blocks) and boolean inputs (isBlocking, isStunned)
- Lazy-load the Rive runtime: only load `@rive-app/react-canvas` when the combat screen mounts, because the WASM bundle is ~150KB

### ANIMATE
Load `rive-skeletal-animator/rive-animation-library.md` when building or debugging animations, state machine transitions, or timing sync.

- Default state machine entry: `idle` loop
- Attack sequence: `attack_windup` → `attack_strike` → `attack_recover` → back to `idle`
- Hit response: `hit_react` trigger interrupts current state, returns to `idle` after 0.4s
- Block: boolean input `isBlocking` drives guard pose hold
- Animation durations must match CombatEngine timing: if the engine expects a 0.2s strike window, the `attack_strike` clip is 0.2s exactly

### VALIDATE
- Verify 60fps at target canvas size on mobile viewport (375px wide baseline)
- Check `.riv` file size; flag if over 100KB per character
- Confirm state machine has no dead-end states (every state has a path back to idle)
- Run `tsc --noEmit` after integration: no implicit `any`, all Rive hook return types used correctly
- Test all CombatEngine event paths trigger their corresponding animations
- Remove old Framer Motion imports from migrated components; they should not coexist

## Reference loading table

| Signal | Load |
|--------|------|
| Installing Rive, mounting canvas, useRive hook, useStateMachineInput, Zustand wiring, CombatEngine events, lazy loading, Vite config | `rive-skeletal-animator/rive-react-setup.md` |
| Sprite decomposition, Rive Editor rigging, bone hierarchy, vertex weighting, exporting .riv files | `rive-skeletal-animator/rive-character-pipeline.md` |
| Animation set design, state machine inputs, clip durations, idle/attack/hit/block animations, timing sync | `rive-skeletal-animator/rive-animation-library.md` |
| Choosing between Rive and Spine2D, bundle size tradeoffs, React runtime comparison, editor cost | `rive-skeletal-animator/rive-vs-spine-decision.md` |
| 60fps drops, WebGL context limits, canvas size, lazy loading WASM, Framer Motion wrapping, SharedRenderer | `rive-skeletal-animator/rive-performance.md` |
| rive instance null errors, onLoad vs useEffect, onStateChange, setTimeout sequencing, Zustand bridging | `rive-skeletal-animator/rive-async-patterns.md` |

## Key files (Road to AEW)

| File | Purpose |
|------|---------|
| `src/components/PlayerCharacter.tsx` | Current 400×400 sprite with Framer Motion idle bob and hit react |
| `src/components/EnemyCharacter.tsx` | Current 900px sprite with same animation patterns |
| `src/stores/combatStore.ts` | Zustand store: source of truth for combat state that drives Rive inputs |
| `src/engine/CombatEngine.ts` | Dispatches attack/block/hit events; wire to Rive trigger inputs here |
| `src/assets/characters/` | Target location for `.riv` character files |

## Related references

| Need | Load |
|------|------|
| TypeScript frontend architecture: type-safe components, state management, build optimization | `skills/frontend/frontend/references/typescript-frontend.md` |
| UI/UX design: design systems, responsive layouts, accessibility, animations | `skills/frontend/frontend/references/ui-design.md` |
| PixiJS v8 2D WebGL combat rendering: @pixi/react hybrid canvas, normal maps, GPU particles, post-processing | `pixijs-combat-renderer.md` |

## Error handling

**useRive returns null canvas**: The Rive instance loads asynchronously; guard with `if (!rive)` before accessing state machine inputs. Never fire inputs on a null rive instance.

**State machine input not found**: `useStateMachineInput` returns `null` if the input name doesn't match the `.riv` file exactly. Log the mismatch and check the Rive Editor for the exact string; names are case-sensitive.

**WASM load failure in Vite**: Add `?url` suffix to the WASM import or configure `vite.config.ts` with `assetsInclude: ['**/*.wasm']`. Load `rive-skeletal-animator/rive-react-setup.md` for the full Vite config pattern.

**Canvas size mismatch**: `RiveComponent` fills its container. Set explicit width/height on the wrapping div, not on `RiveComponent` directly.

**60fps drop on mobile**: Canvas at 900px is expensive. Load `rive-skeletal-animator/rive-react-setup.md` for the WebGL context sharing pattern and canvas downscale strategy.

**Animation duration drift**: If the combat engine dispatches the next event before animation completes, load `rive-skeletal-animator/rive-animation-library.md` for the timing sync table and the `onStateChange` callback pattern.
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