/unity-vrc-skills-renovator

name: unity-vrc-skills-renovator
description: >
    VRChat skill renovator for knowledge fill, refresh, and quality improvement.
    Use this skill when updating VRChat skills to new SDK versions, filling
    missing knowledge, fixing outdated information, or improving skill quality.
    Targets unity-vrc-udon-sharp and unity-vrc-world-sdk-3 skills.
    Triggers on: update skills, SDK latest, knowledge fill, skill maintenance,
    information audit, catch-up, renovate, refresh, improve skills, SDK update.
license: MIT
metadata:
    author: niaka3dayo
    version: "4.3.1"
    tags: skill-maintenance, sdk-update, knowledge-management
    internal: true

VRC Skills Renovator

Overview

A guide for renovating (filling knowledge, refreshing, and improving quality of) VRChat-related skills in this repository.

Three Pillars of Renovation

| Pillar | Description | Examples | |--------|-------------|---------| | **Fill** | Adding missing knowledge | Undocumented APIs, patterns, tips | | **Refresh** | Updating outdated information | New SDK version support, removing deprecated APIs | | **Quality Improvement** | Improving accuracy and coverage of existing knowledge | Adding code examples, improving explanations |

Target Skills

> **Path notation**: `skills/` refers to the `skills/` directory at the repository root. > `rules/` refers to files under `skills/unity-vrc-udon-sharp/rules/`. > This skill itself resides at `.claude/skills/unity-vrc-skills-renovator/` (dev-only, not distributed via npm).

| Skill | Directory | Content | |-------|-----------|---------| | `unity-vrc-udon-sharp` | `skills/unity-vrc-udon-sharp/` | UdonSharp coding, networking, events | | `unity-vrc-world-sdk-3` | `skills/unity-vrc-world-sdk-3/` | VRC components, layer settings, world optimization |

Renovation Procedure

Phase 1: Current State Analysis

1. **Check the active and verified SDK target for each skill**

Read: skills/unity-vrc-udon-sharp/SKILL.md
Read: skills/unity-vrc-world-sdk-3/SKILL.md
→ Check the "Active support / last verified" line in each file

2. **Check the file list for each skill**

Glob: skills/unity-vrc-udon-sharp/**/*
Glob: skills/unity-vrc-world-sdk-3/**/*

Phase 2: Information Gathering

Start from primary sources. Web searches fill gaps; they do not replace these:

# Latest stable SDK (the weekly SDK Watch workflow opens an Issue from the same call)
gh api repos/vrchat/packages/releases/latest --jq '.tag_name'

# Official release notes for each version between the active target and the latest
https://creators.vrchat.com/releases/

# What the SDK binary actually exposes to Udon, diffed against skill coverage
.claude/audit/README.md

Before changing an existing claim, follow `.claude/rules/evidence-gate.md`.

Then execute the following search queries in parallel to collect the remaining information:

# Required searches (parallel execution recommended)
1. "VRChat SDK {current year} new features updates changelog"
2. "UdonSharp VRChat SDK 3.{next minor version} changes"
3. "VRChat Worlds SDK {current year} UdonSharp"
4. "VRChat World SDK components new features {current year}"

# Supplementary searches (as needed)
5. "VRChat SDK NetworkCallable parameters"
6. "VRChat SDK persistence PlayerData"
7. "VRChat SDK PhysBones Contacts worlds"

See `references/search-queries.md` for details.

Phase 3: Renovation Plan

Classify collected information by the **3 pillars** and **target skills**:

Classification by Pillar

| Pillar | Content | Action | |--------|---------|--------| | **Fill** | Information not yet in the skill | Add new sections, add code examples | | **Refresh** | Outdated information | Update version references, remove deprecated APIs | | **Quality Improvement** | Inaccurate or insufficient descriptions | Improve explanations, add patterns |

Classification by Skill

| Category | Target Skill | Examples | |----------|-------------|---------| | C# API, networking, sync variables | `unity-vrc-udon-sharp` | NetworkCallable, new events | | Components, layers, optimization | `unity-vrc-world-sdk-3` | New components, setting changes | | Affects both | Both | SDK version references, Persistence |

Phase 4: Update unity-vrc-udon-sharp

| Priority | File | Update Content | |----------|------|----------------| | 1 | SKILL.md | SDK version support, new feature summary | | 2 | references/constraints.md | Newly available features | | 3 | references/networking.md | New networking features | | 4 | references/events.md | New events | | 5 | references/api.md | New APIs | | 6 | CHEATSHEET.md | Quick reference update | | 7 | references/patterns-*.md | New feature usage patterns | | 8 | references/troubleshooting.md | Troubleshooting |

Phase 5: Update unity-vrc-world-sdk-3

| Priority | File | Update Content | |----------|------|----------------| | 1 | SKILL.md | SDK version support, new feature summary | | 2 | references/components.md | New components, property changes | | 3 | references/layers.md | Layer/collision changes | | 4 | references/performance.md | New optimization guidelines | | 5 | references/lighting.md | Lighting-related changes | | 6 | references/audio-video.md | Audio/video-related changes | | 7 | references/upload.md | Upload procedure changes | | 8 | CHEATSHEET.md | Quick reference update | | 9 | references/troubleshooting.md | Troubleshooting |

Phase 6: New File Creation (if needed)

When major new features are added:

• Create a dedicated reference file in the corresponding skill's `references/`
• Add a link in the corresponding SKILL.md Resources section

Phase 7: Rules & Enforcement Layer Sync

When the Knowledge layer (references/*.md) changes, always sync the Rules layer and Enforcement layer as well.

7a. Rules Layer — Rule Sheets (skills/unity-vrc-udon-sharp/rules/)

Read: skills/unity-vrc-udon-sharp/rules/udonsharp-constraints.md
Read: skills/unity-vrc-udon-sharp/r