Agent skill

Unity Pico Design

by Besty0728 in Besty0728/Unity-Skills

Doc-anchored design rules for PICO Unity Integration SDK v3.4.0 — XR/MR/platform services, version diffs 2.x-3.4, hallucination shields

MITAuto-check passedGame Development

Install Unity Pico Design

skills CLI
$ npx skills add Besty0728/Unity-Skills --skill unity-pico-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Besty0728/Unity-Skills unity-pico-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Besty0728/Unity-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'SkillsForUnity/unity-skills~/skills/pico-design' .claude/skills/unity-pico-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
unity-pico-design
GitHub stars
1.8k
Token cost
~1.2k tokens
SKILL.md length
401 words
Files
10
Skills in repo
82
Repo updated
First seen
Licence
MIT

At a glance

Doc-anchored design rules for PICO Unity Integration SDK v3.4.0 — XR/MR/platform services, version diffs 2.x-3.4, hallucination shields

  • Works in 3 steps: 写 PICO 代码前先读对应子文档;语料查不到的 API… → 官方文档自身有矛盾(面部追踪、XRI 版本口径、SecureMR… → 版本迁移问题一律先查 VERSIONS.md 的方法级增删表再回答。
  • Game Development work in your project
  • SKILL.md covers Triggers, 为什么需要本模块, Critical Rule… and Sub-doc Routing, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Unity Pico Design is an agent skill from Besty0728/Unity-Skills. Doc-anchored design rules for PICO Unity Integration SDK v3.4.0 — XR/MR/platform services, version diffs 2.x-3.4, hallucination shields

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `API_REFERENCE.md`, `INTERACTION.md` and `MR.md`).

It sits in Game Development. The repository describes itself as: AI automation skills specifically designed for Unity. The licence is MIT.

When your agent uses it

  • Game Development work in your project

Example prompts

  • “/unity-pico-design”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 写 PICO 代码前先读对应子文档;语料查不到的 API 宁可声明"官方文档未记载"也不要按记忆补全。
  2. 官方文档自身有矛盾(面部追踪、XRI 版本口径、SecureMR 双套命名)——矛盾区处置见 PITFALLS.md 第五节,不要只信单页。
  3. 版本迁移问题一律先查 VERSIONS.md 的方法级增删表再回答。

What it can do on your machine

Read from SKILL.md and the folder at commit ec8aa7c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unity Pico Design loads about 1.2k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 401 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Besty0728/Unity-Skills at commit ec8aa7c, republished under its MIT licence (© Besty0728). 401 words, ~1,242 tokens.

Download SKILL.mdSave it as .claude/skills/unity-pico-design/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
unity-pico-design
description
Doc-anchored design rules for PICO Unity Integration SDK v3.4.0 — XR/MR/platform services, version diffs 2.x-3.4, hallucination shields

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

  • Writing or reviewing PICO Unity Integration SDK (PXR_* / Pico.Platform) code
  • Setting up a PICO XR project or choosing the Unity OpenXR plugin route
  • Video seethrough / spatial anchors / spatial mesh / SecureMR / platform services
  • Migrating from SDK 2.x or an older 3.x version
  • 编写或审查 PICO Unity SDK 代码、配置 PICO 项目或 OpenXR 路线、透视/锚点/网格/SecureMR/平台服务、2.x→3.x 版本迁移

PICO Unity SDK - Design Rules(v3.4.0)

Advisory 模块。全部规则提炼自 PICO 官方文档 v3.4.0(2026-08-13 全量抓取:指南 203 页 + API 参考 32 页 + 更新说明 14 个版本 + 8 个版本的 API 快照 diff)。SDK 闭源,锚定方式为官方文档 URL——每条规则可点击复核。正文中文,API 名保持英文。

Mode: Documentation only——无 REST skills 可门禁;Approval / Auto / Bypass 任何模式下均可自由加载。

为什么需要本模块

