agentleFS
batihandevbatihandev/unity-mcp-skills/skills/optimization/SKILL.md

unity-optimization

Skill7 starsChanged 7 months agoMITView on GitHub

Use when users want to optimize textures, meshes, or improve performance.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Add or configure LOD Group.

    line 125

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Optimization Skills

Overview

Optimize project assets (Textures, Models).

Common Mistakes

DO NOT (common hallucinations):

  • optimize_scene / optimization_run do not exist → use specific skills: optimize_analyze_scene, optimize_find_large_assets, optimize_find_duplicate_materials, etc.
  • optimize_compress / optimize_compress_textures / optimize_compress_meshes / optimize_compress_audio do not exist → use optimize_textures (textures), optimize_mesh_compression (meshes), optimize_audio_compression (audio)
  • optimize_set_lod / optimize_setup_lod do not exist → use optimize_set_lod_group
  • Optimization skills are analysis + action tools — always review results before applying batch changes

Routing:

  • For profiler metrics → use native Unity_Profiler_* tools (see ../../mcp-tools.md)
  • For static batching flags → optimize_set_static_flags (this module)

Skills

optimize_textures

Optimize texture settings (maxSize, compression). Returns list of modified textures.

ParameterTypeRequiredDefaultDescription
maxTextureSizeintNo2048Max texture size
enableCrunchboolNotrueEnable crunch compression
compressionQualityintNo50Compression quality 0-100
filterstringNo""Asset filter

Returns: { success, count, message, modified }

optimize_mesh_compression

Set mesh compression for 3D models.

ParameterTypeRequiredDefaultDescription
compressionLevelstringNo"Medium"Compression level: Off/Low/Medium/High
filterstringNo""Asset filter

Returns: { success, count, compression, modified }

optimize_analyze_scene

Analyze scene for performance bottlenecks (high-poly meshes, excessive materials).

ParameterTypeRequiredDefaultDescription
polyThresholdintNo10000Triangle count threshold for high-poly warning
materialThresholdintNo5Material slot count threshold for excessive materials warning

Returns: { success, totalRenderers, totalTriangles, totalMaterialSlots, issueCount, issues }

optimize_find_large_assets

Find assets exceeding a size threshold (in KB).

ParameterTypeRequiredDefaultDescription
thresholdKBintNo1024Size threshold in KB
assetTypestringNo""Asset type filter (e.g. Texture2D, AudioClip)
limitintNo50Maximum number of results

Returns: { success, threshold, count, assets }

optimize_set_static_flags

Set static flags on GameObjects. flags: Everything/Nothing/BatchingStatic/OccludeeStatic/OccluderStatic/NavigationStatic/ReflectionProbeStatic

ParameterTypeRequiredDefaultDescription
namestringNonullGameObject name
instanceIdintNo0GameObject instance ID
pathstringNonullGameObject hierarchy path
flagsstringNo"Everything"Static flags to set
includeChildrenboolNofalseApply to all children recursively

Returns: { success, gameObject, flags, affectedCount }

optimize_get_static_flags

Get static flags of a GameObject.

ParameterTypeRequiredDefaultDescription
namestringNonullGameObject name
instanceIdintNo0GameObject instance ID
pathstringNonullGameObject hierarchy path

Returns: { success, gameObject, flags, isStatic }

optimize_audio_compression

Batch set audio compression. compressionFormat: PCM/Vorbis/ADPCM. loadType: DecompressOnLoad/CompressedInMemory/Streaming

ParameterTypeRequiredDefaultDescription
compressionFormatstringNo"Vorbis"Audio compression format: PCM/Vorbis/ADPCM
loadTypestringNo"CompressedInMemory"Audio load type: DecompressOnLoad/CompressedInMemory/Streaming
qualityfloatNo0.5Compression quality 0.0-1.0
filterstringNo""Asset filter

Returns: { success, count, compressionFormat, loadType, modified }

optimize_find_duplicate_materials

Find materials with identical shader and properties.

ParameterTypeRequiredDefaultDescription
limitintNo50Maximum number of duplicate groups to return

Returns: { success, duplicateGroups, groups }

optimize_analyze_overdraw

Analyze transparent objects that may cause overdraw.

ParameterTypeRequiredDefaultDescription
limitintNo50Maximum number of results

Returns: { success, transparentObjectCount, objects }

optimize_set_lod_group

Add or configure LOD Group. lodDistances: comma-separated screen-relative heights (e.g. '0.6,0.3,0.1')

ParameterTypeRequiredDefaultDescription
namestringNonullGameObject name
instanceIdintNo0GameObject instance ID
pathstringNonullGameObject hierarchy path
lodDistancesstringNo"0.6,0.3,0.1"Comma-separated screen-relative transition heights

Returns: { success, gameObject, lodLevels, distances }


Recipe path rule: ../../recipes/optimization/<command>.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.