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

Check the current SDK version support for each skill

text

Read: skills/unity-vrc-udon-sharp/SKILL.md
Read: skills/unity-vrc-world-sdk-3/SKILL.md
→ Check the "Supported SDK version" line in each file

Check the file list for each skill

text

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

Phase 2: Information Gathering

Execute the following search queries in parallel to collect the latest information:

text

# 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 — Auto-loaded Rules (skills/unity-vrc-udon-sharp/rules/)

text

Read: skills/unity-vrc-udon-sharp/rules/udonsharp-constraints.md
Read: skills/unity-vrc-udon-sharp/rules/udonsharp-networking.md
Read: skills/unity-vrc-udon-sharp/rules/udonsharp-sync-selection.md
→ Check for differences with the Knowledge layer and reflect the same facts

Change Type	Target Rule File	Action
Blocked feature added/removed	udonsharp-constraints.md	Update block list / available list
Networking changes	udonsharp-networking.md	Update sync modes, limits, patterns
Data budget changes	udonsharp-sync-selection.md	Update budget values, decision tree

7b. Enforcement Layer — Validation Hooks (hooks/)

text

Read: skills/unity-vrc-udon-sharp/hooks/validate-udonsharp.sh
Read: skills/unity-vrc-udon-sharp/hooks/validate-udonsharp.ps1
→ Add/remove/modify rules based on constraint changes

Change Type	Hook-side Action
Feature unblocked	Remove the corresponding grep pattern
New constraint added	Add a new grep pattern
Limit value changed	Update threshold (synced_count, etc.)
New anti-pattern	Add a new warning rule

Important:

.sh

and

.ps1

must maintain the same rule set (don't update only one).

7c. Enforcement Layer — Templates (assets/templates/)

text

Read: skills/unity-vrc-udon-sharp/assets/templates/BasicInteraction.cs
Read: skills/unity-vrc-udon-sharp/assets/templates/SyncedObject.cs
Read: skills/unity-vrc-udon-sharp/assets/templates/PlayerSettings.cs
Read: skills/unity-vrc-udon-sharp/assets/templates/CustomInspector.cs
→ Remove deprecated patterns and reflect new best practices

Change Type	Template-side Action
New API becomes recommended	Update template to use the new API
Pattern becomes deprecated	Rewrite to the recommended pattern
New best practice	Reflect in the relevant template, or create a new template

Phase 8: Validation

Unify SDK version references across all files
Verify cross-reference links between both skills
Check code sample syntax
3-layer consistency check: Verify that Knowledge / Rules / Enforcement reflect the same facts
- Constraint lists are consistent across all 3 layers
- Limit values (synced variable count, string length, etc.) are consistent across all 3 layers
- Templates do not use blocked features

Official Sources

See

references/changelog-sources.md

for details.

Primary Sources

Source	URL	Content
SDK Releases	creators.vrchat.com/releases/	Official release notes
UdonSharp Blog	udonsharp.docs.vrchat.com/news/	UdonSharp-specific updates
VRChat Canny	feedback.vrchat.com/udon	Feature requests and completion status

WebSearch for Official Documentation

text

# Search official documentation
WebSearch: "API name or feature site:creators.vrchat.com"

# UdonSharp API reference
WebSearch: "API name site:udonsharp.docs.vrchat.com"

Search Notes

The VRChat official site may return 403 errors, so use WebSearch instead of WebFetch
Japanese sources (Qiita, etc.) can be helpful but prioritize official information
Also check the UdonSharp releases page on GitHub

Renovation History Template

Record renovations in the following format:

markdown

## Renovation History

### YYYY-MM-DD - Summary (e.g., SDK X.Y.Z support / knowledge fill / quality improvement)

**Fill (New additions):**
- Added knowledge / sections

**Refresh (Updates / Fixes):**
- Updated info / corrections

**Quality Improvement:**
- Improved descriptions / added examples

**Rules Layer Sync:**
- unity-vrc-udon-sharp/rules/udonsharp-constraints.md: changes
- unity-vrc-udon-sharp/rules/udonsharp-networking.md: changes

**Enforcement Layer Sync:**
- hooks/validate-udonsharp.sh: rules added/removed
- hooks/validate-udonsharp.ps1: synced with .sh
- assets/templates/SyncedObject.cs: pattern updated

**Changed Files:**
- unity-vrc-udon-sharp/file.md: changes
- unity-vrc-world-sdk-3/file.md: changes

**3-Layer Consistency**: OK / NG (details)

unity-vrc-skills-renovator

NPX Install

Tags

SKILL.md Content

VRC Skills Renovator

Overview

Three Pillars of Renovation

Target Skills

Renovation Procedure

Phase 1: Current State Analysis

Phase 2: Information Gathering

Phase 3: Renovation Plan

Classification by Pillar

Classification by Skill

Phase 4: Update unity-vrc-udon-sharp

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

Phase 6: New File Creation (if needed)

Phase 7: Rules & Enforcement Layer Sync

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

7b. Enforcement Layer — Validation Hooks (hooks/)

7c. Enforcement Layer — Templates (assets/templates/)

Phase 8: Validation

Official Sources

Primary Sources

WebSearch for Official Documentation

Search Notes

Renovation History Template