AI 训练语料中的 PICO 知识大量停留在 SDK 2.x / 早期 3.x:旧振动接口、AnchorEntity 事件三段式、PXR_SDK > 菜单、PXR_EyeTracking 类……这些在 3.4.0 已废弃或更名。3.2.0 一个版本就废弃了 PXR_Input 30 个成员、PXR_MotionTracking 27 个成员。凭记忆写 PICO 代码 = 高概率幻觉。生成任何 PICO 代码前先加载本模块对应子文档。

Critical Rule Summary(跨域最高优先级,子文档细读前也要记住)

#规则详见
1PICO XR 插件与 Unity OpenXR 插件二选一:同时勾选只有 PICO XR 生效;OpenXR 路线勾选其他厂商插件会导致应用无法运行SETUP.md
2PXR_Manager 必须挂每一个场景(含加载场景);SDK 3.1.0 起仅支持 64 位(IL2CPP + 仅 ARM64),且 Unity 菜单是 PICO 不是 PXR_SDKSETUP.md
3PXR_MotionTracking 系方法返回 int 状态码(0 成功)不是 bool;SetFoveationLevel 是两参且 None = -1API_REFERENCE.md
4旧触觉接口全组(SetControllerVibration / StartVibrateBy* / CreateHapticStream 等)3.2.0 已废弃 → 现行 SendHapticImpulseVERSIONS.md
5MR 全家(锚点/场景标定/平面检测)操作前必须 StartSenseDataProvider;anchor handle 重启失效,跨会话只能存 UUID;删锚点先 UnPersist 再 DestroyMR.md
6视频透视四前置:禁后处理、Vulkan 下禁 HDR、Clear Flags=Solid Color、背景 RGBA 全 0;EnableVideoSeeThrough 生效有延迟且 resume 后要重调MR.md
7手柄与裸手不能同时追踪(Controller And Hands 是自动切换);全身动捕与体感追踪器独立追踪互斥INTERACTION.md
8平台服务:CoreService.AsyncInitialize 判两层(IsError + Success/AlreadyInitialized);房间/匹配/排行榜/成就还需 GameInitializePLATFORM.md
9面部追踪在 v3.4.0 是官方矛盾区:指南在教的 API 同版本已标 Deprecated,语料无替代类——可沿用但标注状态,勿编造新 APIPITFALLS.md
10渲染互斥矩阵:AppSW×BufferDiscards=撕裂、AppSW×内容保护=拖影、LateLatching×合成层=抖动、超分×锐化同 Buffer 只生效超分RENDERING.md
Show full SKILL.md (135 more words)Show less

Sub-doc Routing

子文档何时读
SETUP.md环境搭建、双插件路线选择、项目设置、AndroidManifest、Project Validation、Building Blocks、AR Foundation、工具与示例索引
RENDERING.mdFFR/ETFR、超分/锐化、合成层(Overlay/Underlay)、多视图、自适应分辨率、AppSW、Late Latching、URP、空间音频、性能目标
INTERACTION.md控制器输入映射、触觉反馈、手势/眼动/面部/身体追踪、体感追踪器、系统键盘、与 XRI 的关系
MR.md视频透视、空间锚点(含共享)、空间网格、场景标定、平面检测、MR 安全防护、空间数据权限、相机图像双路线、2.5→3.x MR 迁移
SECUREMR.mdSecureMR 框架(3.2.0+):Tensor/Operator/Pipeline 概念、gltf 渲染、Dynamic Texture、Readback、JavaScript Operator
PLATFORM.md平台服务精要:初始化、账号/好友、成就、排行榜、IAP、DLC、云存档、房间&匹配、RTC、内容保护、企业服务概览
API_REFERENCE.mdXR 核心 9 类逐方法签名表(含 Deprecated 标记)、PXR_Enterprise 方法域清单、Legacy API 处置
VERSIONS.md版本时间线(v2.0.1→v3.4.0)、逐版本方法级 API 增/删/废弃表、2.x→3.x 迁移要点——废弃清单以本文件为单一事实源
PITFALLS.md幻觉陷阱总闸:废弃 API 黑名单、签名语义陷阱、互斥矩阵、构建陷阱、官方文档自身矛盾清单、能力边界

