Add comprehensive MCP setup, operations guide, and auto-setup scripts

[Ryan-focus]

Summary

This PR transforms the Unity + Claude Code skill from a setup-only guide into a complete AI development assistant. It adds one-click MCP configuration scripts, a detailed operations reference with code templates, auto-diagnosis capabilities, and rapid prototyping workflows.

Key Changes

• New auto-setup scripts (auto_setup.sh and auto_setup.ps1):

  • One-command MCP configuration for both Unity Official MCP (Path A) and Coplay MCP (Path B)
  • Auto-detection of best MCP path based on system state
  • Support for --force flag to reset existing configurations
  • Comprehensive prerequisite checking (Claude Code, Python 3.11+, uvx, relay binary)
  • Clear error messages with remediation steps

• New unity_operations.md:

  • Complete MCP tool reference with availability matrix for both paths
  • Scene management workflows (create, list, save scenes)
  • GameObject operations (primitives, hierarchies, components, transforms)
  • Script development templates (PlayerController, GameManager, HealthBarUI, etc.)
  • Materials and visuals setup
  • Asset management and folder structure creation
  • Debugging and diagnostics patterns
  • Build configuration and execution
  • Rapid prototyping workflows (3D games, 2D platformers, UI menus)

• Expanded SKILL.md:

  • Reorganized into 4 main sections: Quick Setup, Manual Setup, Auto-Diagnosis, and Unity Operations
  • Added auto-setup script usage with examples
  • Integrated auto-diagnosis flowchart for troubleshooting connection issues
  • Added key principles for using MCP tools effectively
  • Included common operation patterns (scene management, GameObjects, scripts, materials, assets, debugging)
  • Linked to unity_operations.md for detailed reference

• Updated README.md:

  • Clarified skill purpose as a complete AI development assistant
  • Added feature table highlighting one-click setup, auto-diagnosis, and operations
  • Updated repo structure to reflect new files
  • Simplified installation instructions

Notable Implementation Details

• Path auto-detection: Scripts check for Unity relay binary presence to determine whether to use Path A (Unity Official) or Path B (Coplay)
• Timeout configuration: Coplay MCP timeout is configurable via --timeout flag (default 720000ms)
• Cross-platform support: Separate bash and PowerShell scripts with platform-specific relay binary paths
• Graceful error handling: All scripts provide actionable error messages and next steps
• Comprehensive templates: C# code examples cover common patterns (movement, singletons, UI, prefabs, materials)
• Tool availability matrix: unity_operations.md maps operations to specific tool names for both MCP implementations

https://claude.ai/code/session_01GKpTXt4npDjviK7mRzJY5A