Development
Plugin
agent-skills-vrc-udon
Skills, rules, and validation hooks that teach AI coding agents to generate correct UdonSharp code
Plugin Signal65/100Solid
maintained97
capable29
documented75
adopted51
Install on Claude Code
> /plugin marketplace add niaka3dayo/agent-skills-vrc-udon> /plugin install vrc-udon-skills@agent-skills-vrc-udon
Stats
255
Stars
4
Forks
Active
Maintenance
Shell
Language
MIT
License
5d ago
Last commit
5mo ago
Created
Repo: niaka3dayo/agent-skills-vrc-udon
What's inside
Skills
3/unity-vrc-skills-renovatorVRChat 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/unity-vrc-udon-sharpUdonSharp scripting skill for SDK 3.7.1-3.10.4. Use when writing, reviewing, debugging, or migrating UdonSharp C# and UdonBehaviour code. Positive triggers include UdonSharp, NetworkCallable, NetworkCalling, CallingPlayer, Udon network authorization, synced runtime state, a/unity-vrc-world-sdk-3VRChat World SDK 3 guide for scene and Inspector setup, component placement, optimization, and upload. Use for VRChat world scene configuration, VRC SDK components, layers, baked lighting, Quest/Android performance, Dynamics for Worlds, Build Panel warning triage, validation,
README
1English | ๆฅๆฌ่ช | ็ฎไฝไธญๆ | ็น้ซไธญๆ | ํ๊ตญ์ด
VRChat world development with UdonSharp (C# โ Udon Assembly) has strict compile constraints that differ significantly from standard C#. Features like List<T>, async/await, try/catch, LINQ, and lambdas cause compile errors.
This repository provides AI coding agents with the knowledge to generate correct UdonSharp code from the start.
| Problem | Solution |
|---|---|
AI generates List<T>, async/await, etc. | Rules + hooks auto-detect and warn |
| Sync variable bloat | Decision tree + data budget |
| Incorrect networking patterns | Pattern library + anti-patterns |
| SDK version feature differences | Version table with feature mapping |
| Late Joiner state inconsistency | Sync pattern selection framework |
This is NOT:
- A VRChat SDK or UdonSharp distribution
- A Unity project (no executable code)
- A replacement for official VRChat documentation
- A guarantee of all AI behaviors
Issues: Bug reports and knowledge requests are welcome via GitHub Issues. PRs: Pull Requests are not accepted. See CONTRIBUTING.md for details.
Migrating from fork/clone? โ Since v1.0.0, this project is distributed as an npm package. You no longer need to fork or clone the repository. Simply run one of the install commands below inside your VRChat Unity project. If you previously cloned this repo, you can safely delete the cloned directory and switch to the npm-based install.
Method 1: skills CLI (recommended)
npx skills add niaka3dayo/agent-skills-vrc-udon
This uses the skills.sh ecosystem to install skills into your project.
Method 2: Claude Code plugin
claude plugin add niaka3dayo/agent-skills-vrc-udon
Method 3: git clone
git clone https://github.com/niaka3dayo/agent-skills-vrc-udon.git
Installing a specific version
All published versions remain permanently available on npm and as git tags โ nothing is ever removed.
# npm (any published version, v1.0.0 and later)
npm install agent-skills-vrc-udon@2.3.0
# git tag
git clone --branch v2.3.0 https://github.com/niaka3dayo/agent-skills-vrc-udon.git
skills/ # All skills
unity-vrc-udon-sharp/ # UdonSharp core skill
SKILL.md # Skill definition + frontmatter
LICENSE.txt # MIT License
CHEATSHEET.md # Quick reference (1 page)
rules/ # Constraint rules
udonsharp-constraints.md
udonsharp-networking.md
udonsharp-sync-selection.md
hooks/ # PostToolUse validation
validate-udonsharp.sh
validate-udonsharp.ps1
assets/templates/ # Code templates (17 files)
references/ # Detailed documentation (25 files)
unity-vrc-world-sdk-3/ # VRC World SDK skill
SKILL.md, LICENSE.txt, CHEATSHEET.md, references/ (8 files)
templates/ # AI tool config templates
CLAUDE.md AGENTS.md GEMINI.md # Distributed to users via installer
.claude-plugin/marketplace.json # Claude Code plugin registration
CLAUDE.md # Development guide (this repo only)
unity-vrc-udon-sharp
UdonSharp scripting core skill. Covers compile constraints, networking, events, and templates.
| Area | Content |
|---|---|
| Constraints | Blocked C# features and alternatives (List<T> โ DataList, async โ SendCustomEventDelayedSeconds) |
| Networking | Ownership model, Manual/Continuous sync, FieldChangeCallback, anti-patterns |
| NetworkCallable | SDK 3.8.1+ parameterized network events (up to 8 args) |
| Persistence | SDK 3.7.4+ PlayerData/PlayerObject API |
| Dynamics | SDK 3.10.0+ PhysBones, Contacts, VRC Constraints for Worlds |
| Web Loading | String/Image download, VRCJson, VRCUrl constraints |
| Templates | 17 templates (interactions, sync patterns, persistence, editor utilities, and more) |
unity-vrc-world-sdk-3
World-level scene setup, component placement, and optimization.
| Area | Content |
|---|---|
| Scene Setup | VRC_SceneDescriptor, spawn points, Reference Camera |
| Components | VRC_Pickup, Station, ObjectSync, Mirror, Portal, CameraDolly |
| Layers | VRChat reserved layers and collision matrix |
| Performance | FPS targets, Quest/Android limits, optimization checklist |
| Lighting | Baked lighting best practices |
| Audio/Video | Spatial audio, video player selection (AVPro vs Unity) |
| Upload | Build and upload workflow, pre-upload checklist |
Rules are constraint files that guide AI agents before code generation.
| Rule File | Content |
|---|---|
udonsharp-constraints | Blocked C# features, code generation rules, attributes, syncable types |
udonsharp-networking | Ownership model, sync modes, anti-patterns, NetworkCallable constraints |
udonsharp-sync-selection | Sync decision tree, data budget targets, 6 minimization principles |
Networking rule: A parameterless public method without a leading _ is a legacy network entry. Prefix local-only/custom public methods with _, and use [NetworkCallable] to expose only intentional entries. Confirm NetworkCalling.InNetworkCall before reading NetworkCalling.CallingPlayer; authorize the caller separately from receiver ownership. Never use instance master as a security or access-control boundary.
Sync Decision Tree
Q1: Visible to other players?
No --> No sync (0 bytes)
Yes --> Q2
Q2: Late Joiner needs current state?
No --> Events only (0 bytes)
Yes --> Q3
Q3: Continuous change? (position/rotation)
Yes --> Continuous sync
No --> Manual sync (minimal [UdonSynced])
Target: < 50 bytes per behaviour. Small-medium worlds: < 100 bytes total.
PostToolUse hooks that auto-run when .cs files are edited.
| Category | Check | Severity |
|---|---|---|
| Blocked Features | List<T>, async/await, try/catch, LINQ, coroutines, lambdas | ERROR |
| Blocked Patterns | AddListener(), StartCoroutine() | ERROR |
| Networking | [UdonSynced] without RequestSerialization() | WARNING |
| Networking | [UdonSynced] without Networking.SetOwner() | WARNING |
| Sync Bloat | 6+ synced variables per behaviour | WARNING |
| Sync Bloat | int[]/float[] sync (recommend smaller types) | WARNING |
| Config Mismatch | NoVariableSync mode with [UdonSynced] fields | ERROR |
Supports both Bash (validate-udonsharp.sh) and PowerShell (validate-udonsharp.ps1).
The Bash validator requires jq. If jq is unavailable, it passes the input
through unchanged and emits VALIDATOR-WARNING: validation skipped (JQ_UNAVAILABLE); it does not silently claim that validation succeeded.
SDK Versions
| SDK Version | Key Features | Status |
|---|---|---|
| 3.7.1 | StringBuilder, Regex, System.Random | Supported |
| 3.7.4 | Persistence API (PlayerData / PlayerObject) | Supported |
| 3.7.6 | Multi-platform Build & Publish (PC + Android) | Supported |
| 3.8.0 | PhysBone dependency sorting, Force Kinematic On Remote | Supported |
| 3.8.1 | [NetworkCallable] parameterized events, Others/Self targets | Supported |
| 3.9.0 | Camera Dolly API, Auto Hold pickup | Supported |
| 3.10.0 | VRChat Dynamics for Worlds (PhysBones, Contacts, VRC Constraints) | Supported |
| 3.10.1 | Bug fixes, stability improvements | Supported |
| 3.10.2 | EventTiming.PostLateUpdate/FixedUpdate, PhysBones fixes, shader time globals | Supported |
| 3.10.3 | VRCPlayerApi.isVRCPlus, VRCRaycast (avatar), Mirror render-order fix | Supported |
| 3.10.4 | VRCTween, Box-shaped Contacts, Global Avatar PhysBone Colliders, world VRCPhysBoneCollider Udon access, DataList/DataDictionary capacity APIs | Latest Stable |
Note: Before publishing, confirm that the project uses an SDK version currently supported by VRChat.
Official Resources
| Resource | URL |
|---|---|
| VRChat Creators Docs | https://creators.vrchat.com/ |
| UdonSharp API Reference | https://udonsharp.docs.vrchat.com/ |
| VRChat Forums (Q&A) | https://ask.vrchat.com/ |
| VRChat Canny (Bugs/Features) | https://feedback.vrchat.com/ |
| VRChat Community GitHub | https://github.com/vrchat-community |
Issues are welcome -- bug reports and knowledge requests help improve this project.
Pull Requests are not accepted -- all fixes and updates are made by the maintainer.
See CONTRIBUTING.md for details.
This project is not affiliated with VRChat Inc. No official endorsement, partnership, or association is implied.
"VRChat", "UdonSharp", "Udon" and related names/logos are trademarks of VRChat Inc. All trademarks belong to their respective owners.
This repository is a personal knowledge base for AI coding agents to generate correct UdonSharp code. It does not distribute any part of the VRChat SDK or UdonSharp compiler.
Accuracy
- Content is provided "AS IS" without warranty. See LICENSE.
- This is a personal project. Errors, outdated information, or incomplete content may exist. Always verify against official VRChat documentation.
- The author assumes no liability for issues caused by this repository (build errors, upload rejections, unexpected world behavior, etc.).
- SDK coverage (3.7.1 - 3.10.4) reflects the last update. Behavior may change with new VRChat releases.
AI-Assisted Creation
This knowledge base was created and maintained with AI tool assistance (Claude, Gemini, Codex). All content has been reviewed, but AI-generated portions may contain subtle errors. Use at your own risk.
License
This project is licensed under the MIT License. See LICENSE for details.
Fork, modify, and redistribute freely under MIT License terms. This license applies to the documentation, rules, templates, and hooks in this repository. It does not grant any rights to VRChat's SDK, UdonSharp compiler, or other VRChat intellectual property.
File tree
224niaka3dayo/agent-skills-vrc-udonView on GitHub
.claude/
.claude-plugin/
marketplace.json
audit/
.gitignore
README.md
scripts/
census.py
diff.py
refine.py
sdk-coverage-ledger.md
hooks/
doc-sync-reminder.sh
rules/
doc-sync.md
settings.json
skills/
unity-vrc-skills-renovator/
LICENSE.txt
references/
changelog-sources.md
search-queries.md
skill-structure.md
update-checklist.md
SKILL.md
.editorconfig
.editorconfig-checker.json
.github/
ISSUE_TEMPLATE/
bug_report.yml
config.yml
knowledge_request.yml
quick_feedback.yml
labels.yml
PULL_REQUEST_TEMPLATE/
release.md
release-drafter.yml
workflows/
ci.yml
label-sync.yml
publish.yml
release-drafter.yml
.gitignore
.npmignore
CHANGELOG.md
CLAUDE.md
CONTRIBUTING.md
LICENSE
package.json
README.ja.md
README.ko.md
README.md
README.zh-CN.md
README.zh-TW.md
SECURITY.md
skills/
unity-vrc-udon-sharp/
assets/
templates/
ArrayUtils.cs
BasicInteraction.cs
BatchedSync.cs
CloggedRetrySync.cs
ContactReceiver.cs
CustomInspector.cs
DataPersistence.cs
DualCopySync.cs
EventBus.cs
MasterManagedPlayerPool.cs
PackedStateSync.cs
PlayerSettings.cs
RateLimitedSync.cs
StateMachine.cs
SyncedObject.cs
UdonSharpProgramAssetAutoGenerator.cs
UndoableGameManager.cs
CHEATSHEET.md
hooks/
validate-udonsharp.ps1
validate-udonsharp.sh
LICENSE.txt
references/
api.md
assembly-definitions.md
constraints.md
context-preservation.md
dynamics.md
editor-scripting.md
events.md
image-loading-vram.md
networking-antipatterns.md
networking-bandwidth.md
networking.md
patterns-core.md
patterns-networking.md
patterns-performance.md
patterns-ui.md
patterns-utilities.md
patterns-video.md
persistence.md
sdk-migration.md
sync-examples.md
testing.md
troubleshooting.md
vrctween.md
web-loading-advanced.md
web-loading.md
rules/
udonsharp-constraints.md
udonsharp-networking.md
udonsharp-sync-selection.md
SKILL.md
unity-vrc-world-sdk-3/
assets/
templates/
VRC_Pickup_Rigidbody.cs
VRC_Station_Basic.cs
CHEATSHEET.md
LICENSE.txt
references/
audio-video.md
build-validation.md
components.md
layers.md
lighting.md
performance.md
troubleshooting.md
upload.md
SKILL.md
templates/
AGENTS.md
CLAUDE.md
GEMINI.md
tests/
docs/
assembly-definitions-reference.test.sh
audit-udon-public-methods.py
audit-udon-public-methods.test.sh
build-validation-reference.test.sh
fixtures/
audit-udon-public-methods/
invalid/
attribute-bleed.cs
comment-evasion.cs
container-exposure.md
empty-statement-before-file-namespace.cs
expression-bodied.cs
fake-editor-base.cs
global-qualified-name.cs
inherited-overload.cs
late-file-scoped-namespace.cs
list-quote-container-exposure.md
list-quote-unclosed.md
list-tab-unclosed.md
malformed-container-csharp.md
malicious-layout.md
marker-bleed.cs
multiline.cs
namespace-alias-name.cs
nested-file-scoped-namespace.cs
nested-list-tab-exposure.md
nested-list-tab-unclosed.md
network-callable-arguments.md
network-callable-builtin.cs
network-callable-contract.cs
network-callable-late-section-target.cs
network-callable-name.cs
network-callable-nonmethod.cs
network-callable-return.cs
network-callable-section-target.cs
network-callable-targets.md
network-callable-unity-builtin.cs
partial-overload/
partial-overload-fences.md
LocalPart.cs
NetworkPart.cs
platform-type-shadowing.md
public-nonvoid.cs
public-overload.cs
qualified-return.cs
quote-list-tab-exposure.md
sdk-callback-contracts.md
sdk-callback-return-shadow.cs
top-level-before-file-namespace.cs
tuple-return.cs
type-alias-return.cs
unclassified-public.cs
unicode-escape-exposure.cs
unicode-exposure.cs
unknown-attribute-binding.cs
unrelated-namespace-shadow.cs
unterminated-attribute.cs
unterminated-comment.cs
unterminated-csharp-fence.md
unterminated-literal.cs
verbatim-exposure.cs
valid/
attribute-binding.cs
attribute-shadowing.cs
cross-fence-attribute-shadow.md
cross-file-attribute-shadow-consumer.cs
cross-file-attribute-shadow-declaration.cs
declarations.cs
file-scoped-and-rates.cs
local-event-names.cs
markdown-containers.md
markdown-tab-containers.md
markdown.md
network-callable-parameter-types.cs
public-declarations.cs
sdk-video-callbacks.cs
unicode-and-aliases.cs
layers-reference-contract.test.sh
network-event-hardening.test.sh
skill-routing-contract.test.sh
hooks/
fixtures/
validate-udonsharp/
cases.tsv
editor-only.cs
rules.tsv
runtime-all-rules.cs
runtime-attribute-blank-trivia.cs
runtime-attribute-boundaries.cs
runtime-base-aliased-namespace.cs
runtime-base-aliased-type.cs
runtime-base-direct.cs
runtime-base-global.cs
runtime-base-qualified.cs
runtime-clean-decoys.cs
runtime-compact-sync-after-ordinary.cs
runtime-compact-sync-declarations.cs
runtime-constructor-return-decoys.cs
runtime-expression-body-decoys.cs
runtime-general-decoys.cs
runtime-general-user-method-parameters.cs
runtime-indexer-decoy.cs
runtime-interpolation-code.cs
runtime-lambda-expression-body-return.cs
runtime-lambda-same-line.cs
runtime-mask-boundaries.cs
runtime-method-overload-attribute-named-arguments.cs
runtime-method-overload-modifiers.cs
runtime-method-overload-multiline-only.cs
runtime-multidim-whitespace.cs
runtime-multiline-attributes.cs
runtime-nested-attribute-decoys.cs
runtime-real-calls.cs
runtime-split-lambda-lines.cs
runtime-sync-conflict.cs
runtime-sync-declarators.cs
runtime-sync-initializer-commas.cs
runtime-unicode-expression-body-decoys.cs
runtime-unicode-identifiers.cs
template-cases.tsv
validate-udonsharp.busybox.test.sh
validate-udonsharp.test.ps1
validate-udonsharp.test.sh
unity-project-for-sdk-search/
README.mdFAQ
agent-skills-vrc-udon is a Claude Code plugin with 3 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes unity-vrc-skills-renovator, unity-vrc-udon-sharp, unity-vrc-world-sdk-3. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is agent-skills-vrc-udon?
- Skills, rules, and validation hooks that teach AI coding agents to generate correct UdonSharp code
- How do I install agent-skills-vrc-udon?
- Run these in Claude Code: /plugin marketplace add niaka3dayo/agent-skills-vrc-udon then /plugin install vrc-udon-skills@agent-skills-vrc-udon. Then prompt normally.
- Does agent-skills-vrc-udon auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is agent-skills-vrc-udon free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.