Routing to Other Modules

  • 通用 XR Interaction Toolkit 交互(rig/抓取/传送/XR UI)→ xr(本模块只覆盖 PICO 特有部分)
  • 架构与生命周期决策 → architecture / patterns / async
  • 性能审查热路径 → performance
  • URP 资产与渲染管线操作 → urp / graphics 功能模块

Version Scope

锚定 v3.4.0(2026-02-27 上线,2026-08-13 抓取)。文档站可切换版本:3.4.0 / 3.3.2 / 3.3.0 / 3.2.0 / 3.1.0 / 3.0.5 / 3.0.0 / 2.5.0;更新说明覆盖至 v2.0.1。关键分水岭:

  • 3.0.0:MR 接口全面重构(AnchorEntity 事件式 → *Async + SenseDataProvider)
  • 3.1.0:菜单 PXR_SDK → PICO;仅支持 64 位应用
  • 3.2.0:史上最大废弃潮(PXR_Input 30 成员、PXR_MotionTracking 27 成员、PXR_System 面部/亮度组);SecureMR 登场
  • 3.3.0:PXR_Over Lay → PXR_Composition Layer;部分 API 跨类搬家至 PXR_Enterprise
  • 3.4.0:平面检测、PXR_CameraImage(用户设备相机数据)、SecureMR JavaScript Operator

SDK 新版本发布后的语料更新方法见 memory:temp/pico-crawl/ 脚本重跑即可。

使用铁律

  1. 写 PICO 代码前先读对应子文档;语料查不到的 API 宁可声明"官方文档未记载"也不要按记忆补全。
  2. 官方文档自身有矛盾(面部追踪、XRI 版本口径、SecureMR 双套命名)——矛盾区处置见 PITFALLS.md 第五节,不要只信单页。
  3. 版本迁移问题一律先查 VERSIONS.md 的方法级增删表再回答。

© Besty0728, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files in SkillsForUnity/unity-skills~/skills/pico-design of Besty0728/Unity-Skills.

  • SKILL.md
  • API_REFERENCE.md
  • INTERACTION.md
  • MR.md
  • PITFALLS.md
  • PLATFORM.md
  • RENDERING.md
  • SECUREMR.md
  • SETUP.md
  • VERSIONS.md

Open the folder on GitHubat commit ec8aa7c

Compare with similar skills

Unity Pico Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unity Pico Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unity Pico Design this skillBesty0728/Unity-Skills1.8k—~1.2kAutomated safety check: PassMIT
Image to Three.js Modelimg2threejs/img2threejs18k1 repos~8.2kAutomated safety check: PassApache-2.0
Web CloneJane-xiaoer/claude-skill-web-clone1k2 repos~2.7kAutomated safety check: PassMIT
Threejs Game Directormajidmanzarpour/threejs-game-skills2.4k—~2.2kAutomated safety check: PassMIT
Game Asset Generatorhtdt/godogen7.1k—~2.8kAutomated safety check: PassMIT
Threejs Gameplay Systemsvalkor-ai/loom1.2k1 repos~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Image to Three.js Model

    img2threejs/img2threejs

    Rebuilds the object in a reference image as a procedural, animation-ready Three.js model written entirely in code, using staged sculpting with quality checks.

    18k GitHub starsUsed in 1 repo~8.2k tokens
    Game DevelopmentAuto-check passed
  • Web Clone

    Jane-xiaoer/claude-skill-web-clone

    网站复刻 / 克隆方法论。USE WHEN 用户说 复刻网站、克隆网站、clone website、抄个站、仿站、 照着这个站做一个、reproduce site、还原某个网页效果、把这个站搬下来改成我的、 复刻某个交互/WebGL/Canvas/Three.js 效果。提供「先拿真源码 → 判路径 → 逆向拆解 → 搭工程 → 替换内容」的可移植决策树,覆盖静态站 /…

    1k GitHub starsUsed in 2 repos~2.7k tokens
    Game DevelopmentAuto-check passed
  • Threejs Game Director

    majidmanzarpour/threejs-game-skills

    Entrypoint for building, upgrading, and finishing Three.js browser games.

    2.4k GitHub stars~2.2k tokensUpdated 11 days ago
    Game DevelopmentAuto-check passed
  • Generates game art from text prompts: PNG images, GLB 3D models, rigged characters, animations and sprites, with background removal.

    7.1k GitHub stars~2.8k tokensUpdated 7 days ago
    Game DevelopmentAuto-check passed
  • Build and iterate playable Three.js game systems: starter scaffold, architecture, design briefs, core loops, level and encounter design, entities, input, camera, collision and physics, scoring…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Game DevelopmentAuto-check passed
  • Uloop Execute Dynamic Code

    CyberAgentGameEntertainment/NovaShader

    Execute C with Unity APIs when existing uloop tools cannot inspect or edit enough.

    1.6k GitHub starsUsed in 1 repo~1.9k tokens
    Game DevelopmentAuto-check passed

