new-unity-project
An agent skill by Unity-Technologies, from Unity-Technologies/unity-agent-plugin. Tags: monorepo, planning, project-management, setup, workflow.
What it does
Use when starting a brand-new Unity game or project from scratch — "make/start/create a new game", "bootstrap a Unity project", "I want to build a [genre] game", "scaffold/prototype a game", game jam, greenfield, blank project, project setup. A guided flow that gathers the concept, target platforms, and monetization, installs the Editor in the background while it asks, then creates the project and source control and installs packages — delegating the mechanics to the unity-cli and unity-package-management skills and handing off monetization to the dedicated skills. Does not scaffold gameplay code.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add Unity-Technologies/unity-agent-plugin --skill new-unity-project
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/Unity-Technologies/unity-agent-plugin
cp -r unity-agent-plugin/skills/new-unity-project ~/.claude/skills/new-unity-project
Safety box score
Grade C, moderate risk: 40 of 100 risk points, rated 2026-10-17. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill is a guided Unity project bootstrapper: it installs the Editor and modules, creates a new project, sets up source control, installs packages, and applies an initial visual baseline. The main risks are networked installs, use of auth/license and VCS credentials, and the fact that it can create and commit a new repo as part of its normal flow.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 2 (moderate) | It directs the agent to run real shell/CLI actions such as `unity install lts --module ...`, `unity projects create ...`, `unity open ...`, and `git commit`, which is meaningful execution even though it stays inside Unity tooling. |
| Network access | 2 (moderate) | The flow downloads the Unity Editor/modules and can talk to Unity and VCS services (`unity auth login`, `unity install lts --module ...`, `--git-token-stdin`), so data and requests leave the machine. |
| Filesystem reach | 1 (low) | It reads/writes project files, `manifest.json`, `.meta` files, and git metadata inside the chosen project directory, but does not call for broad system-path edits or deletions. |
| Secrets & credentials | 2 (moderate) | It explicitly touches Unity auth/license state (`unity auth login`, `unity license activate`) and can accept Git tokens on stdin (`--git-token-stdin`), so credentials may be involved. |
| Privilege & persistence | 0 (none) | There is no sudo, service registration, global install, or shell-startup/OS-setting change requested in `SKILL.md`. |
| Instruction hijack surface | 1 (low) | The skill does not fetch or follow remote instructions, but it does automate prompt acceptance with `--yes --accept-eula` and tells the agent to proceed in the background. |
| Irreversible actions | 2 (moderate) | Its stated purpose includes creating the project and making the first commit/check-in (`git commit -m ...` or UVCS), which is a real publish/write action even though it is user-scoped and stepwise. |
| Transparency | 0 (none) | The reviewed file is plain markdown with no binaries, base64 blobs, or hidden/runtime-decoded code. |
Before installing
- Read `SKILL.md` and the delegated `unity-cli` / `unity-package-management` skills before letting it run.
- Run `unity auth status` and `unity license status` in a disposable Unity account first if you do not want your main credentials used.
- Decide in advance whether the project should be Git/Git LFS or UVCS, because the skill can initialize and commit/check in immediately.
- Use a scratch project directory; it will create, write, and commit files in the chosen path.
Rated 2026-10-17 by an automated review of 1 file from the skill's repository.
Source
- Repository
- Unity-Technologies/unity-agent-plugin (all skills from this repository)
- Path
- skills/new-unity-project/SKILL.md
- Branch
- main
- Updated
- 2026-09-22
Related skills
- expo-project-structure — Framework (OSS). Folder structure for a new Expo app.
- pnpm — Node.js package manager with strict dependency resolution. Use when running pnpm specific commands, configuring workspaces via pnpm-workspace.yaml.
- to-tickets — Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges.
- events — When the user wants to plan, run, sponsor, speak at, or get pipeline from events — webinars, conferences, trade shows, meetups, dinners, workshops.
- figure-it-out — Design an auditable playbook when no narrower one fits: a large migration, an ambitious multi-part change, or work a human reviews after stepping away.
- marketing-loops — When the user wants to set up a recurring, self-running marketing workflow — a repeatable loop an AI agent runs on a cadence (weekly, daily.