collision-proxy skill
✓ VerifiedCreate and name collision proxies like UCX/UHX, convex hulls, and capsules in Blender for game engines.
- GitHub stars
- 2,677
- Files
- 3
- Last commit
- Nov 6, 2026
- License
- MIT
- Allowed tools
- —
What does the collision-proxy skill do?
collision-proxy creates and name collision proxies like UCX/UHX, convex hulls, and capsules in Blender for game engines.
Summary generated from the skill's SKILL.md.
About the collision-proxy skill
Creating collision proxies like UCX, UHX, convex hulls, and capsules directly within Blender is what this skill enables for game developers. It assists in building stable physics volumes and hitboxes that are optimized for game engines rather than using high-detail render meshes. An agent should load this tool when a user needs to generate blocking volumes, character capsules, or complex vehicle colliders that follow specific engine requirements.
The workflow produces correctly named and structured geometry, such as UCX_SM_Asset_01 for Unreal Engine auto-association. It relies on specific authoring rules, including keeping proxies in a dedicated COL_Collision collection and ensuring shapes are watertight and convex. By prioritizing simple shapes like boxes, spheres, and capsules over complex meshes, the skill helps prevent physics snagging and ensures assets are ready for export to Unity or Unreal.
What an agent can do with it
- 1Build character physics volumesDesign capsule colliders specifically intended for character movement and poles.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the collision-proxy skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the collision-proxy skill in Claude Code
~/.claude/skills/collision-proxy/SKILL.md
$ npx degit arjun988/blender-skills/.claude/skills/collision-proxy ~/.claude/skills/collision-proxyInstall the collision-proxy skill in Claude Code (project)
.claude/skills/collision-proxy/SKILL.md
$ npx degit arjun988/blender-skills/.claude/skills/collision-proxy .claude/skills/collision-proxyInstall the collision-proxy skill in Codex
~/.agents/skills/collision-proxy/SKILL.md
$ npx degit arjun988/blender-skills/.claude/skills/collision-proxy ~/.agents/skills/collision-proxyInstall the collision-proxy skill in Gemini CLI
~/.gemini/skills/collision-proxy/SKILL.md
$ npx degit arjun988/blender-skills/.claude/skills/collision-proxy ~/.gemini/skills/collision-proxyInstall the collision-proxy skill in Claude.ai
npx degit arjun988/blender-skills/.claude/skills/collision-proxy collision-proxy && zip -r collision-proxy.zip collision-proxy # claude.ai → Customize → Skills → + → Create skill → Upload a skill → collision-proxy.zip
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work · What to fix for more points
- Source repository linked and reachablearjun988/blender-skills/.claude/skills/collision-proxy is public and reachablegithub.com/arjun988/blender-skills/tree/HEAD/.claude/skills/ ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-06github.com/arjun988/blender-skills/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/arjun988/blender-skills/blob/HEAD/.claude/skills/ ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/arjun988/blender-skills/blob/HEAD/.claude/skills/ ↗Pass
- SKILL.md follows the Agent Skills formatthe description does not say when to use the skillgithub.com/arjun988/blender-skills/blob/HEAD/.claude/skills/ ↗Finding
SKILL.md
View on GitHubCollision Proxy
Simple, stable colliders. Prefer primitives and convex pieces over render mesh.
When to Use
- Game physics / blocking volumes
- Unreal UCX export
- Unity mesh or primitive colliders
- Hitboxes for interactables
Workflow
Identify collision needs → Build proxies → Name correctly
→ Test overlaps → Export with render mesh
Collider Types
| Type | Use |
|---|---|
| Box | Crates, walls, simple props |
| Capsule | Characters, poles |
| Sphere | Balls, soft approximates |
| Convex hull | Organic / irregular single body |
| Multiple convex (UCX) | Vehicles, complex props |
Unreal Naming
UCX_SM_Asset_01
UCX_SM_Asset_02
- Must match associated mesh naming rules for auto-association
- Convex only for UCX
Unity Notes
- Prefer engine primitives when possible
- Mesh colliders: convex toggle for dynamic rigidbodies
- Keep proxy collection exportable
Authoring Rules
- Slightly smaller than visual mesh to reduce snagging (project-dependent)
- No holes; watertight convex pieces
- Apply scale
- Origin aligned with render mesh
- Collection:
COL_Collision_[Asset]
Validation
- Player cannot fall through intended blockers
- No huge invisible walls beyond mesh
- Wheel/character capsules oriented correctly
- Named for target engine
Constraints
MUST DO
- Prefer few simple shapes over one complex mesh
- Match engine naming conventions
- Keep proxies in dedicated collection
MUST NOT DO
- Use render LOD0 as physics mesh by default
- Non-convex UCX for Unreal auto-convex workflows
Reference Guide
| Topic | Reference | Load When |
|---|---|---|
| Collider Recipes | references/collider-recipes.md |
When needed |
| Engine Naming | references/engine-naming.md |
When needed |
Files in this skill
3collision-proxy skill questions
How do I install the collision-proxy skill in Claude Code?
Run npx degit arjun988/blender-skills/.claude/skills/collision-proxy ~/.claude/skills/collision-proxy. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the collision-proxy skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
How should I name collision meshes for Unreal Engine?
Collision meshes for Unreal should follow the UCX naming convention, such as UCX_SM_Asset_01, to ensure auto-association with the mesh.
What are the best practices for authoring collision proxies?
Proxies should be slightly smaller than the visual mesh to prevent snagging, must be watertight with no holes, and should have applied scale with the origin aligned to the render mesh.
Which collider types are recommended for different objects?
Use boxes for crates or walls, capsules for characters or poles, spheres for balls, and convex hulls for organic or irregular single bodies.