unity-vrc-skills-renovator

Original：🇺🇸 English
Translated

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.

9installs
Sourceniaka3dayo/agent-skills-vrc-udon
Added on

NPX Install

npx skill4agent add niaka3dayo/agent-skills-vrc-udon unity-vrc-skills-renovator

Tags

Translated version includes tags in frontmatter
vrchat-developmentudon-sharpsdk-maintenanceskill-renovationdocument-management

SKILL.md Content

View Translation Comparison →

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

PillarDescriptionExamples
FillAdding missing knowledgeUndocumented APIs, patterns, tips
RefreshUpdating outdated informationNew SDK version support, removing deprecated APIs
Quality ImprovementImproving accuracy and coverage of existing knowledgeAdding 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).
SkillDirectoryContent
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 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
  1. 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

PillarContentAction
FillInformation not yet in the skillAdd new sections, add code examples
RefreshOutdated informationUpdate version references, remove deprecated APIs
Quality ImprovementInaccurate or insufficient descriptionsImprove explanations, add patterns

Classification by Skill

CategoryTarget SkillExamples
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 bothBothSDK version references, Persistence

Phase 4: Update unity-vrc-udon-sharp

PriorityFileUpdate Content
1SKILL.mdSDK version support, new feature summary
2references/constraints.mdNewly available features
3references/networking.mdNew networking features
4references/events.mdNew events
5references/api.mdNew APIs
6CHEATSHEET.mdQuick reference update
7references/patterns.mdNew feature usage patterns
8references/troubleshooting.mdTroubleshooting

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

PriorityFileUpdate Content
1SKILL.mdSDK version support, new feature summary
2references/components.mdNew components, property changes
3references/layers.mdLayer/collision changes
4references/performance.mdNew optimization guidelines
5references/lighting.mdLighting-related changes
6references/audio-video.mdAudio/video-related changes
7references/upload.mdUpload procedure changes
8CHEATSHEET.mdQuick reference update
9references/troubleshooting.mdTroubleshooting

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 TypeTarget Rule FileAction
Blocked feature added/removedudonsharp-constraints.mdUpdate block list / available list
Networking changesudonsharp-networking.mdUpdate sync modes, limits, patterns
Data budget changesudonsharp-sync-selection.mdUpdate 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 TypeHook-side Action
Feature unblockedRemove the corresponding grep pattern
New constraint addedAdd a new grep pattern
Limit value changedUpdate threshold (synced_count, etc.)
New anti-patternAdd 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 TypeTemplate-side Action
New API becomes recommendedUpdate template to use the new API
Pattern becomes deprecatedRewrite to the recommended pattern
New best practiceReflect in the relevant template, or create a new template

Phase 8: Validation

  1. Unify SDK version references across all files
  2. Verify cross-reference links between both skills
  3. Check code sample syntax
  4. 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

SourceURLContent
SDK Releasescreators.vrchat.com/releases/Official release notes
UdonSharp Blogudonsharp.docs.vrchat.com/news/UdonSharp-specific updates
VRChat Cannyfeedback.vrchat.com/udonFeature 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)