mcpbeat

Unity Vrc Skills Renovator

niaka3dayo/unity-vrc-skills-renovator

> 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. information audit, catch-up, renovate, refresh, improve skills, SDK update.

10k tokens
context cost
the whole folder, loaded on every use
6
files
instructions only
0
copies elsewhere
how many repositories repackaged it
254
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/niaka3dayo/agent-skills-vrc-udon --skill unity-vrc-skills-renovator

The instruction itself

23 sections, as written by the author

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
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
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:

# 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/)
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/)
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/)
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

# 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:

## 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)

How to use it

Copy the folder

Take niaka3dayo/unity-vrc-skills-renovator from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.