More from Besty0728/Unity-Skills

All 82 skills in this repo
  • Unity Skills

    Besty0728/Unity-Skills

    Automate the Unity Editor through a local REST API — scripts, scenes, prefabs, assets, materials, lighting, tests and hundreds of other Editor operations.

    1.8k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Unity Animator

    Besty0728/Unity-Skills

    Edit Unity Animator Controllers and drive runtime parameters

    1.8k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Unity Architecture

    Besty0728/Unity-Skills

    Advise on Unity gameplay and system architecture. An agent skill from Besty0728/Unity-Skills.

    1.8k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Unity Batch

    Besty0728/Unity-Skills

    Unified batch and async-job orchestration. An agent skill from Besty0728/Unity-Skills.

    1.8k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Unity Behavior

    Besty0728/Unity-Skills

    Drive Unity Behavior behavior graphs and blackboard variables

    1.8k GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Unity Console

    Besty0728/Unity-Skills

    Capture and query the Unity Editor console. An agent skill from Besty0728/Unity-Skills.

    1.8k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Questions about Unity Pico Design

What does Unity Pico Design do?

Doc-anchored design rules for PICO Unity Integration SDK v3.4.0 — XR/MR/platform services, version diffs 2.x-3.4, hallucination shields. Unity Pico Design is an agent skill from Besty0728/Unity-Skills.

When should I use Unity Pico Design?

Unity Pico Design fits situations like: game Development work in your project.

How do I install Unity Pico Design in Claude Code?

Run `npx skills add Besty0728/Unity-Skills --skill unity-pico-design -a claude-code`. Or copy the skill folder (SkillsForUnity/unity-skills~/skills/pico-design in Besty0728/Unity-Skills) into .claude/skills/unity-pico-design in your project. Claude Code loads it when a task matches its description.

How do I install Unity Pico Design in Codex?

Run `npx skills add Besty0728/Unity-Skills --skill unity-pico-design -a codex`. Or copy the skill folder (SkillsForUnity/unity-skills~/skills/pico-design in Besty0728/Unity-Skills) into .agents/skills/unity-pico-design in your project. Codex loads it when a task matches its description.

Can I use Unity Pico Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Besty0728/Unity-Skills --skill unity-pico-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unity-pico-design, .gemini/skills/unity-pico-design, .github/skills/unity-pico-design and .opencode/skills/unity-pico-design in your project.

What does Unity Pico Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Unity Pico Design is instructions for the agent only.

Does Unity Pico Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Unity Pico Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Unity Pico Design use?

Unity Pico Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unity Pico Design use?

About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Unity Pico Design?

Skills that share tags, products or a category with Unity Pico Design: Image to Three.js Model (img2threejs/img2threejs, 18k stars), Web Clone (Jane-xiaoer/claude-skill-web-clone, 1k stars), Threejs Game Director (majidmanzarpour/threejs-game-skills, 2.4k stars) and Game Asset Generator (htdt/godogen, 7.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unity Pico Design?

Besty0728 (a GitHub user) maintains it in Besty0728/Unity-Skills, which has 1,815 GitHub stars. The repository holds 82 skills in this directory. The repository was last updated on October 7, 2026.

Source: Besty0728/Unity-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.