unity-package

Manage Unity Package Manager packages including install, remove, search, and version queries.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-package-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-package
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/package
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-package-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Unity Package Manager (UPM) packages through an editor UI is slow and hard to automate. This Skill exposes package operations—listing, checking, installing, removing, searching, and inspecting versions and dependencies—as scriptable skills with async job tracking, so AI agents can manage Unity project dependencies programmatically. ## Core Features & Use Cases - Package Queries: List installed packages, check installation status, search the local package cache, and retrieve dependencies and available versions for any installed package. - Async Install/Remove Jobs: Install or remove UPM packages via asynchronous jobs that return a jobId, since package import triggers Domain Reload and transient server unavailability. - Cinemachine & Splines Setup: One-call helpers install Cinemachine (CM2 or CM3) and Unity Splines with the recommended version strategy, including automatic dependency handling. - Use Case: While building a Unity scene, ask the agent to check whether Cinemachine is installed, install CM3 if missing, and poll the returned job until the Domain Reload completes. ## Quick Start Ask the agent to check whether the package com.unity.cinemachine is installed in the current Unity project and install it if missing.

Frequently Asked Questions about unity-package

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a Unity package programmatically?

Use the package_install skill with the packageId parameter, such as com.unity.cinemachine, and an optional version. It returns an async jobId because the package import triggers a Domain Reload, so poll with job_status or job_wait until completion.

How do I check if a UPM package is installed in Unity?

Call package_check with the packageId to get installed status and version, or use package_list to see all cached installed packages. If the cache is still refreshing after a Domain Reload, retry after the suggested interval instead of assuming the package is missing.

Does package_search query the Unity Registry?

No, package_search only searches the locally installed package cache by package name or display name. It does not query the online Unity Registry for packages that are not yet installed.

Why does package install fail with MODE_FORBIDDEN?

Install, remove, and Cinemachine/Splines setup skills are auto-forbidden under Approval and Auto operating modes because they trigger Domain Reloads and carry high risk. They only run under Bypass mode or through a user-managed Allowlist entry.

How do I install Cinemachine in a Unity project?

Use package_install_cinemachine with version 2 for CM2 or 3 for CM3 (the default). CM3 automatically installs the Splines dependency, and if the requested line is already installed the skill returns immediate success without a job.