unity-terrain
Operate on Unity Terrain
Install / Use
npx skills add Besty0728/Unity-Skills --skill terrainInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of unity-terrain
unity-terrain scores 83/100 on our quality scale, 3104th of 4,698 Development & Engineering skills we index.
Its SKILL.md is 13 KB long, well organised into 42 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
With 1,781 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so unity-terrain is actively maintained.
- Our last check on 2026-11-07 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unity-terrain compared with similar skills
All 4 of these similar skills score higher than unity-terrain; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unity-terrain (this skill)by Besty0728 | 83 | 1.8k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install unity-terrain?
- Run
npx skills add Besty0728/Unity-Skills --skill unity-terrain. The install tabs above show the steps for each supported agent. - Which AI agents does unity-terrain work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is unity-terrain safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is unity-terrain still maintained?
- The repository was last updated about 2 months ago, so unity-terrain is actively maintained.
Skill content
View source on GitHubname: unity-terrain description: Operate on Unity Terrain
Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via
GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Creating or editing terrain
- Sculpting or smoothing heightmap
- Painting terrain texture layers
- 创建或编辑地形、雕刻或平滑高度图、绘制地形纹理层
Unity Terrain Skills
Guardrails
Operating Mode (v1.9 three-tier):
- Approval (default): query skills (
terrain_get_info,terrain_get_height) run directly. Create/modify skills (terrain_create,terrain_set_height,terrain_set_heights_batch,terrain_add_hill,terrain_generate_perlin,terrain_smooth,terrain_flatten,terrain_paint_texture) are FullAuto — onMODE_RESTRICTED, run the grant protocol;/permission/grantexecutes the skill server-side and returns the result. - Auto / Bypass: SemiAuto and FullAuto run directly.
- This module contains no Delete / PlayMode / Reload /
RiskLevel="high"skills — nothing auto-classifies as forbidden. To remove a terrain delete the asset viaasset_delete(subject to its own forbidden rules).
Note: All sculpt/paint operations require an existing Terrain in the scene, or use
terrain_createto generate one.
DO NOT (common hallucinations):
terrain_set_texturedoes not exist → useterrain_paint_texturewith layer index and brush parametersterrain_add_tree/terrain_add_grassdo not exist → these require Unity Terrain tools or custom scriptsterrain_set_sizedoes not exist → terrain dimensions are set at creation viaterrain_createterrain_import_heightmap/terrain_set_heightsdo not exist → useterrain_set_heights_batchwith a 2D heights array ([z][x]values 0-1)
Routing:
- For terrain material → use
materialmodule on terrain's material - For objects on terrain → use
gameobjectmodule to create/place objects
Skills Overview
| Skill | Description |
|-------|-------------|
| terrain_create | Create new Terrain with TerrainData |
| terrain_get_info | Get terrain size, resolution, layers |
| terrain_get_height | Get height at world position |
| terrain_set_height | Set height at normalized coords |
| terrain_set_heights_batch | Batch set heights in region |
| terrain_add_hill | ⭐ Add smooth hill with radius and falloff |
| terrain_generate_perlin | ⭐ Generate natural terrain using Perlin noise |
| terrain_smooth | ⭐ Smooth terrain to reduce sharp edges |
| terrain_flatten | ⭐ Flatten terrain to target height |
| terrain_paint_texture | Paint texture layer at position |
Skills
terrain_create
Create a new Terrain GameObject with TerrainData asset.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | No | "Terrain" | Terrain name |
| width | int | No | 500 | Terrain width (X) |
| length | int | No | 500 | Terrain length (Z) |
| height | int | No | 100 | Max terrain height (Y) |
| heightmapResolution | int | No | 513 | Heightmap resolution (power of 2 + 1) |
| x, y, z | float | No | 0 | Position |
Returns: {success, name, instanceId, terrainDataPath, size, position}
terrain_get_info
Get terrain information.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | Terrain name |
| instanceId | int | No* | Instance ID |
*If neither provided, uses first terrain in scene
Returns: {success, name, instanceId, position, size, heightmapResolution, alphamapResolution, detailResolution, terrainLayerCount, layers}
terrain_get_height
Get terrain height at world position.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| worldX | float | Yes | World X coordinate |
| worldZ | float | Yes | World Z coordinate |
| name | string | No | Terrain name |
Returns: {success, worldX, worldZ, height, worldY}
terrain_set_height
Set height at normalized coordinates.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| normalizedX | float | Yes | X position (0-1) |
| normalizedZ | float | Yes | Z position (0-1) |
| height | float | Yes | Height value (0-1) |
| name | string | No | Terrain name |
| instanceId | int | No | Terrain instance ID |
Returns: {success, normalizedX, normalizedZ, height, pixelX, pixelZ}
terrain_set_heights_batch
⚠️ BATCH SKILL: Set heights in rectangular region.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| startX | int | Yes | Start X pixel index |
| startZ | int | Yes | Start Z pixel index |
| heights | float[][] | Yes | 2D array [z][x] with values 0-1 |
| name | string | No | Terrain name |
| instanceId | int | No | Terrain instance ID |
Returns: {success, startX, startZ, modifiedWidth, modifiedLength, totalPointsModified}
# Example: Create a 10x10 hill
heights = [[0.5 - abs(x-5)/10 - abs(z-5)/10 for x in range(10)] for z in range(10)]
call_skill("terrain_set_heights_batch", startX=50, startZ=50, heights=heights)
terrain_add_hill
⭐ RECOMMENDED: Add a smooth, natural-looking hill to the terrain.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| normalizedX | float | Yes | - | X position (0-1) |
| normalizedZ | float | Yes | - | Z position (0-1) |
| radius | float | No | 0.2 | Hill radius (0-1, relative to terrain size) |
| height | float | No | 0.5 | Hill height (0-1) |
| smoothness | float | No | 1.0 | Smoothness factor (higher = smoother) |
| name | string | No | null | Terrain name |
| instanceId | int | No | 0 | Terrain instance ID |
Returns: {success, centerX, centerZ, radius, height, affectedArea}
# Add a large smooth hill at center
call_skill("terrain_add_hill",
normalizedX=0.5, normalizedZ=0.5,
radius=0.3, height=0.6, smoothness=2.0)
# Add multiple hills for varied terrain
for i in range(5):
call_skill("terrain_add_hill",
normalizedX=random.uniform(0.2, 0.8),
normalizedZ=random.uniform(0.2, 0.8),
radius=random.uniform(0.1, 0.25),
height=random.uniform(0.3, 0.7))
terrain_generate_perlin
⭐ RECOMMENDED: Generate natural-looking terrain using Perlin noise algorithm.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scale | float | No | 20.0 | Noise scale (lower = larger features) |
| heightMultiplier | float | No | 0.3 | Height intensity (0-1) |
| octaves | int | No | 4 | Detail layers (more = more detail) |
| persistence | float | No | 0.5 | Amplitude decrease per octave |
| lacunarity | float | No | 2.0 | Frequency increase per octave |
| seed | int | No | 0 | Random seed (0 = random) |
| name | string | No | null | Terrain name |
Returns: {success, resolution, scale, heightMultiplier, octaves, persistence, lacunarity, seed}
# Generate rolling hills
call_skill("terrain_generate_perlin",
scale=25.0, heightMultiplier=0.4, octaves=4)
# Generate mountainous terrain
call_skill("terrain_generate_perlin",
scale=15.0, heightMultiplier=0.6, octaves=6, persistence=0.6)
# Generate with specific seed for reproducibility
call_skill("terrain_generate_perlin",
scale=20.0, heightMultiplier=0.5, seed=12345)
terrain_smooth
⭐ Smooth terrain heights to reduce sharp edges and create natural transitions.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| normalizedX | float | Yes | - | X position (0-1) |
| normalizedZ | float | Yes | - | Z position (0-1) |
| radius | float | No | 0.1 | Smoothing radius (0-1) |
| iterations | int | No | 1 | Number of smoothing passes |
| name | string | No | null | Terrain name |
| instanceId | int | No | 0 | Terrain instance ID |
Returns: {success, centerX, centerZ, radius, iterations, affectedArea}
# Smooth a specific area
call_skill("terrain_smooth",
normalizedX=0.5, normalizedZ=0.5,
radius=0.2, iterations=3)
terrain_flatten
⭐ Flatten terrain to a specific height in a region.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| normalizedX | float | Yes | - | X position (0-1) |
| normalizedZ | float | Yes | - | Z position (0-1) |
| targetHeight | float | No | 0.5 | Target height (0-1) |
| radius | float | No | 0.1 | Flatten radius (0-1) |
| strength | float | No | 1.0 | Flatten strength (0-1) |
| name | string | No | null | Terrain name |
| instanceId | int | No | 0 | Terrain instance ID |
Returns: {success, centerX, centerZ, targetHeight, radius, strength}
# Create a flat plateau
call_skill("terrain_flatten",
normalizedX=0.5, normalizedZ=0.5,
targetHeight=0.6, radius=0.15, strength=1.0)
terrain_paint_texture
Paint terrain texture layer. Requires terrain layers already configured.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| normalizedX | float | Yes | - | X position (0-1) |
| normalizedZ | float | Yes | - | Z position (0-1) |
| layerIndex | int | Yes | - | Terrain layer index (0-based; use terrain_get_info to query available layers) |
| strength | float | No | 1.0 | Paint strength |
| brushSize | int | No | 10 | Brush size in pixels |
| name | string | No | null | Terrain name |
| instanceId | int | No | 0 | Terrain instance ID |
Returns: {success, layerIndex, layerName, centerX, centerZ, brushSize, strength}
Example Usage
import unity_skills
# === Method 1: Quick terrain with Perlin noise (RECOMMENDED) ===
# Create terrain
result = unity_skills.call_skill("terrain_create",
name="MyTerrain", width=200, length=200, height=50)
# Generate natural terrain with Perlin noise
unity_skills.call_skill("terrain_generate_perlin",
scale=20.0, # Larger scale = bigger features
heightMultiplier=0.4, # Height intensity
octaves=5, # More octaves = more detail
persistence=0.5,
lacunarity=2.0)
# === Method 2: Add individual smooth hills ===
# Create flat terrain
result = unity_skills.call_skill("terrain_create",
name="HillyTerrain", width=200, length=200, height=50)
# Add multiple smooth hills
import random
for i in range(8):
unity_skills.call_skill("terrain_add_hill",
normalizedX=random.uniform(0.2, 0.8),
normalizedZ=random.uniform(0.2, 0.8),
radius=random.uniform(0.15, 0.3),
height=random.uniform(0.3, 0.6),
smoothness=1.5) # Higher = smoother
# Smooth the entire terrain for natural transitions
unity_skills.call_skill("terrain_smooth",
normalizedX=0.5, normalizedZ=0.5,
radius=0.5, iterations=2)
# === Method 3: Create specific features ===
# Create a mountain
unity_skills.call_skill("terrain_add_hill",
normalizedX=0.5, normalizedZ=0.5,
radius=0.25, height=0.8, smoothness=2.0)
# Create a flat plateau on top
unity_skills.call_skill("terrain_flatten",
normalizedX=0.5, normalizedZ=0.5,
targetHeight=0.8, radius=0.1, strength=1.0)
# === Method 4: Manual height control (advanced) ===
import math
heights = []
for z in range(64):
row = []
for x in range(64):
# Distance from center
dx = (x - 32) / 32
dz = (z - 32) / 32
dist = math.sqrt(dx*dx + dz*dz)
# Smooth hill with cosine falloff
h = max(0, 0.5 * math.cos(dist * math.pi / 2)) if dist < 1 else 0
row.append(h)
heights.append(row)
unity_skills.c
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
