agent-skill-kit 3.9.135

package/.agent/skills/game-development/SKILL.md

@@ -0,0 +1,178 @@
+---
+name: game-development
+description: >-
+  Game development orchestrator: game loop, physics, AI, collision, and platform-specific routing.
+  Use when building 2D/3D games, game mechanics, or game-specific performance optimization.
+  NOT for web applications (use react-pro) or general performance (use perf-optimizer).
+category: game-development-subskill
+triggers: ["game", "game development", "Unity", "Godot", "Phaser", "game engine"]
+coordinates_with: ["perf-optimizer", "mobile-developer", "shader"]
+success_metrics: ["100% correct sub-skill routing", "<5ms routing latency"]
+metadata:
+  author: pikakit
+  version: "3.9.134"
+---
+
+# Game Development — Orchestrator
+
+> Route to right sub-skill. Fixed timestep. 16.67ms budget. Input abstraction.
+
+---
+
+## Prerequisites
+
+**Required:** None — Game Development is a routing and principles skill.
+
+---
+
+## When to Use
+
+| Situation | Action |
+|-----------|--------|
+| Starting a game project | Route by platform + dimension below |
+| Need game loop architecture | Read game loop section |
+| Performance questions | Read performance budget section |
+| Architecture review | Read `rules/engineering-spec.md` |
+
+---
+
+## System Boundaries
+
+| Owned by This Skill | NOT Owned |
+|---------------------|-----------|
+| Sub-skill routing (10 sub-skills) | Platform-specific code (→ sub-skills) |
+| Game loop pattern (INPUT→UPDATE→RENDER) | Engine configuration |
+| Performance budget (16.67ms at 60 FPS) | Profiling tools (→ perf-optimizer) |
+| Pattern selection (6 patterns) | Shader code (→ shader) |
+| AI type selection (4 types) | Mobile builds (→ mobile-developer) |
+
+**Orchestrator skill:** Routes to sub-skills. Does NOT invoke them automatically.
+
+---
+
+## Sub-Skill Routing
+
+### By Platform
+
+| Platform | Sub-Skill |
+|----------|-----------|
+| Web (HTML5, WebGL) | `game-development/web-games` |
+| Mobile (iOS, Android) | `game-development/mobile-games` |
+| PC (Steam, Desktop) | `game-development/pc-games` |
+| VR/AR headsets | `game-development/vr-ar` |
+
+### By Dimension
+
+| Dimension | Sub-Skill |
+|-----------|-----------|
+| 2D (sprites, tilemaps) | `game-development/2d-games` |
+| 3D (meshes, shaders) | `game-development/3d-games` |
+
+### By Specialty
+
+| Specialty | Sub-Skill |
+|-----------|-----------|
+| GDD, balancing, psychology | `game-development/game-design` |
+| Multiplayer networking | `game-development/multiplayer` |
+| Visual style, assets, animation | `game-development/game-art` |
+| Sound design, music, adaptive audio | `game-development/game-audio` |
+
+---
+
+## Game Loop (Universal)
+
+```
+INPUT  → Read player actions
+UPDATE → Process game logic (fixed timestep: 50Hz)
+RENDER → Draw the frame (interpolated)
+```
+
+**Fixed timestep mandatory.** Physics at 50Hz. Render interpolated. No variable delta for physics.
+
+---
+
+## Performance Budget (60 FPS = 16.67ms)
+
+| System | Budget |
+|--------|--------|
+| Input | 1 ms |
+| Physics | 3 ms |
+| AI | 2 ms |
+| Game Logic | 4 ms |
+| Rendering | 5 ms |
+| Buffer | 1.67 ms |
+
+---
+
+## Pattern Selection
+
+| Pattern | Use When |
+|---------|----------|
+| **State Machine** | 3-5 discrete states (DEFAULT — start here) |
+| **Object Pooling** | Frequent spawn/destroy (bullets, particles) |
+| **Observer/Events** | Cross-system communication |
+| **ECS** | 1000+ similar entities (RTS units) |
+| **Command** | Undo, replay, networking |
+| **Behavior Tree** | Complex AI decisions |
+
+---
+
+## Error Taxonomy
+
+| Code | Recoverable | Trigger |
+|------|-------------|---------|
+| `ERR_INVALID_PLATFORM` | No | Platform not web/mobile/pc/vr-ar |
+| `ERR_INVALID_DIMENSION` | No | Dimension not 2d/3d |
+| `ERR_INVALID_FPS` | No | FPS target not 30/60/120 |
+| `ERR_SUBSKILL_NOT_FOUND` | No | Sub-skill directory missing |
+| `ERR_MISSING_CONTEXT` | Yes | Required field missing |
+
+**Zero internal retries.** Deterministic; same context = same routing.
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|---------|-------|
+| Update everything every frame | Use events, dirty flags |
+| Create objects in hot loops | Object pooling |
+| Use variable delta for physics | Fixed timestep (50Hz) |
+| Hardcode key bindings | Abstract input into actions |
+| Start with ECS | State Machine first; ECS for 1000+ entities |
+
+---
+
+## 📑 Content Map
+
+| File | Description | When to Read |
+|------|-------------|--------------|
+| [engineering-spec.md](rules/engineering-spec.md) | Full engineering spec | Architecture review |
+
+| Sub-Skill | Directory |
+|-----------|-----------|
+| Web Games | `game-development/web-games/` |
+| Mobile Games | `game-development/mobile-games/` |
+| PC Games | `game-development/pc-games/` |
+| VR/AR | `game-development/vr-ar/` |
+| 2D Games | `game-development/2d-games/` |
+| 3D Games | `game-development/3d-games/` |
+| Game Design | `game-development/game-design/` |
+| Multiplayer | `game-development/multiplayer/` |
+| Game Art | `game-development/game-art/` |
+| Game Audio | `game-development/game-audio/` |
+
+---
+
+## 🔗 Related
+
+| Item | Type | Purpose |
+|------|------|---------|
+| `/game` | Workflow | Game development workflow |
+| `mobile-developer` | Skill | Mobile game builds |
+| `perf-optimizer` | Skill | Game performance |
+| `shader` | Skill | GLSL shader programming |
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/game-development/game-art/SKILL.md

