scaffold-unity

Lumina — Scaffold Unity

Prepare a Unity project so Lumina can drive it. Unity projects must be created by the Unity Editor/Hub itself (the binary layout isn't ours to fabricate), so this skill verifies, wires, and standardizes rather than inventing a project from nothing.

Project path (default = current directory): $ARGUMENTS

Steps

1. Locate or create the project.

   • Check for an existing Unity project: look for ProjectSettings/ProjectVersion.txt and an Assets/ folder (use Glob).
   • If none exists, instruct the user to create one via Unity Hub (recommend a current LTS, e.g. Unity 6 LTS) with the appropriate 2D/3D template, OR if Unity.exe/unity CLI is available, create it headlessly: Unity -batchmode -quit -createProject "<path>" (then confirm the version).
   • Detect and record the Unity version from ProjectSettings/ProjectVersion.txt — later skills and the engine MCP need it (version drift is a known risk).

2. Standardize folders. Ensure these exist under Assets/: Scripts/, Models/, Textures/, Audio/, Prefabs/, Scenes/, Materials/. Create any missing ones with Write (an empty .gitkeep is fine).

3. Install version control hygiene. Copy the bundled templates into the project root if absent:

   • .gitignore ← ${CLAUDE_PLUGIN_ROOT}/templates/unity/gitignore.txt
   • .gitattributes (Git LFS for *.glb *.fbx *.png *.wav *.mp3 *.tga *.psd) ← ${CLAUDE_PLUGIN_ROOT}/templates/unity/gitattributes.txt Run git lfs install if git-lfs is present; warn (don't fail) if it isn't.

4. Wire the unity-mcp bridge. The engine MCP (CoplayDev/unity-mcp) needs its companion Unity package installed in the project so the Editor exposes the control endpoint. Add it via Packages/manifest.json (git URL) or the package's documented install, then tell the user to open the project in the Unity Editor — the MCP only connects while the Editor is running.

5. Verify the bridge. Once the Editor is open, confirm mcp__unity responds (e.g. a ping / list-scenes call). If it doesn't, point the user at the doctor output from the SessionStart hook.

Report: project path, detected Unity version, folders ensured, VCS files added, and whether the engine MCP connected.