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/combat-effects-upgrade.md

View on GitHub
# Combat Effects Upgrade

Zero-dependency combat visual upgrades for card game UIs: CSS particle replacement, Framer Motion combat juice, CSS 3D card transforms.

Not for: WebGL or GPU-particle combat rendering (`pixijs-combat-renderer.md`); skeletal or character animation rigs (`rive-skeletal-animator.md`); general design-system, layout, or accessibility work (`skills/frontend/frontend/references/ui-design.md`).

Upgrade combat visual effects in card game UIs without adding dependencies. The game's `effects.ts` already creates and destroys DOM elements for every single particle — the core problem is GC pressure and layout thrashing from 13 functions all doing `createElement → appendChild → setTimeout → remove`. The upgrade replaces that pattern with a pre-allocated element pool, GPU-composited CSS `@keyframes`, enhanced Framer Motion spring physics, and CSS 3D card transforms.

Domains:
- **CSS @keyframes performance**: GPU-composited properties only — `translateX/Y/Z`, `scale`, `opacity`, `rotate`. Anything else (width, height, top, left, margin) triggers layout reflow on every frame, killing 60fps.
- **DOM element pooling**: Pre-allocate N elements at mount, toggle CSS classes to activate, auto-return via `animationend`. Zero createElement/removeChild per effect.
- **Framer Motion 12 (now Motion)**: `useSpring`, `useMotionValue`, layout animations with `layoutId`, orchestrated stagger via `staggerChildren`, spring physics tuning with `stiffness`/`damping`/`mass`. Import path is `motion/react`.
- **CSS 3D card transforms**: `perspective` on container, `transform-style: preserve-3d` on card, `rotateX/Y` driven by mouse position delta, `backface-visibility: hidden` for flip reveals.
- **Framer Motion + CSS 3D integration**: `style={{ rotateX, rotateY }}` with `useMotionValue` + `useSpring` for smooth tilt follow without triggering React re-renders.

Standards (each directly affects performance):
- Pool elements at component mount, never inside effect functions — because createElement is expensive inside animation callbacks
- Animate only `transform` and `opacity` — because these skip layout and paint, going straight to composite
- Use `will-change: transform` only on elements currently animating — because overuse creates GPU layers that consume VRAM
- `animationend` event to return pool elements — because it's synchronous cleanup with no timer drift
- `useSpring` over `useAnimation` for physics — because spring physics automatically handle interruption mid-animation

Priorities when upgrading effects:
1. **60fps target** — DevTools flame chart should show no layout-triggering properties in animation frames
2. **Pool before style** — element pool eliminates GC churn before any visual improvement
3. **Progressive enhancement** — upgrade one effect type at a time, verify no regressions
4. **Framer Motion orchestration** — card trajectories and multi-hit stagger happen at the Motion layer, particles happen at the CSS layer

## Workflow

### Phase 1: AUDIT
Read `effects.ts`, catalog all 12 effect functions. For each, record: particle count, stagger interval, removal timeout, DOM position used (body vs container). Identify which functions share similar patterns (burst vs float vs single-element).

```bash
# Count DOM manipulation patterns in effects.ts
grep -n "createElement\|appendChild\|setTimeout.*remove\|\.remove()" src/effects.ts
```

### Phase 2: POOL
Replace `createElement + setTimeout(remove)` with a pre-allocated pool + CSS class toggling — because creating/destroying DOM nodes per effect causes GC pressure and forces the browser to recalculate layout on every particle.

Pool sizing rules:
- `createConfetti`: pool of 24 (20 + buffer)
- `createGoldBurst`: pool of 16 (max 15 + buffer)
- `createImpactBurst`: pool of 8 (5 + buffer)
- `createFinisherEffect`: pool of 16 (12 + buffer)
- `createRaritySparkle`: pool of 16 (max 12 + buffer)
- Single-element effects (damage/block/floating/heal/draw/buff/debuff): pool of 4 each

See [css-particle-migration.md](combat-effects-upgrade/css-particle-migration.md) for the full `ParticlePool` class and acquire/release pattern.

### Phase 3: ANIMATE
Replace inline `Object.assign(el.style, {...})` with CSS class assignment. Each particle type gets a `@keyframes` definition and a trigger class. GPU-composited transforms only.

