# Unity Asset Guide

> Use when writing Unity package code (FEEL, SOAP, DOTween), debugging package-related issues, or checking best practices before implementation.

- Skill: `wanghaisheng/unity-asset-guide` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add wanghaisheng/unity-asset-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wanghaisheng/unity-asset-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wanghaisheng (https://skillmd.com/u/wanghaisheng)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wanghaisheng/unity-asset-guide

---


# Unity Assets Guidelines

Best practices and pitfalls for Unity packages used in this project.

## Available Packages

| Package | Description | Status |
|---------|-------------|--------|
| soap | Scriptable Object Architecture | ✅ |
| feel | MMFeedbacks feedback system | ✅ |
| dotween | Tween animation | 🚧 Coming soon |

## Instructions

If argument provided (`$ARGUMENTS`):
1. Read `./docs/$ARGUMENTS/patterns.md` for usage patterns
2. Read `./docs/$ARGUMENTS/pitfalls.md` for checklist and troubleshooting
3. If debugging specific issue, check detailed files in `./docs/$ARGUMENTS/pitfalls/`

If no argument provided:
- Display available packages list above

---

## SOAP (Scriptable Object Architecture)

### Overview
SOAP provides a robust architecture for managing game data through ScriptableObjects, enabling data-driven design and runtime configuration.

### Usage Patterns
- Data containers for game configuration
- Runtime state management
- Event systems and messaging
- Asset references and management

### Common Pitfalls
- Memory leaks from circular references
- Serialization issues with complex data types
- Performance considerations for large datasets

---

## FEEL (MMFeedbacks Feedback System)

### Overview
FEEL provides a comprehensive feedback system for creating responsive game feel through visual, audio, and haptic feedback.

### Usage Patterns
- Impact feedback and screen shake
- UI feedback animations
- Particle system integration
- Audio feedback coordination

### Common Pitfalls
- Performance impact from excessive feedback
- Timing synchronization issues
- Platform-specific feedback differences

---

## DOTween (Tween Animation)

### Overview
DOTween provides high-performance tweening animations for smooth object transformations and UI animations.

### Usage Patterns
- Object movement and rotation
- UI element transitions
- Color and material animations
- Sequenced animation chains

### Common Pitfalls
- Memory management for ongoing tweens
- Performance optimization for batch animations
- Timing and sequencing conflicts

---

*Unity Asset Guidelines*
*Version: 1.0.0*
*Last updated: 2026-03-10*
*Integration: Claude Code Game Studios*