diff --git a/.antigravity-plugin/plugin.json b/.antigravity-plugin/plugin.json index 77c42c4..f15b253 100644 --- a/.antigravity-plugin/plugin.json +++ b/.antigravity-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "unity", "displayName": "Unity", - "version": "0.1.9-beta", + "version": "0.1.10-beta", "description": "Unity's official plugin for Antigravity, with curated skills for game development, monetization, and performance optimization.", "logo": "assets/unity-tile.svg", "suggestedPrompts": [ diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index fe83553..f2d9d31 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "unity", "displayName": "Unity", - "version": "0.1.9-beta", + "version": "0.1.10-beta", "description": "Unity's official plugin for coding agents, with curated skills for game development, monetization, and performance optimization.", "author": { "name": "Unity Technologies", diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index ef703fa..0dd67c6 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "unity", - "version": "0.1.9-beta", + "version": "0.1.10-beta", "description": "Unity's official plugin for Codex, with curated skills for game development, monetization, and performance optimization.", "author": { "name": "Unity Technologies", diff --git a/.github/README.md b/.github/README.md index 5a1e231..9affb3b 100644 --- a/.github/README.md +++ b/.github/README.md @@ -71,39 +71,39 @@ For Visual Studio, see [Manual install](#manual-install). Each agent surfaces an installed plugin differently. -**Claude Code** — type `/unity:` and the skills appear in the command list. `/plugin` +**Claude Code** — type `/unity:` and `/unity:using-unity` appears in the command list. `/plugin` also shows `unity` as installed and enabled. **Codex** — run `codex plugin list`: ``` PLUGIN STATUS VERSION -unity@unity-agent-plugin installed, enabled 0.1.9-beta +unity@unity-agent-plugin installed, enabled 0.1.10-beta ``` -**Grok**: type `/` and the skills appear in the slash menu. Grok uses the plain skill -name, and switches to the plugin-qualified form (`/unity:ui-uitk`) when another +**Grok**: type `/` and `using-unity` appears in the slash menu. Grok uses the plain skill +name, and switches to the plugin-qualified form (`/unity:using-unity`) when another installed skill shares the same name. `grok plugin list` shows `unity`, and `grok plugin details unity` lists what it provides. **Antigravity** — run `agy plugin list`: ``` -- unity (enabled, 0.1.9-beta) +- unity (enabled, 0.1.10-beta) ``` **GitHub Copilot CLI** — run `copilot plugin list`: ``` Installed plugins: - • unity@unity-agent-plugin (v0.1.9-beta) + • unity@unity-agent-plugin (v0.1.10-beta) ``` -`copilot skill list` lists the Unity skills under "Plugin skills". +`copilot skill list` lists `using-unity` under "Plugin skills". ### Manual install -If you can't use the marketplace commands, clone the repo and link each skill into your personal skills directory. Run this from the folder you want the clone in: +If you can't use the marketplace commands, clone the repo and link its skill into your personal skills directory. Run this from the folder you want the clone in: ```bash git clone https://github.com/Unity-Technologies/unity-agent-plugin.git @@ -135,8 +135,8 @@ for d in "$PWD"/skills/*; do ln -sfn "$d" ~/.copilot/skills/"$(basename "$d")"; ``` Copilot also reads `~/.claude/skills` and `~/.agents/skills`, so skip this if you -already linked the skills for Claude Code or Codex. On Windows, copy each skill folder -into `%USERPROFILE%\.copilot\skills` instead. +already linked the skill for Claude Code or Codex. On Windows, copy the `skills/using-unity` +folder into `%USERPROFILE%\.copilot\skills` instead. The skills load in every project from your next session onward. To update them, run `git pull` in the clone. Skills installed this way don't appear under a `unity:` prefix, because they aren't installed as a plugin. @@ -161,12 +161,19 @@ do something in your Unity project. For example: > > "Review my ScriptableRendererFeature for Render Graph problems" -In Claude Code, Grok and Antigravity the skills also appear in the slash menu, so you can pick one -explicitly instead of describing the task. +The plugin installs one skill, `using-unity`, which lists every Unity skill with what it's for. +Your agent reads that list, picks the skill that fits your request, and follows it. In the slash +menu of Claude Code, Grok and Antigravity it appears as `/unity:using-unity`; the individual +skills don't have their own slash commands. + +To pick individual skills from the slash menu instead, install them one by one from +[Unity-Technologies/skills](https://github.com/Unity-Technologies/skills) with +`npx skills add Unity-Technologies/skills`. If you install both, your agent can reach each +skill twice. For what each skill covers and how to prompt it, see [About Unity's plugin](https://docs.unity.com/en-us/ai/unity-plugin/about-unity-plugin), -or browse the [skills folder](../skills/). +or browse the [skills](../skills/using-unity/references/). ## Works best with the Unity CLI diff --git a/README.md b/README.md index 28336b7..686a510 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,8 @@ Unity's official plugin for coding agents, with curated skills for game developm The skills give your agent Unity's documented practices for everyday work: starting a project, managing packages, building UI with UI Toolkit, uGUI or IMGUI, 2D sprites and tilemaps, physics, audio, localization, URP rendering and -post-processing, Shader Graph, multiplayer services, Vivox voice chat, in-app purchases and LevelPlay ads. The agent loads -a skill only when your request needs it. +post-processing, Shader Graph, multiplayer services, Vivox voice chat, in-app purchases and LevelPlay ads. The plugin +installs one skill, `using-unity`, which lists them all; the agent reads only the skill your request needs. Install steps and usage are in the [full README](https://github.com/Unity-Technologies/unity-agent-plugin#readme). diff --git a/scripts/check-skill-frontmatter.mjs b/scripts/check-skill-frontmatter.mjs index 883892c..83e7890 100644 --- a/scripts/check-skill-frontmatter.mjs +++ b/scripts/check-skill-frontmatter.mjs @@ -1,8 +1,16 @@ #!/usr/bin/env node -// Fails when any skills/*/SKILL.md has frontmatter that a strict YAML parser rejects, -// or that lacks a non-empty `name` matching its folder or a non-empty `description`. -// Agents parse the frontmatter with a real YAML parser and silently drop a skill that -// fails, so this is the only place the defect becomes visible. +// Fails when a skill's frontmatter is something a strict YAML parser rejects, or lacks a +// non-empty `name` matching its folder or a non-empty `description`. Agents parse the +// frontmatter with a real YAML parser and silently drop a skill that fails, so this is +// the only place the defect becomes visible. +// +// The plugin ships the index shape: `skills/` holds one skill, `using-unity`, whose +// SKILL.md lists every skill, and each skill is `skills/using-unity/references//.md` +// (renamed from SKILL.md so agents don't register it on its own). The publish job in +// unity/skills writes that layout. When `skills/using-unity` exists this checks it: the +// index skill's own frontmatter, each skill's file, that `skills/` holds nothing else, and +// that the index lists exactly the skills in `references/`, each with its file. Without it, +// every `skills//SKILL.md` is checked, as in the flat layout the plugin used before. // // Also enforces two checks from the Claude Code plugin directory's scan: no angle brackets // (like ``) in a skill description, and a root README.md of at least 40 words. @@ -12,39 +20,45 @@ import { join } from 'node:path'; import yaml from 'js-yaml'; const root = process.argv[2] ?? 'skills'; +const indexSkill = 'using-unity'; const readme = 'README.md'; const minReadmeWords = 40; let checked = 0; const failures = []; -for (const dir of readdirSync(root, { withFileTypes: true })) { - if (!dir.isDirectory()) continue; - const path = join(root, dir.name, 'SKILL.md'); +const dirs = (path) => + readdirSync(path, { withFileTypes: true }) + .filter((entry) => entry.isDirectory()) + .map((entry) => entry.name) + .sort(); + +/** Checks one skill file's frontmatter; returns its text, or undefined if it's missing. */ +function checkSkillFile(path, name) { if (!existsSync(path)) { failures.push(`${path}: missing`); - continue; + return undefined; } const text = readFileSync(path, 'utf8'); const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/); if (!match) { failures.push(`${path}: no YAML frontmatter block`); - continue; + return text; } let data; try { data = yaml.load(match[1]); } catch (error) { failures.push(`${path}: frontmatter is not valid YAML: ${error.message.split('\n')[0]}`); - continue; + return text; } if (typeof data !== 'object' || data === null) { failures.push(`${path}: frontmatter is not a mapping`); - continue; + return text; } if (typeof data.name !== 'string' || data.name.trim() === '') { failures.push(`${path}: missing or empty name`); - } else if (data.name !== dir.name) { - failures.push(`${path}: name "${data.name}" does not match folder "${dir.name}"`); + } else if (data.name !== name) { + failures.push(`${path}: name "${data.name}" does not match folder "${name}"`); } if (typeof data.description !== 'string' || data.description.trim() === '') { failures.push(`${path}: missing or empty description`); @@ -52,6 +66,45 @@ for (const dir of readdirSync(root, { withFileTypes: true })) { failures.push(`${path}: description contains angle brackets; reword or use a plain placeholder`); } checked += 1; + return text; +} + +if (existsSync(join(root, indexSkill))) { + for (const name of dirs(root).filter((name) => name !== indexSkill)) { + failures.push(`${join(root, name)}: only ${indexSkill} belongs in ${root}/; this folder loads as a separate skill`); + } + const indexPath = join(root, indexSkill, 'SKILL.md'); + const index = checkSkillFile(indexPath, indexSkill) ?? ''; + const referencesDir = join(root, indexSkill, 'references'); + const skills = existsSync(referencesDir) ? dirs(referencesDir) : []; + if (skills.length === 0) { + failures.push(`${referencesDir}: no skills`); + } + for (const name of skills) { + checkSkillFile(join(referencesDir, name, `${name}.md`), name); + } + // Index lines: "- ****: File: `references//.md`". + const listed = new Map(); + for (const line of index.split(/\r?\n/)) { + const entry = line.match(/^- \*\*([^*]+)\*\*: .* File: `([^`]+)`$/); + if (entry) listed.set(entry[1], entry[2]); + } + for (const name of skills) { + if (!listed.has(name)) { + failures.push(`${indexPath}: doesn't list ${name}, so agents can't reach it`); + } else if (listed.get(name) !== `references/${name}/${name}.md`) { + failures.push(`${indexPath}: lists ${name} with file ${listed.get(name)}, expected references/${name}/${name}.md`); + } + } + for (const name of listed.keys()) { + if (!skills.includes(name)) { + failures.push(`${indexPath}: lists ${name}, which isn't in ${referencesDir}`); + } + } +} else { + for (const name of dirs(root)) { + checkSkillFile(join(root, name, 'SKILL.md'), name); + } } if (!existsSync(readme)) { diff --git a/scripts/plugin-metadata.json b/scripts/plugin-metadata.json index 3e16528..00b4c61 100644 --- a/scripts/plugin-metadata.json +++ b/scripts/plugin-metadata.json @@ -1,5 +1,5 @@ { - "version": "0.1.9-beta", + "version": "0.1.10-beta", "author": { "name": "Unity Technologies", "url": "https://unity.com" diff --git a/skills/using-unity/SKILL.md b/skills/using-unity/SKILL.md new file mode 100644 index 0000000..05e43c0 --- /dev/null +++ b/skills/using-unity/SKILL.md @@ -0,0 +1,60 @@ +--- +name: using-unity +description: "Index of Unity's full library of skills and guides, with every skill's description and file. Make sure to use this skill for any Unity game development task, from gameplay, graphics and UI to multiplayer, live services, monetization, user acquisition, builds and performance, including advice questions, before writing code or answering." +--- + +# Using Unity + +Unity's skills live in this skill's `references/` folder. They aren't listed individually, so this index is the only way to reach them. + +## Step 1: Pick one skill + +Read the request, then scan the index below for the skill whose description fits it most exactly. Prefer the skill that covers the whole request; choose a narrower skill only when the request is specifically about its topic. + +## Step 2: Read it and follow it + +Read the chosen skill's file with the Read tool (paths are relative to this skill's folder) and follow its instructions. Don't answer from memory when a skill covers the request, because these skills are newer and more specific than training data. + +A skill's own files are in its folder, `references//`. When the skill gives a path relative to itself, such as `scripts/…` or `references/…`, or names its skill directory or base directory (for example ``), that means its folder, not this skill's. Use the folder's full path in commands. + +## Skills named by another skill + +A skill may tell you to use, load or check for another skill by name, for example "use the `unity-cli` skill" or "check that `ui` is in your client's skills". Every skill in the index below is installed with this one, though only `using-unity` is listed in your client's skills. Treat each of them as available: when a skill names one, read its file from the index and follow it, and don't offer to install it. Where a skill's files mention its `SKILL.md`, that is its `.md` file here. + +## Index (35 skills, A to Z) + +- **2d-pixel-perfect**: Sets up, diagnoses, and fixes pixel perfect 2D rendering with PixelPerfectCamera in URP or Built-in. Use when a retro-style or pixel art 2D game looks blurry, jittery, or misaligned. Not for HD 2D or high-resolution art. File: `references/2d-pixel-perfect/2d-pixel-perfect.md` +- **asset-transformer-toolkit**: In the Unity Editor, imports 3D models and point clouds with Asset Transformer Toolkit (formerly Pixyz), and creates, edits, and runs RuleSets, Actions, and LODs. Use for Pixyz imports in a Unity project, not for converting files from the shell. File: `references/asset-transformer-toolkit/asset-transformer-toolkit.md` +- **audio-setup-mixers**: Routes Audio Sources into existing Audio Mixer Groups, classifying each source by what it plays. Use when the user asks about cleaning up mixer assignments, routing audio through a mixer, or which group a sound belongs in. File: `references/audio-setup-mixers/audio-setup-mixers.md` +- **build-gtk**: Builds graph tools with Unity Graph Toolkit (GTK) on 6.6+, state machines on 6.7+, and importers for runtime assets. Use this skill for graph, node or state machine editors, or GraphView migrations. Not for Shader Graph, VFX Graph or Animator. File: `references/build-gtk/build-gtk.md` +- **build-live-game**: Builds and operates a live game backend on Unity Gaming Services. Make sure to use this skill when the user wants sign-in or sign-in checks, trusted server-side game logic, player progress, remote config, achievements, battle passes or leaderboards. File: `references/build-live-game/build-live-game.md` +- **build-multiplayer-game**: Builds Unity online multiplayer, from matchmaking to gameplay sync. Make sure to use this skill when the user asks to add online play, host or join games, or fix lag, desync or connection failures. Not for voice chat or backend features. File: `references/build-multiplayer-game/build-multiplayer-game.md` +- **craft-game-floors**: Makes a Unity game playable and finished: core loop, art style, lighting, juice, sound, menus, saves, look scoring. Use for a first playable version, or one with no goal or win state, programmer art, a flat or silent feel, or polish needs. File: `references/craft-game-floors/craft-game-floors.md` +- **create-2d-physics**: Creates and fixes Unity 2D physics in both systems, 2D Physics Core and the legacy Rigidbody 2D system. Use when the user asks about any 2D physics task, even if neither system is named. Not for 3D physics. File: `references/create-2d-physics/create-2d-physics.md` +- **create-tile-palette-or-rule-tiles**: Creates a 2D tile palette from sprites or textures, or makes tiles change based on their neighbours. Use when the user wants a tile palette or tiles that connect to their neighbours as they paint, even when they don't name them. File: `references/create-tile-palette-or-rule-tiles/create-tile-palette-or-rule-tiles.md` +- **create-xr**: Sets up a Unity project for XR. Use when user asks for XR, OpenXR, Quest graphics or XR rig. File: `references/create-xr/create-xr.md` +- **fix-3d-physics-collisions**: Diagnoses and fixes 3D PhysX collision, trigger, and raycast problems. Use when asked to fix OnCollisionEnter or OnTriggerEnter not firing, objects passing through each other, raycasts that miss, or a misbehaving MeshCollider. File: `references/fix-3d-physics-collisions/fix-3d-physics-collisions.md` +- **generate-editor-search-query**: Generates Unity Search queries and opens the Search window to find assets or scene objects. Use when the user asks to find, filter, or list assets, GameObjects, components, or references in the Editor, not on disk. File: `references/generate-editor-search-query/generate-editor-search-query.md` +- **implement-in-app-purchases**: Implements, configures, and debugs Unity In-App Purchases, including subscriptions, receipt validation, and direct-to-customer payments via Stripe or Coda. Use when asked about real-money purchases or microtransactions, or migrating from native store billing, RevenueCat, Adapty, Essential Kit, or UniPay. File: `references/implement-in-app-purchases/implement-in-app-purchases.md` +- **initialize-ai-navigation**: Sets up and configures Unity AI Navigation, including NavMesh surfaces, agents, obstacles, and links. Use when the user asks about navigation meshes, pathfinding, patrol routes, or obstacle avoidance. File: `references/initialize-ai-navigation/initialize-ai-navigation.md` +- **levelplay-unity-integration**: Integrates the LevelPlay ad mediation SDK via the Ads Mediation package. Use when the user asks about adding rewarded, interstitial, or banner ads, mediation or ad privacy setup, Android or iOS ad dependency build failures, or migrating from Unity Ads or IronSource APIs. File: `references/levelplay-unity-integration/levelplay-unity-integration.md` +- **localize-unity-project**: Sets up Unity Localization, including locales, String and Asset Tables, and CJK fonts. Use when the user wants to add languages or translate UI text. File: `references/localize-unity-project/localize-unity-project.md` +- **manage-sprite-atlas**: Manages SpriteAtlas assets through a prebuild pipeline, covering master and variant atlases, packing settings, and platform overrides. Use when asked to create or optimize sprite atlases. File: `references/manage-sprite-atlas/manage-sprite-atlas.md` +- **migrate-birp-to-urp**: Plans, executes, and troubleshoots migration from the Built-in Render Pipeline to URP. Use when asked to convert a project, scene, material, or shader to URP, or to fix visuals broken by the change. File: `references/migrate-birp-to-urp/migrate-birp-to-urp.md` +- **new-unity-project**: Guides creating a new Unity project, from concept, platforms, and monetization to source control and packages. Use when the user asks to start a new game or prototype. Runs an opinionated paved path by default. File: `references/new-unity-project/new-unity-project.md` +- **optimize-audio**: Optimizes audio memory, CPU cost, and playback quality through import settings and mixer configuration. Use when asked to reduce audio memory or Audio Mixer CPU cost, change clip Load Types, sample rates or codecs, or force 3D audio to mono. File: `references/optimize-audio/optimize-audio.md` +- **optimize-text-mesh-pro**: Optimizes TextMeshPro rendering, memory, and font setup, including font asset stacks, fallback atlases, SDF quality, and worldspace text. Use when the user asks about TextMeshPro font assets, CJK font fallbacks, or TMP memory, build size, quality or performance, not about translating text. File: `references/optimize-text-mesh-pro/optimize-text-mesh-pro.md` +- **optimize-web**: Optimizes Unity WebGL and WebGPU builds for smaller downloads, faster loading, and smoother browser performance. Use when asked to shrink a web build, speed up its load, or fix stutter, memory or battery problems in the browser. File: `references/optimize-web/optimize-web.md` +- **setup-vivox-voice-chat**: Adds and configures in-game voice and text chat with Unity Vivox. Use when asked to add voice or text chat to a multiplayer game, such as team channels, proximity voice, mute controls or private messages. File: `references/setup-vivox-voice-chat/setup-vivox-voice-chat.md` +- **shader-graph-create-custom-node**: Generates custom Shader Graph nodes from HLSL code. Use when the user wants a new Shader Graph node or to make existing HLSL work as a reflected function node. File: `references/shader-graph-create-custom-node/shader-graph-create-custom-node.md` +- **sprite-editor**: Edits Unity sprite rectangles, borders, pivots, outlines, and slicing by generating C# scripts. Use when the user works with sprite sheets or sprite slicing. File: `references/sprite-editor/sprite-editor.md` +- **sprite-segment-3x3grid**: Segments a Sprite texture into a 3x3 grid and outputs a pattern of cells matching the center cell's color. Use when asked to analyze, compare, or document a sprite's structure or color distribution. File: `references/sprite-segment-3x3grid/sprite-segment-3x3grid.md` +- **ui**: Routes Unity UI requests to the right framework skill (UI Toolkit, uGUI, or IMGUI) and answers UI comparison questions. Use for menus, HUDs, panels, or editor UI when the request doesn't name a framework. Consult before writing any UI code. File: `references/ui/ui.md` +- **ui-imgui**: Generates and modifies Unity IMGUI editor code such as EditorWindows, custom Inspectors, PropertyDrawers, and OnGUI scripts. Use for IMGUI or OnGUI or maintaining existing IMGUI code. File: `references/ui-imgui/ui-imgui.md` +- **ui-ugui**: Understands, edits, and generates Unity uGUI Canvas hierarchies, RectTransforms, Layout Groups, and prefab UI. Use for requests involving Canvas, uGUI, RectTransform, or prefab UI files. File: `references/ui-ugui/ui-ugui.md` +- **ui-uitk**: Understands, edits, and generates Unity UI Toolkit UXML and USS with flex layouts. Use for requests involving UI Toolkit, UIElements, UIDocument, PanelSettings, custom elements, or UI runtime binding. File: `references/ui-uitk/ui-uitk.md` +- **unity-cli**: Controls Unity Editors and projects from the command line, including a running Editor. Make sure to use this skill when the user asks to install or manage Editors, licenses, or projects, set up version control, build, test, edit scenes, run C#, look up the scripting API or manual for the project's Unity version, or run any unity command. File: `references/unity-cli/unity-cli.md` +- **unity-package-management**: Adds, removes, upgrades, and finds Unity (UPM) packages from outside the Editor. Use for package installs, checking package IDs and versions, or choosing which packages a game needs. File: `references/unity-package-management/unity-package-management.md` +- **unity-pipeline**: Control a Unity Editor or Player via the unity-pipeline package. Compile, run tests, eval, method-reload code, enter Play Mode, capture screenshots. File: `references/unity-pipeline/unity-pipeline.md` +- **urp-postprocessing**: Sets up, configures, and debugs URP post-processing with the Volume framework. Use for bloom, tonemapping, color adjustments, depth of field, vignette, or other Volume overrides. File: `references/urp-postprocessing/urp-postprocessing.md` +- **validate-urp-render-graph-renderer-feature**: Reviews a Unity 6 URP ScriptableRendererFeature that uses the Render Graph API, checking resource wiring, material binding, execution structure, and best practices. Use to validate a renderer feature. File: `references/validate-urp-render-graph-renderer-feature/validate-urp-render-graph-renderer-feature.md` diff --git a/skills/2d-pixel-perfect/SKILL.md b/skills/using-unity/references/2d-pixel-perfect/2d-pixel-perfect.md similarity index 100% rename from skills/2d-pixel-perfect/SKILL.md rename to skills/using-unity/references/2d-pixel-perfect/2d-pixel-perfect.md diff --git a/skills/2d-pixel-perfect/references/api-reference.md b/skills/using-unity/references/2d-pixel-perfect/references/api-reference.md similarity index 100% rename from skills/2d-pixel-perfect/references/api-reference.md rename to skills/using-unity/references/2d-pixel-perfect/references/api-reference.md diff --git a/skills/2d-pixel-perfect/references/camera-setup-builtin.cs b/skills/using-unity/references/2d-pixel-perfect/references/camera-setup-builtin.cs similarity index 100% rename from skills/2d-pixel-perfect/references/camera-setup-builtin.cs rename to skills/using-unity/references/2d-pixel-perfect/references/camera-setup-builtin.cs diff --git a/skills/2d-pixel-perfect/references/camera-setup-urp.cs b/skills/using-unity/references/2d-pixel-perfect/references/camera-setup-urp.cs similarity index 100% rename from skills/2d-pixel-perfect/references/camera-setup-urp.cs rename to skills/using-unity/references/2d-pixel-perfect/references/camera-setup-urp.cs diff --git a/skills/2d-pixel-perfect/references/pipeline-detection.cs b/skills/using-unity/references/2d-pixel-perfect/references/pipeline-detection.cs similarity index 100% rename from skills/2d-pixel-perfect/references/pipeline-detection.cs rename to skills/using-unity/references/2d-pixel-perfect/references/pipeline-detection.cs diff --git a/skills/2d-pixel-perfect/references/sprite-settings.cs b/skills/using-unity/references/2d-pixel-perfect/references/sprite-settings.cs similarity index 100% rename from skills/2d-pixel-perfect/references/sprite-settings.cs rename to skills/using-unity/references/2d-pixel-perfect/references/sprite-settings.cs diff --git a/skills/asset-transformer-toolkit/SECURITY.md b/skills/using-unity/references/asset-transformer-toolkit/SECURITY.md similarity index 100% rename from skills/asset-transformer-toolkit/SECURITY.md rename to skills/using-unity/references/asset-transformer-toolkit/SECURITY.md diff --git a/skills/asset-transformer-toolkit/SKILL.md b/skills/using-unity/references/asset-transformer-toolkit/asset-transformer-toolkit.md similarity index 100% rename from skills/asset-transformer-toolkit/SKILL.md rename to skills/using-unity/references/asset-transformer-toolkit/asset-transformer-toolkit.md diff --git a/skills/asset-transformer-toolkit/references/create-importer.md b/skills/using-unity/references/asset-transformer-toolkit/references/create-importer.md similarity index 100% rename from skills/asset-transformer-toolkit/references/create-importer.md rename to skills/using-unity/references/asset-transformer-toolkit/references/create-importer.md diff --git a/skills/asset-transformer-toolkit/references/lods.md b/skills/using-unity/references/asset-transformer-toolkit/references/lods.md similarity index 100% rename from skills/asset-transformer-toolkit/references/lods.md rename to skills/using-unity/references/asset-transformer-toolkit/references/lods.md diff --git a/skills/asset-transformer-toolkit/references/rule-api.md b/skills/using-unity/references/asset-transformer-toolkit/references/rule-api.md similarity index 100% rename from skills/asset-transformer-toolkit/references/rule-api.md rename to skills/using-unity/references/asset-transformer-toolkit/references/rule-api.md diff --git a/skills/asset-transformer-toolkit/references/ruleblock-api.md b/skills/using-unity/references/asset-transformer-toolkit/references/ruleblock-api.md similarity index 100% rename from skills/asset-transformer-toolkit/references/ruleblock-api.md rename to skills/using-unity/references/asset-transformer-toolkit/references/ruleblock-api.md diff --git a/skills/asset-transformer-toolkit/references/ruleset-api.md b/skills/using-unity/references/asset-transformer-toolkit/references/ruleset-api.md similarity index 100% rename from skills/asset-transformer-toolkit/references/ruleset-api.md rename to skills/using-unity/references/asset-transformer-toolkit/references/ruleset-api.md diff --git a/skills/asset-transformer-toolkit/references/rulesets-and-actions.md b/skills/using-unity/references/asset-transformer-toolkit/references/rulesets-and-actions.md similarity index 100% rename from skills/asset-transformer-toolkit/references/rulesets-and-actions.md rename to skills/using-unity/references/asset-transformer-toolkit/references/rulesets-and-actions.md diff --git a/skills/audio-setup-mixers/SECURITY.md b/skills/using-unity/references/audio-setup-mixers/SECURITY.md similarity index 100% rename from skills/audio-setup-mixers/SECURITY.md rename to skills/using-unity/references/audio-setup-mixers/SECURITY.md diff --git a/skills/audio-setup-mixers/SKILL.md b/skills/using-unity/references/audio-setup-mixers/audio-setup-mixers.md similarity index 100% rename from skills/audio-setup-mixers/SKILL.md rename to skills/using-unity/references/audio-setup-mixers/audio-setup-mixers.md diff --git a/skills/audio-setup-mixers/references/api.md b/skills/using-unity/references/audio-setup-mixers/references/api.md similarity index 100% rename from skills/audio-setup-mixers/references/api.md rename to skills/using-unity/references/audio-setup-mixers/references/api.md diff --git a/skills/build-gtk/SECURITY.md b/skills/using-unity/references/build-gtk/SECURITY.md similarity index 100% rename from skills/build-gtk/SECURITY.md rename to skills/using-unity/references/build-gtk/SECURITY.md diff --git a/skills/build-gtk/SKILL.md b/skills/using-unity/references/build-gtk/build-gtk.md similarity index 100% rename from skills/build-gtk/SKILL.md rename to skills/using-unity/references/build-gtk/build-gtk.md diff --git a/skills/build-gtk/references/graph-api-gaps.md b/skills/using-unity/references/build-gtk/references/graph-api-gaps.md similarity index 100% rename from skills/build-gtk/references/graph-api-gaps.md rename to skills/using-unity/references/build-gtk/references/graph-api-gaps.md diff --git a/skills/build-gtk/references/runtime-and-visualization.md b/skills/using-unity/references/build-gtk/references/runtime-and-visualization.md similarity index 100% rename from skills/build-gtk/references/runtime-and-visualization.md rename to skills/using-unity/references/build-gtk/references/runtime-and-visualization.md diff --git a/skills/build-gtk/references/state-machine-api.md b/skills/using-unity/references/build-gtk/references/state-machine-api.md similarity index 100% rename from skills/build-gtk/references/state-machine-api.md rename to skills/using-unity/references/build-gtk/references/state-machine-api.md diff --git a/skills/build-live-game/SECURITY.md b/skills/using-unity/references/build-live-game/SECURITY.md similarity index 100% rename from skills/build-live-game/SECURITY.md rename to skills/using-unity/references/build-live-game/SECURITY.md diff --git a/skills/build-live-game/SKILL.md b/skills/using-unity/references/build-live-game/build-live-game.md similarity index 100% rename from skills/build-live-game/SKILL.md rename to skills/using-unity/references/build-live-game/build-live-game.md diff --git a/skills/build-live-game/references/achievements.md b/skills/using-unity/references/build-live-game/references/achievements.md similarity index 100% rename from skills/build-live-game/references/achievements.md rename to skills/using-unity/references/build-live-game/references/achievements.md diff --git a/skills/build-live-game/references/apis.md b/skills/using-unity/references/build-live-game/references/apis.md similarity index 100% rename from skills/build-live-game/references/apis.md rename to skills/using-unity/references/build-live-game/references/apis.md diff --git a/skills/build-live-game/references/authentication.md b/skills/using-unity/references/build-live-game/references/authentication.md similarity index 100% rename from skills/build-live-game/references/authentication.md rename to skills/using-unity/references/build-live-game/references/authentication.md diff --git a/skills/build-live-game/references/battlepass.md b/skills/using-unity/references/build-live-game/references/battlepass.md similarity index 100% rename from skills/build-live-game/references/battlepass.md rename to skills/using-unity/references/build-live-game/references/battlepass.md diff --git a/skills/build-live-game/references/blueprints-and-samples.md b/skills/using-unity/references/build-live-game/references/blueprints-and-samples.md similarity index 100% rename from skills/build-live-game/references/blueprints-and-samples.md rename to skills/using-unity/references/build-live-game/references/blueprints-and-samples.md diff --git a/skills/build-live-game/references/cloud-code-cloudbehaviours.md b/skills/using-unity/references/build-live-game/references/cloud-code-cloudbehaviours.md similarity index 100% rename from skills/build-live-game/references/cloud-code-cloudbehaviours.md rename to skills/using-unity/references/build-live-game/references/cloud-code-cloudbehaviours.md diff --git a/skills/build-live-game/references/cloud-code-modules.md b/skills/using-unity/references/build-live-game/references/cloud-code-modules.md similarity index 100% rename from skills/build-live-game/references/cloud-code-modules.md rename to skills/using-unity/references/build-live-game/references/cloud-code-modules.md diff --git a/skills/build-live-game/references/cloud-code.md b/skills/using-unity/references/build-live-game/references/cloud-code.md similarity index 100% rename from skills/build-live-game/references/cloud-code.md rename to skills/using-unity/references/build-live-game/references/cloud-code.md diff --git a/skills/build-live-game/references/cloud-save.md b/skills/using-unity/references/build-live-game/references/cloud-save.md similarity index 100% rename from skills/build-live-game/references/cloud-save.md rename to skills/using-unity/references/build-live-game/references/cloud-save.md diff --git a/skills/build-live-game/references/deployment.md b/skills/using-unity/references/build-live-game/references/deployment.md similarity index 100% rename from skills/build-live-game/references/deployment.md rename to skills/using-unity/references/build-live-game/references/deployment.md diff --git a/skills/build-live-game/references/link-cloud.md b/skills/using-unity/references/build-live-game/references/link-cloud.md similarity index 100% rename from skills/build-live-game/references/link-cloud.md rename to skills/using-unity/references/build-live-game/references/link-cloud.md diff --git a/skills/build-live-game/references/player-account.md b/skills/using-unity/references/build-live-game/references/player-account.md similarity index 100% rename from skills/build-live-game/references/player-account.md rename to skills/using-unity/references/build-live-game/references/player-account.md diff --git a/skills/build-live-game/references/remote-config.md b/skills/using-unity/references/build-live-game/references/remote-config.md similarity index 100% rename from skills/build-live-game/references/remote-config.md rename to skills/using-unity/references/build-live-game/references/remote-config.md diff --git a/skills/build-live-game/references/tooling.md b/skills/using-unity/references/build-live-game/references/tooling.md similarity index 100% rename from skills/build-live-game/references/tooling.md rename to skills/using-unity/references/build-live-game/references/tooling.md diff --git a/skills/build-live-game/references/ugs-cli.md b/skills/using-unity/references/build-live-game/references/ugs-cli.md similarity index 100% rename from skills/build-live-game/references/ugs-cli.md rename to skills/using-unity/references/build-live-game/references/ugs-cli.md diff --git a/skills/build-multiplayer-game/SECURITY.md b/skills/using-unity/references/build-multiplayer-game/SECURITY.md similarity index 100% rename from skills/build-multiplayer-game/SECURITY.md rename to skills/using-unity/references/build-multiplayer-game/SECURITY.md diff --git a/skills/build-multiplayer-game/SKILL.md b/skills/using-unity/references/build-multiplayer-game/build-multiplayer-game.md similarity index 100% rename from skills/build-multiplayer-game/SKILL.md rename to skills/using-unity/references/build-multiplayer-game/build-multiplayer-game.md diff --git a/skills/build-multiplayer-game/references/architecture.md b/skills/using-unity/references/build-multiplayer-game/references/architecture.md similarity index 100% rename from skills/build-multiplayer-game/references/architecture.md rename to skills/using-unity/references/build-multiplayer-game/references/architecture.md diff --git a/skills/build-multiplayer-game/references/choosing-netcode.md b/skills/using-unity/references/build-multiplayer-game/references/choosing-netcode.md similarity index 100% rename from skills/build-multiplayer-game/references/choosing-netcode.md rename to skills/using-unity/references/build-multiplayer-game/references/choosing-netcode.md diff --git a/skills/build-multiplayer-game/references/dgs-entrypoint.md b/skills/using-unity/references/build-multiplayer-game/references/dgs-entrypoint.md similarity index 100% rename from skills/build-multiplayer-game/references/dgs-entrypoint.md rename to skills/using-unity/references/build-multiplayer-game/references/dgs-entrypoint.md diff --git a/skills/build-multiplayer-game/references/entrypoints.md b/skills/using-unity/references/build-multiplayer-game/references/entrypoints.md similarity index 100% rename from skills/build-multiplayer-game/references/entrypoints.md rename to skills/using-unity/references/build-multiplayer-game/references/entrypoints.md diff --git a/skills/build-multiplayer-game/references/examples.md b/skills/using-unity/references/build-multiplayer-game/references/examples.md similarity index 100% rename from skills/build-multiplayer-game/references/examples.md rename to skills/using-unity/references/build-multiplayer-game/references/examples.md diff --git a/skills/build-multiplayer-game/references/ghost-authoring.md b/skills/using-unity/references/build-multiplayer-game/references/ghost-authoring.md similarity index 100% rename from skills/build-multiplayer-game/references/ghost-authoring.md rename to skills/using-unity/references/build-multiplayer-game/references/ghost-authoring.md diff --git a/skills/build-multiplayer-game/references/implementation-fit.md b/skills/using-unity/references/build-multiplayer-game/references/implementation-fit.md similarity index 100% rename from skills/build-multiplayer-game/references/implementation-fit.md rename to skills/using-unity/references/build-multiplayer-game/references/implementation-fit.md diff --git a/skills/build-multiplayer-game/references/link-cloud.md b/skills/using-unity/references/build-multiplayer-game/references/link-cloud.md similarity index 100% rename from skills/build-multiplayer-game/references/link-cloud.md rename to skills/using-unity/references/build-multiplayer-game/references/link-cloud.md diff --git a/skills/build-multiplayer-game/references/multiplayer-play-mode.md b/skills/using-unity/references/build-multiplayer-game/references/multiplayer-play-mode.md similarity index 100% rename from skills/build-multiplayer-game/references/multiplayer-play-mode.md rename to skills/using-unity/references/build-multiplayer-game/references/multiplayer-play-mode.md diff --git a/skills/build-multiplayer-game/references/netcode-for-entities.md b/skills/using-unity/references/build-multiplayer-game/references/netcode-for-entities.md similarity index 100% rename from skills/build-multiplayer-game/references/netcode-for-entities.md rename to skills/using-unity/references/build-multiplayer-game/references/netcode-for-entities.md diff --git a/skills/build-multiplayer-game/references/netcode-lifecycle.md b/skills/using-unity/references/build-multiplayer-game/references/netcode-lifecycle.md similarity index 100% rename from skills/build-multiplayer-game/references/netcode-lifecycle.md rename to skills/using-unity/references/build-multiplayer-game/references/netcode-lifecycle.md diff --git a/skills/build-multiplayer-game/references/performance-and-scale.md b/skills/using-unity/references/build-multiplayer-game/references/performance-and-scale.md similarity index 100% rename from skills/build-multiplayer-game/references/performance-and-scale.md rename to skills/using-unity/references/build-multiplayer-game/references/performance-and-scale.md diff --git a/skills/build-multiplayer-game/references/session-connectors.md b/skills/using-unity/references/build-multiplayer-game/references/session-connectors.md similarity index 100% rename from skills/build-multiplayer-game/references/session-connectors.md rename to skills/using-unity/references/build-multiplayer-game/references/session-connectors.md diff --git a/skills/build-multiplayer-game/references/syncing-gameplay.md b/skills/using-unity/references/build-multiplayer-game/references/syncing-gameplay.md similarity index 100% rename from skills/build-multiplayer-game/references/syncing-gameplay.md rename to skills/using-unity/references/build-multiplayer-game/references/syncing-gameplay.md diff --git a/skills/build-multiplayer-game/references/underlying-services.md b/skills/using-unity/references/build-multiplayer-game/references/underlying-services.md similarity index 100% rename from skills/build-multiplayer-game/references/underlying-services.md rename to skills/using-unity/references/build-multiplayer-game/references/underlying-services.md diff --git a/skills/build-multiplayer-game/references/verification-gate.md b/skills/using-unity/references/build-multiplayer-game/references/verification-gate.md similarity index 100% rename from skills/build-multiplayer-game/references/verification-gate.md rename to skills/using-unity/references/build-multiplayer-game/references/verification-gate.md diff --git a/skills/build-multiplayer-game/references/workflows-prerequisites.md b/skills/using-unity/references/build-multiplayer-game/references/workflows-prerequisites.md similarity index 100% rename from skills/build-multiplayer-game/references/workflows-prerequisites.md rename to skills/using-unity/references/build-multiplayer-game/references/workflows-prerequisites.md diff --git a/skills/craft-game-floors/SECURITY.md b/skills/using-unity/references/craft-game-floors/SECURITY.md similarity index 100% rename from skills/craft-game-floors/SECURITY.md rename to skills/using-unity/references/craft-game-floors/SECURITY.md diff --git a/skills/craft-game-floors/SKILL.md b/skills/using-unity/references/craft-game-floors/craft-game-floors.md similarity index 100% rename from skills/craft-game-floors/SKILL.md rename to skills/using-unity/references/craft-game-floors/craft-game-floors.md diff --git a/skills/craft-game-floors/references/art-direction.md b/skills/using-unity/references/craft-game-floors/references/art-direction.md similarity index 100% rename from skills/craft-game-floors/references/art-direction.md rename to skills/using-unity/references/craft-game-floors/references/art-direction.md diff --git a/skills/craft-game-floors/references/camera-rigs.md b/skills/using-unity/references/craft-game-floors/references/camera-rigs.md similarity index 100% rename from skills/craft-game-floors/references/camera-rigs.md rename to skills/using-unity/references/craft-game-floors/references/camera-rigs.md diff --git a/skills/craft-game-floors/references/character-motion.md b/skills/using-unity/references/craft-game-floors/references/character-motion.md similarity index 100% rename from skills/craft-game-floors/references/character-motion.md rename to skills/using-unity/references/craft-game-floors/references/character-motion.md diff --git a/skills/craft-game-floors/references/game-audio.md b/skills/using-unity/references/craft-game-floors/references/game-audio.md similarity index 100% rename from skills/craft-game-floors/references/game-audio.md rename to skills/using-unity/references/craft-game-floors/references/game-audio.md diff --git a/skills/craft-game-floors/references/game-feel.md b/skills/using-unity/references/craft-game-floors/references/game-feel.md similarity index 100% rename from skills/craft-game-floors/references/game-feel.md rename to skills/using-unity/references/craft-game-floors/references/game-feel.md diff --git a/skills/craft-game-floors/references/game-shell.md b/skills/using-unity/references/craft-game-floors/references/game-shell.md similarity index 100% rename from skills/craft-game-floors/references/game-shell.md rename to skills/using-unity/references/craft-game-floors/references/game-shell.md diff --git a/skills/craft-game-floors/references/live-floor.md b/skills/using-unity/references/craft-game-floors/references/live-floor.md similarity index 100% rename from skills/craft-game-floors/references/live-floor.md rename to skills/using-unity/references/craft-game-floors/references/live-floor.md diff --git a/skills/craft-game-floors/references/placeholder-assets.md b/skills/using-unity/references/craft-game-floors/references/placeholder-assets.md similarity index 100% rename from skills/craft-game-floors/references/placeholder-assets.md rename to skills/using-unity/references/craft-game-floors/references/placeholder-assets.md diff --git a/skills/craft-game-floors/references/playable-loop.md b/skills/using-unity/references/craft-game-floors/references/playable-loop.md similarity index 100% rename from skills/craft-game-floors/references/playable-loop.md rename to skills/using-unity/references/craft-game-floors/references/playable-loop.md diff --git a/skills/craft-game-floors/references/scene-lighting.md b/skills/using-unity/references/craft-game-floors/references/scene-lighting.md similarity index 100% rename from skills/craft-game-floors/references/scene-lighting.md rename to skills/using-unity/references/craft-game-floors/references/scene-lighting.md diff --git a/skills/craft-game-floors/references/toon-shading.md b/skills/using-unity/references/craft-game-floors/references/toon-shading.md similarity index 100% rename from skills/craft-game-floors/references/toon-shading.md rename to skills/using-unity/references/craft-game-floors/references/toon-shading.md diff --git a/skills/craft-game-floors/references/vfx.md b/skills/using-unity/references/craft-game-floors/references/vfx.md similarity index 100% rename from skills/craft-game-floors/references/vfx.md rename to skills/using-unity/references/craft-game-floors/references/vfx.md diff --git a/skills/craft-game-floors/references/visual-scorecard.md b/skills/using-unity/references/craft-game-floors/references/visual-scorecard.md similarity index 100% rename from skills/craft-game-floors/references/visual-scorecard.md rename to skills/using-unity/references/craft-game-floors/references/visual-scorecard.md diff --git a/skills/create-2d-physics/SECURITY.md b/skills/using-unity/references/create-2d-physics/SECURITY.md similarity index 100% rename from skills/create-2d-physics/SECURITY.md rename to skills/using-unity/references/create-2d-physics/SECURITY.md diff --git a/skills/create-2d-physics/SKILL.md b/skills/using-unity/references/create-2d-physics/create-2d-physics.md similarity index 100% rename from skills/create-2d-physics/SKILL.md rename to skills/using-unity/references/create-2d-physics/create-2d-physics.md diff --git a/skills/create-2d-physics/references/2d-physics-core.md b/skills/using-unity/references/create-2d-physics/references/2d-physics-core.md similarity index 100% rename from skills/create-2d-physics/references/2d-physics-core.md rename to skills/using-unity/references/create-2d-physics/references/2d-physics-core.md diff --git a/skills/create-2d-physics/references/legacy-2d-physics.md b/skills/using-unity/references/create-2d-physics/references/legacy-2d-physics.md similarity index 100% rename from skills/create-2d-physics/references/legacy-2d-physics.md rename to skills/using-unity/references/create-2d-physics/references/legacy-2d-physics.md diff --git a/skills/create-tile-palette-or-rule-tiles/SKILL.md b/skills/using-unity/references/create-tile-palette-or-rule-tiles/create-tile-palette-or-rule-tiles.md similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/SKILL.md rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/create-tile-palette-or-rule-tiles.md diff --git a/skills/create-tile-palette-or-rule-tiles/references/hexagonalruletile.md b/skills/using-unity/references/create-tile-palette-or-rule-tiles/references/hexagonalruletile.md similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/references/hexagonalruletile.md rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/references/hexagonalruletile.md diff --git a/skills/create-tile-palette-or-rule-tiles/references/palette-create.md b/skills/using-unity/references/create-tile-palette-or-rule-tiles/references/palette-create.md similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/references/palette-create.md rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/references/palette-create.md diff --git a/skills/create-tile-palette-or-rule-tiles/references/ruletile-createempty.md b/skills/using-unity/references/create-tile-palette-or-rule-tiles/references/ruletile-createempty.md similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/references/ruletile-createempty.md rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/references/ruletile-createempty.md diff --git a/skills/create-tile-palette-or-rule-tiles/references/ruletile-createfromsegment.md b/skills/using-unity/references/create-tile-palette-or-rule-tiles/references/ruletile-createfromsegment.md similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/references/ruletile-createfromsegment.md rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/references/ruletile-createfromsegment.md diff --git a/skills/create-tile-palette-or-rule-tiles/references/ruletile.md b/skills/using-unity/references/create-tile-palette-or-rule-tiles/references/ruletile.md similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/references/ruletile.md rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/references/ruletile.md diff --git a/skills/create-tile-palette-or-rule-tiles/scripts/CreatePaletteTemplate.cs b/skills/using-unity/references/create-tile-palette-or-rule-tiles/scripts/CreatePaletteTemplate.cs similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/scripts/CreatePaletteTemplate.cs rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/scripts/CreatePaletteTemplate.cs diff --git a/skills/create-tile-palette-or-rule-tiles/scripts/ManualWorkflowExample.cs b/skills/using-unity/references/create-tile-palette-or-rule-tiles/scripts/ManualWorkflowExample.cs similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/scripts/ManualWorkflowExample.cs rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/scripts/ManualWorkflowExample.cs diff --git a/skills/create-tile-palette-or-rule-tiles/scripts/RuleTileGenerator.cs b/skills/using-unity/references/create-tile-palette-or-rule-tiles/scripts/RuleTileGenerator.cs similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/scripts/RuleTileGenerator.cs rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/scripts/RuleTileGenerator.cs diff --git a/skills/create-tile-palette-or-rule-tiles/scripts/TilemapRuleTileCreateFromSegment.cs b/skills/using-unity/references/create-tile-palette-or-rule-tiles/scripts/TilemapRuleTileCreateFromSegment.cs similarity index 100% rename from skills/create-tile-palette-or-rule-tiles/scripts/TilemapRuleTileCreateFromSegment.cs rename to skills/using-unity/references/create-tile-palette-or-rule-tiles/scripts/TilemapRuleTileCreateFromSegment.cs diff --git a/skills/create-xr/SECURITY.md b/skills/using-unity/references/create-xr/SECURITY.md similarity index 100% rename from skills/create-xr/SECURITY.md rename to skills/using-unity/references/create-xr/SECURITY.md diff --git a/skills/create-xr/SKILL.md b/skills/using-unity/references/create-xr/create-xr.md similarity index 100% rename from skills/create-xr/SKILL.md rename to skills/using-unity/references/create-xr/create-xr.md diff --git a/skills/create-xr/references/eval-guide.md b/skills/using-unity/references/create-xr/references/eval-guide.md similarity index 100% rename from skills/create-xr/references/eval-guide.md rename to skills/using-unity/references/create-xr/references/eval-guide.md diff --git a/skills/create-xr/references/meta-graphics-setup.md b/skills/using-unity/references/create-xr/references/meta-graphics-setup.md similarity index 100% rename from skills/create-xr/references/meta-graphics-setup.md rename to skills/using-unity/references/create-xr/references/meta-graphics-setup.md diff --git a/skills/create-xr/references/rig-pitfalls.md b/skills/using-unity/references/create-xr/references/rig-pitfalls.md similarity index 100% rename from skills/create-xr/references/rig-pitfalls.md rename to skills/using-unity/references/create-xr/references/rig-pitfalls.md diff --git a/skills/create-xr/references/rig-recipes.md b/skills/using-unity/references/create-xr/references/rig-recipes.md similarity index 100% rename from skills/create-xr/references/rig-recipes.md rename to skills/using-unity/references/create-xr/references/rig-recipes.md diff --git a/skills/create-xr/references/rig-structure.md b/skills/using-unity/references/create-xr/references/rig-structure.md similarity index 100% rename from skills/create-xr/references/rig-structure.md rename to skills/using-unity/references/create-xr/references/rig-structure.md diff --git a/skills/create-xr/references/rig.md b/skills/using-unity/references/create-xr/references/rig.md similarity index 100% rename from skills/create-xr/references/rig.md rename to skills/using-unity/references/create-xr/references/rig.md diff --git a/skills/create-xr/references/setup-manual.md b/skills/using-unity/references/create-xr/references/setup-manual.md similarity index 100% rename from skills/create-xr/references/setup-manual.md rename to skills/using-unity/references/create-xr/references/setup-manual.md diff --git a/skills/create-xr/references/setup.md b/skills/using-unity/references/create-xr/references/setup.md similarity index 100% rename from skills/create-xr/references/setup.md rename to skills/using-unity/references/create-xr/references/setup.md diff --git a/skills/create-xr/scripts/_eval.sh b/skills/using-unity/references/create-xr/scripts/_eval.sh similarity index 100% rename from skills/create-xr/scripts/_eval.sh rename to skills/using-unity/references/create-xr/scripts/_eval.sh diff --git a/skills/create-xr/scripts/dependency/com.unity.pipeline/0.10.sh b/skills/using-unity/references/create-xr/scripts/dependency/com.unity.pipeline/0.10.sh similarity index 100% rename from skills/create-xr/scripts/dependency/com.unity.pipeline/0.10.sh rename to skills/using-unity/references/create-xr/scripts/dependency/com.unity.pipeline/0.10.sh diff --git a/skills/create-xr/scripts/dependency/com.unity.pipeline/0.9.sh b/skills/using-unity/references/create-xr/scripts/dependency/com.unity.pipeline/0.9.sh similarity index 100% rename from skills/create-xr/scripts/dependency/com.unity.pipeline/0.9.sh rename to skills/using-unity/references/create-xr/scripts/dependency/com.unity.pipeline/0.9.sh diff --git a/skills/create-xr/scripts/dependency/com.unity.pipeline/1.0.sh b/skills/using-unity/references/create-xr/scripts/dependency/com.unity.pipeline/1.0.sh similarity index 100% rename from skills/create-xr/scripts/dependency/com.unity.pipeline/1.0.sh rename to skills/using-unity/references/create-xr/scripts/dependency/com.unity.pipeline/1.0.sh diff --git a/skills/create-xr/scripts/dependency/com.unity.pipeline/FALLBACK b/skills/using-unity/references/create-xr/scripts/dependency/com.unity.pipeline/FALLBACK similarity index 100% rename from skills/create-xr/scripts/dependency/com.unity.pipeline/FALLBACK rename to skills/using-unity/references/create-xr/scripts/dependency/com.unity.pipeline/FALLBACK diff --git a/skills/create-xr/scripts/dependency/com.unity.xr.androidxr-openxr/1.0.sh b/skills/using-unity/references/create-xr/scripts/dependency/com.unity.xr.androidxr-openxr/1.0.sh similarity index 100% rename from skills/create-xr/scripts/dependency/com.unity.xr.androidxr-openxr/1.0.sh rename to skills/using-unity/references/create-xr/scripts/dependency/com.unity.xr.androidxr-openxr/1.0.sh diff --git a/skills/create-xr/scripts/dependency/com.unity.xr.hands/1.9.sh b/skills/using-unity/references/create-xr/scripts/dependency/com.unity.xr.hands/1.9.sh similarity index 100% rename from skills/create-xr/scripts/dependency/com.unity.xr.hands/1.9.sh rename to skills/using-unity/references/create-xr/scripts/dependency/com.unity.xr.hands/1.9.sh diff --git a/skills/create-xr/scripts/dependency/com.unity.xr.management/4.7.sh b/skills/using-unity/references/create-xr/scripts/dependency/com.unity.xr.management/4.7.sh similarity index 100% rename from skills/create-xr/scripts/dependency/com.unity.xr.management/4.7.sh rename to skills/using-unity/references/create-xr/scripts/dependency/com.unity.xr.management/4.7.sh diff --git a/skills/create-xr/scripts/dependency/com.unity.xr.openxr/1.19.sh b/skills/using-unity/references/create-xr/scripts/dependency/com.unity.xr.openxr/1.19.sh similarity index 100% rename from skills/create-xr/scripts/dependency/com.unity.xr.openxr/1.19.sh rename to skills/using-unity/references/create-xr/scripts/dependency/com.unity.xr.openxr/1.19.sh diff --git a/skills/create-xr/scripts/dependency/unity-cli/1.0.0-beta.14.sh b/skills/using-unity/references/create-xr/scripts/dependency/unity-cli/1.0.0-beta.14.sh similarity index 100% rename from skills/create-xr/scripts/dependency/unity-cli/1.0.0-beta.14.sh rename to skills/using-unity/references/create-xr/scripts/dependency/unity-cli/1.0.0-beta.14.sh diff --git a/skills/create-xr/scripts/dependency/unity-cli/1.0.0-beta.8.sh b/skills/using-unity/references/create-xr/scripts/dependency/unity-cli/1.0.0-beta.8.sh similarity index 100% rename from skills/create-xr/scripts/dependency/unity-cli/1.0.0-beta.8.sh rename to skills/using-unity/references/create-xr/scripts/dependency/unity-cli/1.0.0-beta.8.sh diff --git a/skills/create-xr/scripts/dependency/unity/6000.0.sh b/skills/using-unity/references/create-xr/scripts/dependency/unity/6000.0.sh similarity index 100% rename from skills/create-xr/scripts/dependency/unity/6000.0.sh rename to skills/using-unity/references/create-xr/scripts/dependency/unity/6000.0.sh diff --git a/skills/create-xr/scripts/meta-graphics/check.sh b/skills/using-unity/references/create-xr/scripts/meta-graphics/check.sh similarity index 100% rename from skills/create-xr/scripts/meta-graphics/check.sh rename to skills/using-unity/references/create-xr/scripts/meta-graphics/check.sh diff --git a/skills/create-xr/scripts/meta-graphics/meta-graphics-setup.sh b/skills/using-unity/references/create-xr/scripts/meta-graphics/meta-graphics-setup.sh similarity index 100% rename from skills/create-xr/scripts/meta-graphics/meta-graphics-setup.sh rename to skills/using-unity/references/create-xr/scripts/meta-graphics/meta-graphics-setup.sh diff --git a/skills/create-xr/scripts/pipeline_check.sh b/skills/using-unity/references/create-xr/scripts/pipeline_check.sh similarity index 100% rename from skills/create-xr/scripts/pipeline_check.sh rename to skills/using-unity/references/create-xr/scripts/pipeline_check.sh diff --git a/skills/create-xr/scripts/setup/1_modules.sh b/skills/using-unity/references/create-xr/scripts/setup/1_modules.sh similarity index 100% rename from skills/create-xr/scripts/setup/1_modules.sh rename to skills/using-unity/references/create-xr/scripts/setup/1_modules.sh diff --git a/skills/create-xr/scripts/setup/2_packages.sh b/skills/using-unity/references/create-xr/scripts/setup/2_packages.sh similarity index 100% rename from skills/create-xr/scripts/setup/2_packages.sh rename to skills/using-unity/references/create-xr/scripts/setup/2_packages.sh diff --git a/skills/create-xr/scripts/setup/3_build_profile.sh b/skills/using-unity/references/create-xr/scripts/setup/3_build_profile.sh similarity index 100% rename from skills/create-xr/scripts/setup/3_build_profile.sh rename to skills/using-unity/references/create-xr/scripts/setup/3_build_profile.sh diff --git a/skills/create-xr/scripts/setup/4_openxr.sh b/skills/using-unity/references/create-xr/scripts/setup/4_openxr.sh similarity index 100% rename from skills/create-xr/scripts/setup/4_openxr.sh rename to skills/using-unity/references/create-xr/scripts/setup/4_openxr.sh diff --git a/skills/create-xr/scripts/setup/5_player_settings.sh b/skills/using-unity/references/create-xr/scripts/setup/5_player_settings.sh similarity index 100% rename from skills/create-xr/scripts/setup/5_player_settings.sh rename to skills/using-unity/references/create-xr/scripts/setup/5_player_settings.sh diff --git a/skills/create-xr/scripts/setup/6_validate.sh b/skills/using-unity/references/create-xr/scripts/setup/6_validate.sh similarity index 100% rename from skills/create-xr/scripts/setup/6_validate.sh rename to skills/using-unity/references/create-xr/scripts/setup/6_validate.sh diff --git a/skills/create-xr/scripts/setup/_lib.sh b/skills/using-unity/references/create-xr/scripts/setup/_lib.sh similarity index 100% rename from skills/create-xr/scripts/setup/_lib.sh rename to skills/using-unity/references/create-xr/scripts/setup/_lib.sh diff --git a/skills/create-xr/scripts/setup/check.sh b/skills/using-unity/references/create-xr/scripts/setup/check.sh similarity index 100% rename from skills/create-xr/scripts/setup/check.sh rename to skills/using-unity/references/create-xr/scripts/setup/check.sh diff --git a/skills/create-xr/scripts/setup/setup.sh b/skills/using-unity/references/create-xr/scripts/setup/setup.sh similarity index 100% rename from skills/create-xr/scripts/setup/setup.sh rename to skills/using-unity/references/create-xr/scripts/setup/setup.sh diff --git a/skills/create-xr/scripts/status.sh b/skills/using-unity/references/create-xr/scripts/status.sh similarity index 100% rename from skills/create-xr/scripts/status.sh rename to skills/using-unity/references/create-xr/scripts/status.sh diff --git a/skills/fix-3d-physics-collisions/SECURITY.md b/skills/using-unity/references/fix-3d-physics-collisions/SECURITY.md similarity index 100% rename from skills/fix-3d-physics-collisions/SECURITY.md rename to skills/using-unity/references/fix-3d-physics-collisions/SECURITY.md diff --git a/skills/fix-3d-physics-collisions/SKILL.md b/skills/using-unity/references/fix-3d-physics-collisions/fix-3d-physics-collisions.md similarity index 100% rename from skills/fix-3d-physics-collisions/SKILL.md rename to skills/using-unity/references/fix-3d-physics-collisions/fix-3d-physics-collisions.md diff --git a/skills/fix-3d-physics-collisions/references/collision-checklist.md b/skills/using-unity/references/fix-3d-physics-collisions/references/collision-checklist.md similarity index 100% rename from skills/fix-3d-physics-collisions/references/collision-checklist.md rename to skills/using-unity/references/fix-3d-physics-collisions/references/collision-checklist.md diff --git a/skills/fix-3d-physics-collisions/references/collision-debugger.md b/skills/using-unity/references/fix-3d-physics-collisions/references/collision-debugger.md similarity index 100% rename from skills/fix-3d-physics-collisions/references/collision-debugger.md rename to skills/using-unity/references/fix-3d-physics-collisions/references/collision-debugger.md diff --git a/skills/fix-3d-physics-collisions/references/other-symptoms.md b/skills/using-unity/references/fix-3d-physics-collisions/references/other-symptoms.md similarity index 100% rename from skills/fix-3d-physics-collisions/references/other-symptoms.md rename to skills/using-unity/references/fix-3d-physics-collisions/references/other-symptoms.md diff --git a/skills/fix-3d-physics-collisions/references/raycast-checklist.md b/skills/using-unity/references/fix-3d-physics-collisions/references/raycast-checklist.md similarity index 100% rename from skills/fix-3d-physics-collisions/references/raycast-checklist.md rename to skills/using-unity/references/fix-3d-physics-collisions/references/raycast-checklist.md diff --git a/skills/fix-3d-physics-collisions/references/trigger-checklist.md b/skills/using-unity/references/fix-3d-physics-collisions/references/trigger-checklist.md similarity index 100% rename from skills/fix-3d-physics-collisions/references/trigger-checklist.md rename to skills/using-unity/references/fix-3d-physics-collisions/references/trigger-checklist.md diff --git a/skills/fix-3d-physics-collisions/scripts/CollisionDebugger.cs b/skills/using-unity/references/fix-3d-physics-collisions/scripts/CollisionDebugger.cs similarity index 100% rename from skills/fix-3d-physics-collisions/scripts/CollisionDebugger.cs rename to skills/using-unity/references/fix-3d-physics-collisions/scripts/CollisionDebugger.cs diff --git a/skills/generate-editor-search-query/SECURITY.md b/skills/using-unity/references/generate-editor-search-query/SECURITY.md similarity index 100% rename from skills/generate-editor-search-query/SECURITY.md rename to skills/using-unity/references/generate-editor-search-query/SECURITY.md diff --git a/skills/generate-editor-search-query/SKILL.md b/skills/using-unity/references/generate-editor-search-query/generate-editor-search-query.md similarity index 100% rename from skills/generate-editor-search-query/SKILL.md rename to skills/using-unity/references/generate-editor-search-query/generate-editor-search-query.md diff --git a/skills/generate-editor-search-query/references/open-search-window.md b/skills/using-unity/references/generate-editor-search-query/references/open-search-window.md similarity index 100% rename from skills/generate-editor-search-query/references/open-search-window.md rename to skills/using-unity/references/generate-editor-search-query/references/open-search-window.md diff --git a/skills/generate-editor-search-query/references/query-patterns.md b/skills/using-unity/references/generate-editor-search-query/references/query-patterns.md similarity index 100% rename from skills/generate-editor-search-query/references/query-patterns.md rename to skills/using-unity/references/generate-editor-search-query/references/query-patterns.md diff --git a/skills/implement-in-app-purchases/SKILL.md b/skills/using-unity/references/implement-in-app-purchases/implement-in-app-purchases.md similarity index 100% rename from skills/implement-in-app-purchases/SKILL.md rename to skills/using-unity/references/implement-in-app-purchases/implement-in-app-purchases.md diff --git a/skills/implement-in-app-purchases/references/api-notes.md b/skills/using-unity/references/implement-in-app-purchases/references/api-notes.md similarity index 100% rename from skills/implement-in-app-purchases/references/api-notes.md rename to skills/using-unity/references/implement-in-app-purchases/references/api-notes.md diff --git a/skills/implement-in-app-purchases/references/codeless-catalog.md b/skills/using-unity/references/implement-in-app-purchases/references/codeless-catalog.md similarity index 100% rename from skills/implement-in-app-purchases/references/codeless-catalog.md rename to skills/using-unity/references/implement-in-app-purchases/references/codeless-catalog.md diff --git a/skills/implement-in-app-purchases/references/convert-adapty.md b/skills/using-unity/references/implement-in-app-purchases/references/convert-adapty.md similarity index 100% rename from skills/implement-in-app-purchases/references/convert-adapty.md rename to skills/using-unity/references/implement-in-app-purchases/references/convert-adapty.md diff --git a/skills/implement-in-app-purchases/references/convert-essentialkit.md b/skills/using-unity/references/implement-in-app-purchases/references/convert-essentialkit.md similarity index 100% rename from skills/implement-in-app-purchases/references/convert-essentialkit.md rename to skills/using-unity/references/implement-in-app-purchases/references/convert-essentialkit.md diff --git a/skills/implement-in-app-purchases/references/convert-revenuecat.md b/skills/using-unity/references/implement-in-app-purchases/references/convert-revenuecat.md similarity index 100% rename from skills/implement-in-app-purchases/references/convert-revenuecat.md rename to skills/using-unity/references/implement-in-app-purchases/references/convert-revenuecat.md diff --git a/skills/implement-in-app-purchases/references/convert-unipay.md b/skills/using-unity/references/implement-in-app-purchases/references/convert-unipay.md similarity index 100% rename from skills/implement-in-app-purchases/references/convert-unipay.md rename to skills/using-unity/references/implement-in-app-purchases/references/convert-unipay.md diff --git a/skills/implement-in-app-purchases/references/migration-v4-to-v5.md b/skills/using-unity/references/implement-in-app-purchases/references/migration-v4-to-v5.md similarity index 100% rename from skills/implement-in-app-purchases/references/migration-v4-to-v5.md rename to skills/using-unity/references/implement-in-app-purchases/references/migration-v4-to-v5.md diff --git a/skills/implement-in-app-purchases/references/path-add-iap-to-new-project.md b/skills/using-unity/references/implement-in-app-purchases/references/path-add-iap-to-new-project.md similarity index 100% rename from skills/implement-in-app-purchases/references/path-add-iap-to-new-project.md rename to skills/using-unity/references/implement-in-app-purchases/references/path-add-iap-to-new-project.md diff --git a/skills/implement-in-app-purchases/references/path-convert-native-google-billing.md b/skills/using-unity/references/implement-in-app-purchases/references/path-convert-native-google-billing.md similarity index 100% rename from skills/implement-in-app-purchases/references/path-convert-native-google-billing.md rename to skills/using-unity/references/implement-in-app-purchases/references/path-convert-native-google-billing.md diff --git a/skills/implement-in-app-purchases/references/path-convert-native-storekit.md b/skills/using-unity/references/implement-in-app-purchases/references/path-convert-native-storekit.md similarity index 100% rename from skills/implement-in-app-purchases/references/path-convert-native-storekit.md rename to skills/using-unity/references/implement-in-app-purchases/references/path-convert-native-storekit.md diff --git a/skills/implement-in-app-purchases/references/path-implement-iap-d2c.md b/skills/using-unity/references/implement-in-app-purchases/references/path-implement-iap-d2c.md similarity index 100% rename from skills/implement-in-app-purchases/references/path-implement-iap-d2c.md rename to skills/using-unity/references/implement-in-app-purchases/references/path-implement-iap-d2c.md diff --git a/skills/implement-in-app-purchases/references/platform-notes.md b/skills/using-unity/references/implement-in-app-purchases/references/platform-notes.md similarity index 100% rename from skills/implement-in-app-purchases/references/platform-notes.md rename to skills/using-unity/references/implement-in-app-purchases/references/platform-notes.md diff --git a/skills/implement-in-app-purchases/references/pre-check.md b/skills/using-unity/references/implement-in-app-purchases/references/pre-check.md similarity index 100% rename from skills/implement-in-app-purchases/references/pre-check.md rename to skills/using-unity/references/implement-in-app-purchases/references/pre-check.md diff --git a/skills/initialize-ai-navigation/SKILL.md b/skills/using-unity/references/initialize-ai-navigation/initialize-ai-navigation.md similarity index 100% rename from skills/initialize-ai-navigation/SKILL.md rename to skills/using-unity/references/initialize-ai-navigation/initialize-ai-navigation.md diff --git a/skills/initialize-ai-navigation/references/navigation-system.md b/skills/using-unity/references/initialize-ai-navigation/references/navigation-system.md similarity index 100% rename from skills/initialize-ai-navigation/references/navigation-system.md rename to skills/using-unity/references/initialize-ai-navigation/references/navigation-system.md diff --git a/skills/levelplay-unity-integration/SKILL.md b/skills/using-unity/references/levelplay-unity-integration/levelplay-unity-integration.md similarity index 100% rename from skills/levelplay-unity-integration/SKILL.md rename to skills/using-unity/references/levelplay-unity-integration/levelplay-unity-integration.md diff --git a/skills/levelplay-unity-integration/references/banner-api.md b/skills/using-unity/references/levelplay-unity-integration/references/banner-api.md similarity index 100% rename from skills/levelplay-unity-integration/references/banner-api.md rename to skills/using-unity/references/levelplay-unity-integration/references/banner-api.md diff --git a/skills/levelplay-unity-integration/references/best-practices.md b/skills/using-unity/references/levelplay-unity-integration/references/best-practices.md similarity index 100% rename from skills/levelplay-unity-integration/references/best-practices.md rename to skills/using-unity/references/levelplay-unity-integration/references/best-practices.md diff --git a/skills/levelplay-unity-integration/references/dependency-resolution.md b/skills/using-unity/references/levelplay-unity-integration/references/dependency-resolution.md similarity index 100% rename from skills/levelplay-unity-integration/references/dependency-resolution.md rename to skills/using-unity/references/levelplay-unity-integration/references/dependency-resolution.md diff --git a/skills/levelplay-unity-integration/references/ilrd-api.md b/skills/using-unity/references/levelplay-unity-integration/references/ilrd-api.md similarity index 100% rename from skills/levelplay-unity-integration/references/ilrd-api.md rename to skills/using-unity/references/levelplay-unity-integration/references/ilrd-api.md diff --git a/skills/levelplay-unity-integration/references/initialization-api.md b/skills/using-unity/references/levelplay-unity-integration/references/initialization-api.md similarity index 100% rename from skills/levelplay-unity-integration/references/initialization-api.md rename to skills/using-unity/references/levelplay-unity-integration/references/initialization-api.md diff --git a/skills/levelplay-unity-integration/references/interstitial-api.md b/skills/using-unity/references/levelplay-unity-integration/references/interstitial-api.md similarity index 100% rename from skills/levelplay-unity-integration/references/interstitial-api.md rename to skills/using-unity/references/levelplay-unity-integration/references/interstitial-api.md diff --git a/skills/levelplay-unity-integration/references/ios-setup.md b/skills/using-unity/references/levelplay-unity-integration/references/ios-setup.md similarity index 100% rename from skills/levelplay-unity-integration/references/ios-setup.md rename to skills/using-unity/references/levelplay-unity-integration/references/ios-setup.md diff --git a/skills/levelplay-unity-integration/references/migration-sdk-9.md b/skills/using-unity/references/levelplay-unity-integration/references/migration-sdk-9.md similarity index 100% rename from skills/levelplay-unity-integration/references/migration-sdk-9.md rename to skills/using-unity/references/levelplay-unity-integration/references/migration-sdk-9.md diff --git a/skills/levelplay-unity-integration/references/privacy-settings.md b/skills/using-unity/references/levelplay-unity-integration/references/privacy-settings.md similarity index 100% rename from skills/levelplay-unity-integration/references/privacy-settings.md rename to skills/using-unity/references/levelplay-unity-integration/references/privacy-settings.md diff --git a/skills/levelplay-unity-integration/references/rewarded-api.md b/skills/using-unity/references/levelplay-unity-integration/references/rewarded-api.md similarity index 100% rename from skills/levelplay-unity-integration/references/rewarded-api.md rename to skills/using-unity/references/levelplay-unity-integration/references/rewarded-api.md diff --git a/skills/levelplay-unity-integration/references/testing-and-validation.md b/skills/using-unity/references/levelplay-unity-integration/references/testing-and-validation.md similarity index 100% rename from skills/levelplay-unity-integration/references/testing-and-validation.md rename to skills/using-unity/references/levelplay-unity-integration/references/testing-and-validation.md diff --git a/skills/levelplay-unity-integration/references/troubleshooting.md b/skills/using-unity/references/levelplay-unity-integration/references/troubleshooting.md similarity index 100% rename from skills/levelplay-unity-integration/references/troubleshooting.md rename to skills/using-unity/references/levelplay-unity-integration/references/troubleshooting.md diff --git a/skills/localize-unity-project/SKILL.md b/skills/using-unity/references/localize-unity-project/localize-unity-project.md similarity index 100% rename from skills/localize-unity-project/SKILL.md rename to skills/using-unity/references/localize-unity-project/localize-unity-project.md diff --git a/skills/localize-unity-project/references/api-notes.md b/skills/using-unity/references/localize-unity-project/references/api-notes.md similarity index 100% rename from skills/localize-unity-project/references/api-notes.md rename to skills/using-unity/references/localize-unity-project/references/api-notes.md diff --git a/skills/localize-unity-project/references/cjk-fonts.md b/skills/using-unity/references/localize-unity-project/references/cjk-fonts.md similarity index 100% rename from skills/localize-unity-project/references/cjk-fonts.md rename to skills/using-unity/references/localize-unity-project/references/cjk-fonts.md diff --git a/skills/localize-unity-project/references/docs-map.md b/skills/using-unity/references/localize-unity-project/references/docs-map.md similarity index 100% rename from skills/localize-unity-project/references/docs-map.md rename to skills/using-unity/references/localize-unity-project/references/docs-map.md diff --git a/skills/localize-unity-project/references/table-completeness-check.md b/skills/using-unity/references/localize-unity-project/references/table-completeness-check.md similarity index 100% rename from skills/localize-unity-project/references/table-completeness-check.md rename to skills/using-unity/references/localize-unity-project/references/table-completeness-check.md diff --git a/skills/localize-unity-project/references/translation-strategy.md b/skills/using-unity/references/localize-unity-project/references/translation-strategy.md similarity index 100% rename from skills/localize-unity-project/references/translation-strategy.md rename to skills/using-unity/references/localize-unity-project/references/translation-strategy.md diff --git a/skills/localize-unity-project/references/troubleshooting.md b/skills/using-unity/references/localize-unity-project/references/troubleshooting.md similarity index 100% rename from skills/localize-unity-project/references/troubleshooting.md rename to skills/using-unity/references/localize-unity-project/references/troubleshooting.md diff --git a/skills/localize-unity-project/scripts/L10nBatchProcessor.cs b/skills/using-unity/references/localize-unity-project/scripts/L10nBatchProcessor.cs similarity index 100% rename from skills/localize-unity-project/scripts/L10nBatchProcessor.cs rename to skills/using-unity/references/localize-unity-project/scripts/L10nBatchProcessor.cs diff --git a/skills/localize-unity-project/scripts/LocalizedFontAsset.cs b/skills/using-unity/references/localize-unity-project/scripts/LocalizedFontAsset.cs similarity index 100% rename from skills/localize-unity-project/scripts/LocalizedFontAsset.cs rename to skills/using-unity/references/localize-unity-project/scripts/LocalizedFontAsset.cs diff --git a/skills/manage-sprite-atlas/SKILL.md b/skills/using-unity/references/manage-sprite-atlas/manage-sprite-atlas.md similarity index 100% rename from skills/manage-sprite-atlas/SKILL.md rename to skills/using-unity/references/manage-sprite-atlas/manage-sprite-atlas.md diff --git a/skills/manage-sprite-atlas/references/addressables-delivery.md b/skills/using-unity/references/manage-sprite-atlas/references/addressables-delivery.md similarity index 100% rename from skills/manage-sprite-atlas/references/addressables-delivery.md rename to skills/using-unity/references/manage-sprite-atlas/references/addressables-delivery.md diff --git a/skills/manage-sprite-atlas/references/api.md b/skills/using-unity/references/manage-sprite-atlas/references/api.md similarity index 100% rename from skills/manage-sprite-atlas/references/api.md rename to skills/using-unity/references/manage-sprite-atlas/references/api.md diff --git a/skills/manage-sprite-atlas/references/best-practices.md b/skills/using-unity/references/manage-sprite-atlas/references/best-practices.md similarity index 100% rename from skills/manage-sprite-atlas/references/best-practices.md rename to skills/using-unity/references/manage-sprite-atlas/references/best-practices.md diff --git a/skills/manage-sprite-atlas/references/common-errors.md b/skills/using-unity/references/manage-sprite-atlas/references/common-errors.md similarity index 100% rename from skills/manage-sprite-atlas/references/common-errors.md rename to skills/using-unity/references/manage-sprite-atlas/references/common-errors.md diff --git a/skills/manage-sprite-atlas/references/custom-packing.md b/skills/using-unity/references/manage-sprite-atlas/references/custom-packing.md similarity index 100% rename from skills/manage-sprite-atlas/references/custom-packing.md rename to skills/using-unity/references/manage-sprite-atlas/references/custom-packing.md diff --git a/skills/manage-sprite-atlas/references/manual-authoring.md b/skills/using-unity/references/manage-sprite-atlas/references/manual-authoring.md similarity index 100% rename from skills/manage-sprite-atlas/references/manual-authoring.md rename to skills/using-unity/references/manage-sprite-atlas/references/manual-authoring.md diff --git a/skills/manage-sprite-atlas/resources/authoringvsruntime.cs b/skills/using-unity/references/manage-sprite-atlas/resources/authoringvsruntime.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/authoringvsruntime.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/authoringvsruntime.cs diff --git a/skills/manage-sprite-atlas/resources/buildaddressablespostprocess.cs b/skills/using-unity/references/manage-sprite-atlas/resources/buildaddressablespostprocess.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/buildaddressablespostprocess.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/buildaddressablespostprocess.cs diff --git a/skills/manage-sprite-atlas/resources/cacheloadedatlases.cs b/skills/using-unity/references/manage-sprite-atlas/resources/cacheloadedatlases.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/cacheloadedatlases.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/cacheloadedatlases.cs diff --git a/skills/manage-sprite-atlas/resources/cleanupbatchoperations.cs b/skills/using-unity/references/manage-sprite-atlas/resources/cleanupbatchoperations.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/cleanupbatchoperations.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/cleanupbatchoperations.cs diff --git a/skills/manage-sprite-atlas/resources/createandconfiguremasteratlas.cs b/skills/using-unity/references/manage-sprite-atlas/resources/createandconfiguremasteratlas.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/createandconfiguremasteratlas.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/createandconfiguremasteratlas.cs diff --git a/skills/manage-sprite-atlas/resources/custompackersetup.cs b/skills/using-unity/references/manage-sprite-atlas/resources/custompackersetup.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/custompackersetup.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/custompackersetup.cs diff --git a/skills/manage-sprite-atlas/resources/deprecatedmethods.cs b/skills/using-unity/references/manage-sprite-atlas/resources/deprecatedmethods.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/deprecatedmethods.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/deprecatedmethods.cs diff --git a/skills/manage-sprite-atlas/resources/dontmodifywithoutsaving.cs b/skills/using-unity/references/manage-sprite-atlas/resources/dontmodifywithoutsaving.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/dontmodifywithoutsaving.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/dontmodifywithoutsaving.cs diff --git a/skills/manage-sprite-atlas/resources/dontpackinruntimebuilds.cs b/skills/using-unity/references/manage-sprite-atlas/resources/dontpackinruntimebuilds.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/dontpackinruntimebuilds.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/dontpackinruntimebuilds.cs diff --git a/skills/manage-sprite-atlas/resources/dontscriptspriteatlasineditor.cs b/skills/using-unity/references/manage-sprite-atlas/resources/dontscriptspriteatlasineditor.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/dontscriptspriteatlasineditor.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/dontscriptspriteatlasineditor.cs diff --git a/skills/manage-sprite-atlas/resources/editorconfiguration.cs b/skills/using-unity/references/manage-sprite-atlas/resources/editorconfiguration.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/editorconfiguration.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/editorconfiguration.cs diff --git a/skills/manage-sprite-atlas/resources/enablespritepacking.cs b/skills/using-unity/references/manage-sprite-atlas/resources/enablespritepacking.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/enablespritepacking.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/enablespritepacking.cs diff --git a/skills/manage-sprite-atlas/resources/gridspritepacker.cs b/skills/using-unity/references/manage-sprite-atlas/resources/gridspritepacker.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/gridspritepacker.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/gridspritepacker.cs diff --git a/skills/manage-sprite-atlas/resources/handlelatebinding.cs b/skills/using-unity/references/manage-sprite-atlas/resources/handlelatebinding.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/handlelatebinding.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/handlelatebinding.cs diff --git a/skills/manage-sprite-atlas/resources/handlenullcases.cs b/skills/using-unity/references/manage-sprite-atlas/resources/handlenullcases.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/handlenullcases.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/handlenullcases.cs diff --git a/skills/manage-sprite-atlas/resources/migratev1tov2.cs b/skills/using-unity/references/manage-sprite-atlas/resources/migratev1tov2.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/migratev1tov2.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/migratev1tov2.cs diff --git a/skills/manage-sprite-atlas/resources/multipagepacker.cs b/skills/using-unity/references/manage-sprite-atlas/resources/multipagepacker.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/multipagepacker.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/multipagepacker.cs diff --git a/skills/manage-sprite-atlas/resources/optimizetexturesettings.cs b/skills/using-unity/references/manage-sprite-atlas/resources/optimizetexturesettings.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/optimizetexturesettings.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/optimizetexturesettings.cs diff --git a/skills/manage-sprite-atlas/resources/packerdebugging.cs b/skills/using-unity/references/manage-sprite-atlas/resources/packerdebugging.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/packerdebugging.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/packerdebugging.cs diff --git a/skills/manage-sprite-atlas/resources/packtransform.cs b/skills/using-unity/references/manage-sprite-atlas/resources/packtransform.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/packtransform.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/packtransform.cs diff --git a/skills/manage-sprite-atlas/resources/platformnames.cs b/skills/using-unity/references/manage-sprite-atlas/resources/platformnames.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/platformnames.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/platformnames.cs diff --git a/skills/manage-sprite-atlas/resources/queryspritesefficiently.cs b/skills/using-unity/references/manage-sprite-atlas/resources/queryspritesefficiently.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/queryspritesefficiently.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/queryspritesefficiently.cs diff --git a/skills/manage-sprite-atlas/resources/registercallbacks.cs b/skills/using-unity/references/manage-sprite-atlas/resources/registercallbacks.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/registercallbacks.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/registercallbacks.cs diff --git a/skills/manage-sprite-atlas/resources/runtimeatlasloader.cs b/skills/using-unity/references/manage-sprite-atlas/resources/runtimeatlasloader.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/runtimeatlasloader.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/runtimeatlasloader.cs diff --git a/skills/manage-sprite-atlas/resources/runtimespriteaccess.cs b/skills/using-unity/references/manage-sprite-atlas/resources/runtimespriteaccess.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/runtimespriteaccess.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/runtimespriteaccess.cs diff --git a/skills/manage-sprite-atlas/resources/savespriteatlasasset.cs b/skills/using-unity/references/manage-sprite-atlas/resources/savespriteatlasasset.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/savespriteatlasasset.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/savespriteatlasasset.cs diff --git a/skills/manage-sprite-atlas/resources/scriptablepacker.cs b/skills/using-unity/references/manage-sprite-atlas/resources/scriptablepacker.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/scriptablepacker.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/scriptablepacker.cs diff --git a/skills/manage-sprite-atlas/resources/setincludeinbuild.cs b/skills/using-unity/references/manage-sprite-atlas/resources/setincludeinbuild.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/setincludeinbuild.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/setincludeinbuild.cs diff --git a/skills/manage-sprite-atlas/resources/sizeoptimizedpacker.cs b/skills/using-unity/references/manage-sprite-atlas/resources/sizeoptimizedpacker.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/sizeoptimizedpacker.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/sizeoptimizedpacker.cs diff --git a/skills/manage-sprite-atlas/resources/spriteatlaslatebinding.cs b/skills/using-unity/references/manage-sprite-atlas/resources/spriteatlaslatebinding.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/spriteatlaslatebinding.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/spriteatlaslatebinding.cs diff --git a/skills/manage-sprite-atlas/resources/spriteatlasprebuildgenerator.cs b/skills/using-unity/references/manage-sprite-atlas/resources/spriteatlasprebuildgenerator.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/spriteatlasprebuildgenerator.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/spriteatlasprebuildgenerator.cs diff --git a/skills/manage-sprite-atlas/resources/spritedata.cs b/skills/using-unity/references/manage-sprite-atlas/resources/spritedata.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/spritedata.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/spritedata.cs diff --git a/skills/manage-sprite-atlas/resources/spritepack.cs b/skills/using-unity/references/manage-sprite-atlas/resources/spritepack.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/spritepack.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/spritepack.cs diff --git a/skills/manage-sprite-atlas/resources/texturedata.cs b/skills/using-unity/references/manage-sprite-atlas/resources/texturedata.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/texturedata.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/texturedata.cs diff --git a/skills/manage-sprite-atlas/resources/updatebuildscripts.cs b/skills/using-unity/references/manage-sprite-atlas/resources/updatebuildscripts.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/updatebuildscripts.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/updatebuildscripts.cs diff --git a/skills/manage-sprite-atlas/resources/updatesettingsconfiguration.cs b/skills/using-unity/references/manage-sprite-atlas/resources/updatesettingsconfiguration.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/updatesettingsconfiguration.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/updatesettingsconfiguration.cs diff --git a/skills/manage-sprite-atlas/resources/usevariantswisely.cs b/skills/using-unity/references/manage-sprite-atlas/resources/usevariantswisely.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/usevariantswisely.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/usevariantswisely.cs diff --git a/skills/manage-sprite-atlas/resources/variantatlas.cs b/skills/using-unity/references/manage-sprite-atlas/resources/variantatlas.cs similarity index 100% rename from skills/manage-sprite-atlas/resources/variantatlas.cs rename to skills/using-unity/references/manage-sprite-atlas/resources/variantatlas.cs diff --git a/skills/migrate-birp-to-urp/SECURITY.md b/skills/using-unity/references/migrate-birp-to-urp/SECURITY.md similarity index 100% rename from skills/migrate-birp-to-urp/SECURITY.md rename to skills/using-unity/references/migrate-birp-to-urp/SECURITY.md diff --git a/skills/migrate-birp-to-urp/SKILL.md b/skills/using-unity/references/migrate-birp-to-urp/migrate-birp-to-urp.md similarity index 100% rename from skills/migrate-birp-to-urp/SKILL.md rename to skills/using-unity/references/migrate-birp-to-urp/migrate-birp-to-urp.md diff --git a/skills/migrate-birp-to-urp/references/capturing-the-editor.md b/skills/using-unity/references/migrate-birp-to-urp/references/capturing-the-editor.md similarity index 100% rename from skills/migrate-birp-to-urp/references/capturing-the-editor.md rename to skills/using-unity/references/migrate-birp-to-urp/references/capturing-the-editor.md diff --git a/skills/migrate-birp-to-urp/references/complex-shader-situations.md b/skills/using-unity/references/migrate-birp-to-urp/references/complex-shader-situations.md similarity index 100% rename from skills/migrate-birp-to-urp/references/complex-shader-situations.md rename to skills/using-unity/references/migrate-birp-to-urp/references/complex-shader-situations.md diff --git a/skills/migrate-birp-to-urp/references/custom-shader-triage.md b/skills/using-unity/references/migrate-birp-to-urp/references/custom-shader-triage.md similarity index 100% rename from skills/migrate-birp-to-urp/references/custom-shader-triage.md rename to skills/using-unity/references/migrate-birp-to-urp/references/custom-shader-triage.md diff --git a/skills/migrate-birp-to-urp/references/implementation-patterns.md b/skills/using-unity/references/migrate-birp-to-urp/references/implementation-patterns.md similarity index 100% rename from skills/migrate-birp-to-urp/references/implementation-patterns.md rename to skills/using-unity/references/migrate-birp-to-urp/references/implementation-patterns.md diff --git a/skills/migrate-birp-to-urp/references/migration-workflow.md b/skills/using-unity/references/migrate-birp-to-urp/references/migration-workflow.md similarity index 100% rename from skills/migrate-birp-to-urp/references/migration-workflow.md rename to skills/using-unity/references/migrate-birp-to-urp/references/migration-workflow.md diff --git a/skills/migrate-birp-to-urp/references/quality-settings-map.md b/skills/using-unity/references/migrate-birp-to-urp/references/quality-settings-map.md similarity index 100% rename from skills/migrate-birp-to-urp/references/quality-settings-map.md rename to skills/using-unity/references/migrate-birp-to-urp/references/quality-settings-map.md diff --git a/skills/new-unity-project/SECURITY.md b/skills/using-unity/references/new-unity-project/SECURITY.md similarity index 100% rename from skills/new-unity-project/SECURITY.md rename to skills/using-unity/references/new-unity-project/SECURITY.md diff --git a/skills/new-unity-project/SKILL.md b/skills/using-unity/references/new-unity-project/new-unity-project.md similarity index 100% rename from skills/new-unity-project/SKILL.md rename to skills/using-unity/references/new-unity-project/new-unity-project.md diff --git a/skills/new-unity-project/references/checklist.md b/skills/using-unity/references/new-unity-project/references/checklist.md similarity index 100% rename from skills/new-unity-project/references/checklist.md rename to skills/using-unity/references/new-unity-project/references/checklist.md diff --git a/skills/new-unity-project/references/common-mistakes.md b/skills/using-unity/references/new-unity-project/references/common-mistakes.md similarity index 100% rename from skills/new-unity-project/references/common-mistakes.md rename to skills/using-unity/references/new-unity-project/references/common-mistakes.md diff --git a/skills/new-unity-project/references/join-and-terms.md b/skills/using-unity/references/new-unity-project/references/join-and-terms.md similarity index 100% rename from skills/new-unity-project/references/join-and-terms.md rename to skills/using-unity/references/new-unity-project/references/join-and-terms.md diff --git a/skills/new-unity-project/references/packages-and-identity.md b/skills/using-unity/references/new-unity-project/references/packages-and-identity.md similarity index 100% rename from skills/new-unity-project/references/packages-and-identity.md rename to skills/using-unity/references/new-unity-project/references/packages-and-identity.md diff --git a/skills/new-unity-project/references/publish.md b/skills/using-unity/references/new-unity-project/references/publish.md similarity index 100% rename from skills/new-unity-project/references/publish.md rename to skills/using-unity/references/new-unity-project/references/publish.md diff --git a/skills/new-unity-project/references/sign-in-details.md b/skills/using-unity/references/new-unity-project/references/sign-in-details.md similarity index 100% rename from skills/new-unity-project/references/sign-in-details.md rename to skills/using-unity/references/new-unity-project/references/sign-in-details.md diff --git a/skills/new-unity-project/references/skill-setup.md b/skills/using-unity/references/new-unity-project/references/skill-setup.md similarity index 100% rename from skills/new-unity-project/references/skill-setup.md rename to skills/using-unity/references/new-unity-project/references/skill-setup.md diff --git a/skills/new-unity-project/references/visual-baseline.md b/skills/using-unity/references/new-unity-project/references/visual-baseline.md similarity index 100% rename from skills/new-unity-project/references/visual-baseline.md rename to skills/using-unity/references/new-unity-project/references/visual-baseline.md diff --git a/skills/optimize-audio/SECURITY.md b/skills/using-unity/references/optimize-audio/SECURITY.md similarity index 100% rename from skills/optimize-audio/SECURITY.md rename to skills/using-unity/references/optimize-audio/SECURITY.md diff --git a/skills/optimize-audio/SKILL.md b/skills/using-unity/references/optimize-audio/optimize-audio.md similarity index 100% rename from skills/optimize-audio/SKILL.md rename to skills/using-unity/references/optimize-audio/optimize-audio.md diff --git a/skills/optimize-audio/resources/audio-import-api.md b/skills/using-unity/references/optimize-audio/resources/audio-import-api.md similarity index 100% rename from skills/optimize-audio/resources/audio-import-api.md rename to skills/using-unity/references/optimize-audio/resources/audio-import-api.md diff --git a/skills/optimize-audio/resources/platform-settings.md b/skills/using-unity/references/optimize-audio/resources/platform-settings.md similarity index 100% rename from skills/optimize-audio/resources/platform-settings.md rename to skills/using-unity/references/optimize-audio/resources/platform-settings.md diff --git a/skills/optimize-text-mesh-pro/SKILL.md b/skills/using-unity/references/optimize-text-mesh-pro/optimize-text-mesh-pro.md similarity index 100% rename from skills/optimize-text-mesh-pro/SKILL.md rename to skills/using-unity/references/optimize-text-mesh-pro/optimize-text-mesh-pro.md diff --git a/skills/optimize-web/SECURITY.md b/skills/using-unity/references/optimize-web/SECURITY.md similarity index 100% rename from skills/optimize-web/SECURITY.md rename to skills/using-unity/references/optimize-web/SECURITY.md diff --git a/skills/optimize-web/SKILL.md b/skills/using-unity/references/optimize-web/optimize-web.md similarity index 100% rename from skills/optimize-web/SKILL.md rename to skills/using-unity/references/optimize-web/optimize-web.md diff --git a/skills/optimize-web/scripts/WebOptimizer.cs b/skills/using-unity/references/optimize-web/scripts/WebOptimizer.cs similarity index 100% rename from skills/optimize-web/scripts/WebOptimizer.cs rename to skills/using-unity/references/optimize-web/scripts/WebOptimizer.cs diff --git a/skills/optimize-web/scripts/toktx-examples.sh b/skills/using-unity/references/optimize-web/scripts/toktx-examples.sh similarity index 100% rename from skills/optimize-web/scripts/toktx-examples.sh rename to skills/using-unity/references/optimize-web/scripts/toktx-examples.sh diff --git a/skills/setup-vivox-voice-chat/SECURITY.md b/skills/using-unity/references/setup-vivox-voice-chat/SECURITY.md similarity index 100% rename from skills/setup-vivox-voice-chat/SECURITY.md rename to skills/using-unity/references/setup-vivox-voice-chat/SECURITY.md diff --git a/skills/setup-vivox-voice-chat/references/events-and-participants.md b/skills/using-unity/references/setup-vivox-voice-chat/references/events-and-participants.md similarity index 100% rename from skills/setup-vivox-voice-chat/references/events-and-participants.md rename to skills/using-unity/references/setup-vivox-voice-chat/references/events-and-participants.md diff --git a/skills/setup-vivox-voice-chat/references/init-and-login.md b/skills/using-unity/references/setup-vivox-voice-chat/references/init-and-login.md similarity index 100% rename from skills/setup-vivox-voice-chat/references/init-and-login.md rename to skills/using-unity/references/setup-vivox-voice-chat/references/init-and-login.md diff --git a/skills/setup-vivox-voice-chat/references/text-chat.md b/skills/using-unity/references/setup-vivox-voice-chat/references/text-chat.md similarity index 100% rename from skills/setup-vivox-voice-chat/references/text-chat.md rename to skills/using-unity/references/setup-vivox-voice-chat/references/text-chat.md diff --git a/skills/setup-vivox-voice-chat/references/troubleshooting.md b/skills/using-unity/references/setup-vivox-voice-chat/references/troubleshooting.md similarity index 100% rename from skills/setup-vivox-voice-chat/references/troubleshooting.md rename to skills/using-unity/references/setup-vivox-voice-chat/references/troubleshooting.md diff --git a/skills/setup-vivox-voice-chat/references/voice-channels.md b/skills/using-unity/references/setup-vivox-voice-chat/references/voice-channels.md similarity index 100% rename from skills/setup-vivox-voice-chat/references/voice-channels.md rename to skills/using-unity/references/setup-vivox-voice-chat/references/voice-channels.md diff --git a/skills/setup-vivox-voice-chat/SKILL.md b/skills/using-unity/references/setup-vivox-voice-chat/setup-vivox-voice-chat.md similarity index 100% rename from skills/setup-vivox-voice-chat/SKILL.md rename to skills/using-unity/references/setup-vivox-voice-chat/setup-vivox-voice-chat.md diff --git a/skills/shader-graph-create-custom-node/resources/all_hints.hlsl b/skills/using-unity/references/shader-graph-create-custom-node/resources/all_hints.hlsl similarity index 100% rename from skills/shader-graph-create-custom-node/resources/all_hints.hlsl rename to skills/using-unity/references/shader-graph-create-custom-node/resources/all_hints.hlsl diff --git a/skills/shader-graph-create-custom-node/SKILL.md b/skills/using-unity/references/shader-graph-create-custom-node/shader-graph-create-custom-node.md similarity index 100% rename from skills/shader-graph-create-custom-node/SKILL.md rename to skills/using-unity/references/shader-graph-create-custom-node/shader-graph-create-custom-node.md diff --git a/skills/sprite-editor/SECURITY.md b/skills/using-unity/references/sprite-editor/SECURITY.md similarity index 100% rename from skills/sprite-editor/SECURITY.md rename to skills/using-unity/references/sprite-editor/SECURITY.md diff --git a/skills/sprite-editor/references/api_reference.md b/skills/using-unity/references/sprite-editor/references/api_reference.md similarity index 100% rename from skills/sprite-editor/references/api_reference.md rename to skills/using-unity/references/sprite-editor/references/api_reference.md diff --git a/skills/sprite-editor/references/background.md b/skills/using-unity/references/sprite-editor/references/background.md similarity index 100% rename from skills/sprite-editor/references/background.md rename to skills/using-unity/references/sprite-editor/references/background.md diff --git a/skills/sprite-editor/references/templates.md b/skills/using-unity/references/sprite-editor/references/templates.md similarity index 100% rename from skills/sprite-editor/references/templates.md rename to skills/using-unity/references/sprite-editor/references/templates.md diff --git a/skills/sprite-editor/scripts/AutomaticSliceTexture.cs b/skills/using-unity/references/sprite-editor/scripts/AutomaticSliceTexture.cs similarity index 100% rename from skills/sprite-editor/scripts/AutomaticSliceTexture.cs rename to skills/using-unity/references/sprite-editor/scripts/AutomaticSliceTexture.cs diff --git a/skills/sprite-editor/scripts/GenerateNewSpriteRects.cs b/skills/using-unity/references/sprite-editor/scripts/GenerateNewSpriteRects.cs similarity index 100% rename from skills/sprite-editor/scripts/GenerateNewSpriteRects.cs rename to skills/using-unity/references/sprite-editor/scripts/GenerateNewSpriteRects.cs diff --git a/skills/sprite-editor/scripts/GetTextureSourceImageSize.cs b/skills/using-unity/references/sprite-editor/scripts/GetTextureSourceImageSize.cs similarity index 100% rename from skills/sprite-editor/scripts/GetTextureSourceImageSize.cs rename to skills/using-unity/references/sprite-editor/scripts/GetTextureSourceImageSize.cs diff --git a/skills/sprite-editor/scripts/GetTextureToSlice.cs b/skills/using-unity/references/sprite-editor/scripts/GetTextureToSlice.cs similarity index 100% rename from skills/sprite-editor/scripts/GetTextureToSlice.cs rename to skills/using-unity/references/sprite-editor/scripts/GetTextureToSlice.cs diff --git a/skills/sprite-editor/scripts/GridSliceTexture.cs b/skills/using-unity/references/sprite-editor/scripts/GridSliceTexture.cs similarity index 100% rename from skills/sprite-editor/scripts/GridSliceTexture.cs rename to skills/using-unity/references/sprite-editor/scripts/GridSliceTexture.cs diff --git a/skills/sprite-editor/scripts/IsometricSliceTexture.cs b/skills/using-unity/references/sprite-editor/scripts/IsometricSliceTexture.cs similarity index 100% rename from skills/sprite-editor/scripts/IsometricSliceTexture.cs rename to skills/using-unity/references/sprite-editor/scripts/IsometricSliceTexture.cs diff --git a/skills/sprite-editor/scripts/README.md b/skills/using-unity/references/sprite-editor/scripts/README.md similarity index 100% rename from skills/sprite-editor/scripts/README.md rename to skills/using-unity/references/sprite-editor/scripts/README.md diff --git a/skills/sprite-editor/scripts/SetPivotExample.cs b/skills/using-unity/references/sprite-editor/scripts/SetPivotExample.cs similarity index 100% rename from skills/sprite-editor/scripts/SetPivotExample.cs rename to skills/using-unity/references/sprite-editor/scripts/SetPivotExample.cs diff --git a/skills/sprite-editor/scripts/SpriteToPng.cs b/skills/using-unity/references/sprite-editor/scripts/SpriteToPng.cs similarity index 100% rename from skills/sprite-editor/scripts/SpriteToPng.cs rename to skills/using-unity/references/sprite-editor/scripts/SpriteToPng.cs diff --git a/skills/sprite-editor/SKILL.md b/skills/using-unity/references/sprite-editor/sprite-editor.md similarity index 100% rename from skills/sprite-editor/SKILL.md rename to skills/using-unity/references/sprite-editor/sprite-editor.md diff --git a/skills/sprite-segment-3x3grid/scripts/SpriteGridAnalysis.cs b/skills/using-unity/references/sprite-segment-3x3grid/scripts/SpriteGridAnalysis.cs similarity index 100% rename from skills/sprite-segment-3x3grid/scripts/SpriteGridAnalysis.cs rename to skills/using-unity/references/sprite-segment-3x3grid/scripts/SpriteGridAnalysis.cs diff --git a/skills/sprite-segment-3x3grid/SKILL.md b/skills/using-unity/references/sprite-segment-3x3grid/sprite-segment-3x3grid.md similarity index 100% rename from skills/sprite-segment-3x3grid/SKILL.md rename to skills/using-unity/references/sprite-segment-3x3grid/sprite-segment-3x3grid.md diff --git a/skills/ui-imgui/references/gui-elements.md b/skills/using-unity/references/ui-imgui/references/gui-elements.md similarity index 100% rename from skills/ui-imgui/references/gui-elements.md rename to skills/using-unity/references/ui-imgui/references/gui-elements.md diff --git a/skills/ui-imgui/references/templates.md b/skills/using-unity/references/ui-imgui/references/templates.md similarity index 100% rename from skills/ui-imgui/references/templates.md rename to skills/using-unity/references/ui-imgui/references/templates.md diff --git a/skills/ui-imgui/SKILL.md b/skills/using-unity/references/ui-imgui/ui-imgui.md similarity index 100% rename from skills/ui-imgui/SKILL.md rename to skills/using-unity/references/ui-imgui/ui-imgui.md diff --git a/skills/ui-ugui/references/scrollview-setup.md b/skills/using-unity/references/ui-ugui/references/scrollview-setup.md similarity index 100% rename from skills/ui-ugui/references/scrollview-setup.md rename to skills/using-unity/references/ui-ugui/references/scrollview-setup.md diff --git a/skills/ui-ugui/SKILL.md b/skills/using-unity/references/ui-ugui/ui-ugui.md similarity index 100% rename from skills/ui-ugui/SKILL.md rename to skills/using-unity/references/ui-ugui/ui-ugui.md diff --git a/skills/ui-uitk/references/common-issues.md b/skills/using-unity/references/ui-uitk/references/common-issues.md similarity index 100% rename from skills/ui-uitk/references/common-issues.md rename to skills/using-unity/references/ui-uitk/references/common-issues.md diff --git a/skills/ui-uitk/references/custom-elements.md b/skills/using-unity/references/ui-uitk/references/custom-elements.md similarity index 100% rename from skills/ui-uitk/references/custom-elements.md rename to skills/using-unity/references/ui-uitk/references/custom-elements.md diff --git a/skills/ui-uitk/references/painter2d.md b/skills/using-unity/references/ui-uitk/references/painter2d.md similarity index 100% rename from skills/ui-uitk/references/painter2d.md rename to skills/using-unity/references/ui-uitk/references/painter2d.md diff --git a/skills/ui-uitk/references/pointermanipulator-guide.md b/skills/using-unity/references/ui-uitk/references/pointermanipulator-guide.md similarity index 100% rename from skills/ui-uitk/references/pointermanipulator-guide.md rename to skills/using-unity/references/ui-uitk/references/pointermanipulator-guide.md diff --git a/skills/ui-uitk/references/svg-icons.md b/skills/using-unity/references/ui-uitk/references/svg-icons.md similarity index 100% rename from skills/ui-uitk/references/svg-icons.md rename to skills/using-unity/references/ui-uitk/references/svg-icons.md diff --git a/skills/ui-uitk/references/ui-runtime-binding.md b/skills/using-unity/references/ui-uitk/references/ui-runtime-binding.md similarity index 100% rename from skills/ui-uitk/references/ui-runtime-binding.md rename to skills/using-unity/references/ui-uitk/references/ui-runtime-binding.md diff --git a/skills/ui-uitk/references/uss-guide.md b/skills/using-unity/references/ui-uitk/references/uss-guide.md similarity index 100% rename from skills/ui-uitk/references/uss-guide.md rename to skills/using-unity/references/ui-uitk/references/uss-guide.md diff --git a/skills/ui-uitk/SKILL.md b/skills/using-unity/references/ui-uitk/ui-uitk.md similarity index 100% rename from skills/ui-uitk/SKILL.md rename to skills/using-unity/references/ui-uitk/ui-uitk.md diff --git a/skills/ui/SKILL.md b/skills/using-unity/references/ui/ui.md similarity index 100% rename from skills/ui/SKILL.md rename to skills/using-unity/references/ui/ui.md diff --git a/skills/unity-cli/SECURITY.md b/skills/using-unity/references/unity-cli/SECURITY.md similarity index 97% rename from skills/unity-cli/SECURITY.md rename to skills/using-unity/references/unity-cli/SECURITY.md index 6854f76..99e67ab 100644 --- a/skills/unity-cli/SECURITY.md +++ b/skills/using-unity/references/unity-cli/SECURITY.md @@ -26,7 +26,7 @@ The repository skills are downloaded, so the download is fenced too. The source ### Turning an installed skill off and back on -`unity skill disable ` and `unity skill enable ` change whether a skill an AI client has already installed still loads. Disabling renames that skill's `SKILL.md` to `SKILL.md.disabled` inside its own directory and records the choice; enabling renames it back. Automated scanners flag this as skill suppression — a skill that can switch other skills off is a recognized malicious pattern, and reading it that way is correct as a default. Here it is the advertised purpose of a user-run command, and it is fenced: +`unity skill disable ` and `unity skill enable ` change whether a skill an AI client has already installed still loads. Disabling renames that skill's `unity-cli.md` to `SKILL.md.disabled` inside its own directory and records the choice; enabling renames it back. Automated scanners flag this as skill suppression — a skill that can switch other skills off is a recognized malicious pattern, and reading it that way is correct as a default. Here it is the advertised purpose of a user-run command, and it is fenced: - **It can only reach installs this CLI itself recorded.** The set of skills these verbs can name comes entirely from the install ledger, so a skill this CLI did not install has no row, cannot be named, and cannot be found or touched. There is no path by which it disables a skill some other tool or the user placed. - **Nothing runs at load or in the background.** Both verbs act only when the user runs them, on a skill the user names; `--dry-run` reports without touching the filesystem. diff --git a/skills/unity-cli/references/CHANGELOG.md b/skills/using-unity/references/unity-cli/references/CHANGELOG.md similarity index 100% rename from skills/unity-cli/references/CHANGELOG.md rename to skills/using-unity/references/unity-cli/references/CHANGELOG.md diff --git a/skills/unity-cli/references/auth-license-cloud.md b/skills/using-unity/references/unity-cli/references/auth-license-cloud.md similarity index 100% rename from skills/unity-cli/references/auth-license-cloud.md rename to skills/using-unity/references/unity-cli/references/auth-license-cloud.md diff --git a/skills/unity-cli/references/build-run-test.md b/skills/using-unity/references/unity-cli/references/build-run-test.md similarity index 100% rename from skills/unity-cli/references/build-run-test.md rename to skills/using-unity/references/unity-cli/references/build-run-test.md diff --git a/skills/unity-cli/references/cloud-automation.md b/skills/using-unity/references/unity-cli/references/cloud-automation.md similarity index 100% rename from skills/unity-cli/references/cloud-automation.md rename to skills/using-unity/references/unity-cli/references/cloud-automation.md diff --git a/skills/unity-cli/references/collaboration.md b/skills/using-unity/references/unity-cli/references/collaboration.md similarity index 100% rename from skills/unity-cli/references/collaboration.md rename to skills/using-unity/references/unity-cli/references/collaboration.md diff --git a/skills/unity-cli/references/common-workflows.md b/skills/using-unity/references/unity-cli/references/common-workflows.md similarity index 100% rename from skills/unity-cli/references/common-workflows.md rename to skills/using-unity/references/unity-cli/references/common-workflows.md diff --git a/skills/unity-cli/references/config-hub.md b/skills/using-unity/references/unity-cli/references/config-hub.md similarity index 100% rename from skills/unity-cli/references/config-hub.md rename to skills/using-unity/references/unity-cli/references/config-hub.md diff --git a/skills/unity-cli/references/diagnostics-maintenance.md b/skills/using-unity/references/unity-cli/references/diagnostics-maintenance.md similarity index 100% rename from skills/unity-cli/references/diagnostics-maintenance.md rename to skills/using-unity/references/unity-cli/references/diagnostics-maintenance.md diff --git a/skills/unity-cli/references/docs-workflow.md b/skills/using-unity/references/unity-cli/references/docs-workflow.md similarity index 100% rename from skills/unity-cli/references/docs-workflow.md rename to skills/using-unity/references/unity-cli/references/docs-workflow.md diff --git a/skills/unity-cli/references/editors-install.md b/skills/using-unity/references/unity-cli/references/editors-install.md similarity index 100% rename from skills/unity-cli/references/editors-install.md rename to skills/using-unity/references/unity-cli/references/editors-install.md diff --git a/skills/unity-cli/references/exit-codes.md b/skills/using-unity/references/unity-cli/references/exit-codes.md similarity index 100% rename from skills/unity-cli/references/exit-codes.md rename to skills/using-unity/references/unity-cli/references/exit-codes.md diff --git a/skills/unity-cli/references/global-flags-env.md b/skills/using-unity/references/unity-cli/references/global-flags-env.md similarity index 100% rename from skills/unity-cli/references/global-flags-env.md rename to skills/using-unity/references/unity-cli/references/global-flags-env.md diff --git a/skills/unity-cli/references/integration-advanced.md b/skills/using-unity/references/unity-cli/references/integration-advanced.md similarity index 100% rename from skills/unity-cli/references/integration-advanced.md rename to skills/using-unity/references/unity-cli/references/integration-advanced.md diff --git a/skills/unity-cli/references/notes.md b/skills/using-unity/references/unity-cli/references/notes.md similarity index 100% rename from skills/unity-cli/references/notes.md rename to skills/using-unity/references/unity-cli/references/notes.md diff --git a/skills/unity-cli/references/playmode-verification-loop.md b/skills/using-unity/references/unity-cli/references/playmode-verification-loop.md similarity index 100% rename from skills/unity-cli/references/playmode-verification-loop.md rename to skills/using-unity/references/unity-cli/references/playmode-verification-loop.md diff --git a/skills/unity-cli/references/projects-templates.md b/skills/using-unity/references/unity-cli/references/projects-templates.md similarity index 100% rename from skills/unity-cli/references/projects-templates.md rename to skills/using-unity/references/unity-cli/references/projects-templates.md diff --git a/skills/unity-cli/references/version-control.md b/skills/using-unity/references/unity-cli/references/version-control.md similarity index 100% rename from skills/unity-cli/references/version-control.md rename to skills/using-unity/references/unity-cli/references/version-control.md diff --git a/skills/unity-cli/references/worktrees.md b/skills/using-unity/references/unity-cli/references/worktrees.md similarity index 100% rename from skills/unity-cli/references/worktrees.md rename to skills/using-unity/references/unity-cli/references/worktrees.md diff --git a/skills/unity-cli/SKILL.md b/skills/using-unity/references/unity-cli/unity-cli.md similarity index 100% rename from skills/unity-cli/SKILL.md rename to skills/using-unity/references/unity-cli/unity-cli.md diff --git a/skills/unity-package-management/references/select-packages.md b/skills/using-unity/references/unity-package-management/references/select-packages.md similarity index 100% rename from skills/unity-package-management/references/select-packages.md rename to skills/using-unity/references/unity-package-management/references/select-packages.md diff --git a/skills/unity-package-management/SKILL.md b/skills/using-unity/references/unity-package-management/unity-package-management.md similarity index 100% rename from skills/unity-package-management/SKILL.md rename to skills/using-unity/references/unity-package-management/unity-package-management.md diff --git a/skills/unity-pipeline/SECURITY.md b/skills/using-unity/references/unity-pipeline/SECURITY.md similarity index 100% rename from skills/unity-pipeline/SECURITY.md rename to skills/using-unity/references/unity-pipeline/SECURITY.md diff --git a/skills/unity-pipeline/SKILL.md b/skills/using-unity/references/unity-pipeline/unity-pipeline.md similarity index 100% rename from skills/unity-pipeline/SKILL.md rename to skills/using-unity/references/unity-pipeline/unity-pipeline.md diff --git a/skills/urp-postprocessing/SECURITY.md b/skills/using-unity/references/urp-postprocessing/SECURITY.md similarity index 100% rename from skills/urp-postprocessing/SECURITY.md rename to skills/using-unity/references/urp-postprocessing/SECURITY.md diff --git a/skills/urp-postprocessing/references/code-templates.md b/skills/using-unity/references/urp-postprocessing/references/code-templates.md similarity index 100% rename from skills/urp-postprocessing/references/code-templates.md rename to skills/using-unity/references/urp-postprocessing/references/code-templates.md diff --git a/skills/urp-postprocessing/references/effect-reference.md b/skills/using-unity/references/urp-postprocessing/references/effect-reference.md similarity index 100% rename from skills/urp-postprocessing/references/effect-reference.md rename to skills/using-unity/references/urp-postprocessing/references/effect-reference.md diff --git a/skills/urp-postprocessing/SKILL.md b/skills/using-unity/references/urp-postprocessing/urp-postprocessing.md similarity index 100% rename from skills/urp-postprocessing/SKILL.md rename to skills/using-unity/references/urp-postprocessing/urp-postprocessing.md diff --git a/skills/validate-urp-render-graph-renderer-feature/SKILL.md b/skills/using-unity/references/validate-urp-render-graph-renderer-feature/validate-urp-render-graph-renderer-feature.md similarity index 100% rename from skills/validate-urp-render-graph-renderer-feature/SKILL.md rename to skills/using-unity/references/validate-urp-render-graph-renderer-feature/validate-urp-render-graph-renderer-feature.md