Keyframe classes to implement:
- `.particle-impact` — radial burst (replaces `createImpactBurst`)
- `.particle-confetti` — upward toss + gravity fall (replaces `createConfetti`)
- `.particle-gold` — upward arc + fade (replaces `createGoldBurst`)
- `.particle-sparkle` — grow + rotate + fade (replaces `createRaritySparkle`)
- `.particle-heal` — float up + expand + fade green (replaces `createHealEffect`)
- `.particle-finisher` — explosive outward + rotate + fade gold (replaces `createFinisherEffect`)
- `.particle-damage` — float up + fade (replaces `showDamageNumber`, `showBlockNumber`, `showFloatingText`)

See [css-particle-migration.md](combat-effects-upgrade/css-particle-migration.md) for complete `@keyframes` definitions with timing presets.

### Phase 4: JUICE
Upgrade Framer Motion patterns across combat components — because CSS handles particles but card physics and multi-hit orchestration belong in the Motion layer.

Upgrades per component:
- `CardHand.tsx`: layout animation with `layoutId` for hand reflow when card is played
- `FramedCard.tsx`: spring trajectory arc on card play, jiggle on status badge value change
- `PlayerCharacter.tsx` / `EnemyCharacter.tsx`: spring overshoot on hit react, rotation wobble
- `CombatPopups.tsx`: cascading multi-hit stagger (100ms between hits)

See [framer-motion-combat-juice.md](combat-effects-upgrade/framer-motion-combat-juice.md) for Framer Motion 12 code patterns.

### Phase 5: TRANSFORM
Add CSS 3D card tilt to `FramedCard.tsx` using mouse position → rotateX/Y formula, integrated with Framer Motion's `useMotionValue` + `useSpring`.

```
rotateY = (mouseX - cardCenterX) / cardWidth * MAX_TILT_DEG
rotateX = -(mouseY - cardCenterY) / cardHeight * MAX_TILT_DEG
```

`MAX_TILT_DEG` = 15. `perspective: 1000px` on the container. `transform-style: preserve-3d` on the card. Mobile: disable on touch devices via `window.matchMedia('(hover: none)')`.

See [css-3d-card-transforms.md](combat-effects-upgrade/css-3d-card-transforms.md) for complete component implementation.

### Phase 6: VALIDATE
Measure with Chrome DevTools Performance tab.

```bash
# Check for layout-triggering properties in animation code
grep -n "\.style\.\(width\|height\|top\|left\|margin\|padding\|border\)" src/effects.ts
grep -n "offsetWidth\|offsetHeight\|getBoundingClientRect\|scrollTop" src/effects.ts
```

Target metrics:
- 60fps during heavy effects (finisher, confetti burst)
- No layout-triggering properties in animation frames
- `will-change: transform` present only on actively animating elements
- No GC spikes visible in memory timeline during rapid combat

## Reference Loading Table

| Task | Load This Reference |
|------|-------------------|
| DOM pool implementation, `@keyframes` CSS, pool class TypeScript | [css-particle-migration.md](combat-effects-upgrade/css-particle-migration.md) |
| Framer Motion 12 spring physics, stagger, layout animations | [framer-motion-combat-juice.md](combat-effects-upgrade/framer-motion-combat-juice.md) |
| CSS 3D card tilt, backface-visibility, Framer Motion integration | [css-3d-card-transforms.md](combat-effects-upgrade/css-3d-card-transforms.md) |

## Key Files Reference

| File | Role |
|------|------|
| `src/effects.ts` | 458 lines — all 12 particle effect functions, primary migration target |
| `src/components/CombatArena.tsx` | Arena background, vignette, atmospheric lights |
| `src/components/PlayerCharacter.tsx` | 400x400 sprite, idle bob, hit react, status badges |
| `src/components/EnemyCharacter.tsx` | 900px sprite, intent display |
| `src/components/CardHand.tsx` | 3D perspective fan layout, card hand management |
| `src/components/FramedCard.tsx` | Card component with rarity glow — primary 3D transform target |
| `src/components/CombatPopups.tsx` | Popup overlays, damage numbers, multi-hit stagger |

## 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

### Animation jank after pool migration
**Cause**: Pool element has stale `transform` or `opacity` from previous animation because CSS reset wasn't applied before re-acquiring.
**Solution**: In `acquireParticle()`, always set `el.style.transform = ''` and `el.style.opacity = ''` before applying the new CSS class. The `@keyframes` `from` state sets initial values explicitly.