@@ -0,0 +1,207 @@
+---
+name: game-art
+description: Game art principles. Visual style selection, asset pipeline, animation workflow.
+category: game-development-subskill
+triggers: ["game art", "art style", "asset pipeline", "animation workflow"]
+coordinates_with: ["game-development", "game-audio", "ai-artist"]
+success_metrics: ["100% assets follow style guide", "0 animation frame drops"]
+metadata:
+  author: pikakit
+  version: "3.9.134"
+---
+
+# Game Art Principles
+
+> Visual design thinking for games - style selection, asset pipelines, and art direction.
+
+---
+
+## 1. Art Style Selection
+
+### Decision Tree
+
+```
+What feeling should the game evoke?
+│
+├── Nostalgic / Retro
+│   ├── Limited palette? → Pixel Art
+│   └── Hand-drawn feel? → Vector / Flash style
+│
+├── Realistic / Immersive
+│   ├── High budget? → PBR 3D
+│   └── Stylized realism? → Hand-painted textures
+│
+├── Approachable / Casual
+│   ├── Clean shapes? → Flat / Minimalist
+│   └── Soft feel? → Gradient / Soft shadows
+│
+└── Unique / Experimental
+    └── Define custom style guide
+```
+
+### Style Comparison Matrix
+
+| Style | Production Speed | Skill Floor | Scalability | Best For |
+|-------|------------------|-------------|-------------|----------|
+| **Pixel Art** | Medium | Medium | Hard to hire | Indie, retro |
+| **Vector/Flat** | Fast | Low | Easy | Mobile, casual |
+| **Hand-painted** | Slow | High | Medium | Fantasy, stylized |
+| **PBR 3D** | Slow | High | AAA pipeline | Realistic games |
+| **Low-poly** | Fast | Medium | Easy | Indie 3D |
+| **Cel-shaded** | Medium | Medium | Medium | Anime, cartoon |
+
+---
+
+## 2. Asset Pipeline Decisions
+
+### 2D Pipeline
+
+| Phase | Tool Options | Output |
+|-------|--------------|--------|
+| **Concept** | Paper, Procreate, Photoshop | Reference sheet |
+| **Creation** | Aseprite, Photoshop, Krita | Individual sprites |
+| **Atlas** | TexturePacker, Aseprite | Spritesheet |
+| **Animation** | Spine, DragonBones, Frame-by-frame | Animation data |
+| **Integration** | Engine import | Game-ready assets |
+
+### 3D Pipeline
+
+| Phase | Tool Options | Output |
+|-------|--------------|--------|
+| **Concept** | 2D art, Blockout | Reference |
+| **Modeling** | Blender, Maya, 3ds Max | High-poly mesh |
+| **Retopology** | Blender, ZBrush | Game-ready mesh |
+| **UV/Texturing** | Substance Painter, Blender | Texture maps |
+| **Rigging** | Blender, Maya | Skeletal rig |
+| **Animation** | Blender, Maya, Mixamo | Animation clips |
+| **Export** | FBX, glTF | Engine-ready |
+
+---
+
+## 3. Color Theory Decisions
+
+### Palette Selection
+
+| Goal | Strategy | Example |
+|------|----------|---------|
+| **Harmony** | Complementary or analogous | Nature games |
+| **Contrast** | High saturation differences | Action games |
+| **Mood** | Warm/cool temperature | Horror, cozy |
+| **Readability** | Value contrast over hue | Gameplay clarity |
+
+### Color Principles
+
+- **Hierarchy:** Important elements should pop
+- **Consistency:** Same object = same color family
+- **Context:** Colors read differently on backgrounds
+- **Accessibility:** Don't rely only on color
+
+---
+
+## 4. Animation Principles
+
+### The 12 Principles (Applied to Games)
+
+| Principle | Game Application |
+|-----------|------------------|
+| **Squash & Stretch** | Jump arcs, impacts |
+| **Anticipation** | Wind-up before attack |
+| **Staging** | Clear silhouettes |
+| **Follow-through** | Hair, capes after movement |
+| **Slow in/out** | Easing on transitions |
+| **Arcs** | Natural movement paths |
+| **Secondary Action** | Breathing, blinking |
+| **Timing** | Frame count = weight/speed |
+| **Exaggeration** | Readable from distance |
+| **Appeal** | Memorable design |
+
+### Frame Count Guidelines
+
+| Action Type | Typical Frames | Feel |
+|-------------|----------------|------|
+| Idle breathing | 4-8 | Subtle |
+| Walk cycle | 6-12 | Smooth |
+| Run cycle | 4-8 | Energetic |
+| Attack | 3-6 | Snappy |
+| Death | 8-16 | Dramatic |
+
+---
+
+## 5. Resolution & Scale Decisions
+
+### 2D Resolution by Platform
+
+| Platform | Base Resolution | Sprite Scale |
+|----------|-----------------|--------------|
+| Mobile | 1080p | 64-128px characters |
+| Desktop | 1080p-4K | 128-256px characters |
+| Pixel art | 320x180 to 640x360 | 16-32px characters |
+
+### Consistency Rule
+
+Choose a base unit and stick to it:
+- Pixel art: Work at 1x, scale up (never down)
+- HD art: Define DPI, maintain ratio
+- 3D: 1 unit = 1 meter (industry standard)
+
+---
+
+## 6. Asset Organization
+
+### Naming Convention
+
+```
+[type]_[object]_[variant]_[state].[ext]
+
+Examples:
+spr_player_idle_01.png
+tex_stone_wall_normal.png
+mesh_tree_oak_lod2.fbx
+```
+
+### Folder Structure Principle
+
+```
+assets/
+├── characters/
+│   ├── player/
+│   └── enemies/
+├── environment/
+│   ├── props/
+│   └── tiles/
+├── ui/
+├── effects/
+└── audio/
+```
+
+---
+
+## 7. Anti-Patterns
+
+| Don't | Do |
+|-------|-----|
+| Mix art styles randomly | Define and follow style guide |
+| Work at final resolution only | Create at source resolution |
+| Ignore silhouette readability | Test at gameplay distance |
+| Over-detail background | Focus detail on player area |
+| Skip color testing | Test on target display |
+
+---
+
+> **Remember:** Art serves gameplay. If it doesn't help the player, it's decoration.
+
+---
+
+## 🔗 Related
+
+| Item | Type | When to Read |
+|------|------|--------------|
+| [../SKILL.md](../SKILL.md) | Parent | Game loop and pattern selection |
+| `game-development/2d-games` | Sibling | Sprite and tilemap systems |
+| `game-development/3d-games` | Sibling | 3D rendering and LOD |
+| `game-development/game-audio` | Sibling | Audio to complement visuals |
+| `ai-artist` | Skill | AI-generated game assets |
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/game-development/game-audio/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: game-audio
+description: Game audio principles. Sound design, music integration, adaptive audio systems.
+category: game-development-subskill
+triggers: ["game audio", "sound design", "music integration", "adaptive audio"]
+coordinates_with: ["game-development", "game-art", "perf-optimizer"]
+success_metrics: ["100% sounds use proper categories", "0 audio memory leaks"]
+metadata:
+  author: pikakit
+  version: "3.9.134"
+---
+
+# Game Audio Principles
+
+> Sound design and music integration for immersive game experiences.
+
+---
+
+## 1. Audio Category System
+
+### Category Definitions
+
+| Category | Behavior | Examples |
+|----------|----------|----------|
+| **Music** | Looping, crossfade, ducking | BGM, combat music |
+| **SFX** | One-shot, 3D positioned | Footsteps, impacts |
+| **Ambient** | Looping, background layer | Wind, crowd, forest |
+| **UI** | Immediate, non-3D | Button clicks, notifications |
+| **Voice** | Priority, ducking trigger | Dialogue, announcer |
+
+### Priority Hierarchy
+
+```
+When sounds compete for channels:
+
+1. Voice (highest - always audible)
+2. Player SFX (feedback critical)
+3. Enemy SFX (gameplay important)
+4. Music (mood, but duckable)
+5. Ambient (lowest - can drop)
+```
+
+---
+
+## 2. Sound Design Decisions
+
+### SFX Creation Approach
+
+| Approach | When to Use | Trade-offs |
+|----------|-------------|------------|
+| **Recording** | Realistic needs | High quality, time intensive |
+| **Synthesis** | Sci-fi, retro, UI | Unique, requires skill |
+| **Library samples** | Fast production | Common sounds, licensing |
+| **Layering** | Complex sounds | Best results, more work |
+
+### Layering Structure
+
+| Layer | Purpose | Example: Gunshot |
+|-------|---------|------------------|
+| **Attack** | Initial transient | Click, snap |
+| **Body** | Main character | Boom, blast |
+| **Tail** | Decay, room | Reverb, echo |
+| **Sweetener** | Special sauce | Shell casing, mechanical |
+
+---
+
+## 3. Music Integration
+
+### Music State System
+
+```
+Game State → Music Response
+│
+├── Menu → Calm, loopable theme
+├── Exploration → Ambient, atmospheric
+├── Combat detected → Transition to tension
+├── Combat engaged → Full battle music
+├── Victory → Stinger + calm transition
+├── Defeat → Somber stinger
+└── Boss → Unique, multi-phase track
+```
+
+### Transition Techniques
+
+| Technique | Use When | Feel |
+|-----------|----------|------|
+| **Crossfade** | Smooth mood shift | Gradual |
+| **Stinger** | Immediate event | Dramatic |
+| **Stem mixing** | Dynamic intensity | Seamless |
+| **Beat-synced** | Rhythmic gameplay | Musical |
+| **Queue point** | Next natural break | Clean |
+
+---
+
+## 4. Adaptive Audio Decisions
+
+### Intensity Parameters
+
+| Parameter | Affects | Example |
+|-----------|---------|---------|
+| **Threat level** | Music intensity | Enemy count |
+| **Health** | Filter, reverb | Low health = muffled |
+| **Speed** | Tempo, energy | Racing speed |
+| **Environment** | Reverb, EQ | Cave vs outdoor |
+| **Time of day** | Mood, volume | Night = quieter |
+
+### Vertical vs Horizontal
+
+| System | What Changes | Best For |
+|--------|--------------|----------|
+| **Vertical (layers)** | Add/remove instrument layers | Intensity scaling |
+| **Horizontal (segments)** | Different music sections | State changes |
+| **Combined** | Both | AAA adaptive scores |
+
+---
+
+## 5. 3D Audio Decisions
+
+### Spatialization
+
+| Element | 3D Positioned? | Reason |
+|---------|----------------|--------|
+| Player footsteps | No (or subtle) | Always audible |
+| Enemy footsteps | Yes | Directional awareness |
+| Gunfire | Yes | Combat awareness |
+| Music | No | Mood, non-diegetic |
+| Ambient zone | Yes (area) | Environmental |
+| UI sounds | No | Interface feedback |
+
+### Distance Behavior
+
+| Distance | Sound Behavior |
+|----------|----------------|
+| **Near** | Full volume, full frequency |
+| **Medium** | Volume falloff, high-freq rolloff |
+| **Far** | Low volume, low-pass filter |
+| **Max** | Silent or ambient hint |
+
+---
+
+## 6. Platform Considerations
+
+### Format Selection
+
+| Platform | Recommended Format | Reason |
+|----------|-------------------|--------|
+| PC | OGG Vorbis, WAV | Quality, no licensing |
+| Console | Platform-specific | Certification |
+| Mobile | MP3, AAC | Size, compatibility |
+| Web | WebM/Opus, MP3 fallback | Browser support |
+
+### Memory Budget
+
+| Game Type | Audio Budget | Strategy |
+|-----------|--------------|----------|
+| Mobile casual | 10-50 MB | Compressed, fewer variants |
+| PC indie | 100-500 MB | Quality focus |
+| AAA | 1+ GB | Full quality, many variants |
+
+---
+
+## 7. Mix Hierarchy
+
+### Volume Balance Reference
+
+| Category | Relative Level | Notes |
+|----------|----------------|-------|
+| **Voice** | 0 dB (reference) | Always clear |
+| **Player SFX** | -3 to -6 dB | Prominent but not harsh |
+| **Music** | -6 to -12 dB | Foundation, ducks for voice |
+| **Enemy SFX** | -6 to -9 dB | Important but not dominant |
+| **Ambient** | -12 to -18 dB | Subtle background |
+
+### Ducking Rules
+
+| When | Duck What | Amount |
+|------|-----------|--------|
+| Voice plays | Music, Ambient | -6 to -9 dB |
+| Explosion | All except explosion | Brief duck |
+| Menu open | Gameplay audio | -3 to -6 dB |
+
+---
+
+## 8. Anti-Patterns
+
+| Don't | Do |
+|-------|-----|
+| Play same sound repeatedly | Use variations (3-5 per sound) |
+| Max volume everything | Use proper mix hierarchy |
+| Ignore silence | Silence creates contrast |
+| One music track loops forever | Provide variety, transitions |
+| Skip audio in prototype | Placeholder audio matters |
+
+---
+
+> **Remember:** 50% of the game experience is audio. A muted game loses half its soul.
+
+---
+
+## 🔗 Related
+
+| Item | Type | When to Read |
+|------|------|--------------|
+| [../SKILL.md](../SKILL.md) | Parent | Game loop and perf budget |
+| `game-development/game-art` | Sibling | Visual style to complement audio |
+| `game-development/game-design` | Sibling | Core loop feedback sounds |
+| `game-development/web-games` | Sibling | Browser audio constraints |
+
+---
+
+⚡ PikaKit v3.9.134