### Cards skip spring physics on play
**Cause**: Framer Motion's `exit` animation fires but the `layoutId` target doesn't exist in the DOM yet, so Motion skips the trajectory.
**Solution**: Mount the target element before triggering the card play animation. Use `AnimatePresence mode="popLayout"` so exiting cards don't block layout measurement.

### `useSpring` tilt causes re-render loop
**Cause**: Passing `useSpring` values directly as component props instead of using Framer Motion's `style` prop — the former triggers React reconciliation on every frame.
**Solution**: Always drive tilt via `<motion.div style={{ rotateX, rotateY }}>` where `rotateX`/`rotateY` are `MotionValue` instances. Never read `.get()` inside render.

### `will-change: transform` causing VRAM pressure on mobile
**Cause**: Applied statically to all cards in the hand at all times.
**Solution**: Apply `will-change: transform` only via JavaScript when hover/animation starts, remove it on `animationend` or `mouseleave`.

## Patterns to Detect and Fix

### Creating DOM elements inside effect functions
**What it looks like**: `const el = document.createElement('div')` inside `createImpactBurst()`
**Why wrong**: 5 `createElement` calls per hit, 8 hits per second = 40 new elements/second; GC pauses visible as frame drops
**Do instead**: Acquire from pre-allocated pool via `impactPool.acquire()`, return on `animationend`

### Animating `top`/`left` for particle movement
**What it looks like**: `el.style.top = startY + 'px'` then transitioning to new value
**Why wrong**: `top`/`left` changes trigger layout reflow on every animation frame
**Do instead**: Use `transform: translateY(Npx)` — same visual result, skips layout and paint entirely

### Reading layout properties mid-animation
**What it looks like**: `el.getBoundingClientRect()` inside a `requestAnimationFrame` callback while particles are flying
**Why wrong**: Forces synchronous layout, stalls the compositor, causes jank on the same frame
**Do instead**: Measure positions once before animation starts, cache values, use cached coordinates in `@keyframes` `from`/`to`

### `useMotionValue` without `useSpring` for card tilt
**What it looks like**: `rotateY.set(calculatedAngle)` directly on `mousemove`
**Why wrong**: Instant value updates with no easing — tilt snaps rather than follows, feels mechanical
**Do instead**: Feed raw mouse values into `useSpring({ stiffness: 300, damping: 30 })` so tilt smoothly chases the cursor

## Anti-Rationalization

| Rationalization | Why Wrong | Required Action |
|----------------|-----------|-----------------|
| "The current createElement approach works fine" | It works until 3+ effects fire simultaneously — then GC pauses cause visible frame drops | Pool all effects before shipping any visual improvements |
| "I'll add `will-change: transform` to everything for safety" | Each `will-change` layer costs VRAM; 10+ simultaneous layers degrades mobile GPUs | Apply only during active animation, remove on `animationend` |
| "Spring physics are just cosmetic, I'll skip them" | Springs handle interruption — without them, interrupted animations snap, which is jarring during rapid combat | Use `useSpring` for all physics-feeling motion |
| "CSS 3D tilt is fine on mobile" | 3D transforms + `preserve-3d` have higher GPU cost on mobile and touch interaction makes tilt redundant | Detect `(hover: none)` and disable tilt on touch devices |

## Blocker Criteria

Resolve routine issues from repository evidence and existing authorization. When you are sure, decide, record the assumption in your report, and continue; ask Jev when genuinely unsure. Ask only when these situations leave a material decision uncovered:

| Situation | Why Stop | Ask This |
|-----------|----------|----------|
| effects.ts has been refactored since description | Pool sizing and class names will be wrong | "Has effects.ts changed from the 458-line 12-function version? Can I read it first?" |
| Game uses React 18 vs 19 | `forwardRef` vs ref-as-prop pattern differs | "Which React version is this project on?" |
| Framer Motion import path is `framer-motion` not `motion/react` | Project is on pre-rename version — API surface is the same but import path differs | "Is this project on `framer-motion` or the renamed `motion` package?" |
| Combat runs in a WebGL canvas | DOM particle pool is irrelevant for canvas-based combat | "Is the combat UI DOM-based or canvas/WebGL?" |
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