Skip to content
SkillScript-led2,839 tokens in use

unity-build-size

Helps an agent bring a Unity 6.3 build under a size limit: read the Build Report, fix uncompressed glTF textures and audio, and apply per-platform size levers.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/unity/unity-build-size
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing unity-build-size costs

95tokens idle
2,839tokens in use
8,857tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/build_report.py, scripts/check_unity_build_size.py.

Touches

shelldetectedgitdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure19/25
  • Examples12/15
  • Output10/15
  • Size15/15
  • Resources13/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 43
  • Runs git commands−5

    does this on the machine, and the frontmatter does not say so

    scripts/check_unity_build_size.py, line 444

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill helps an agent shrink a Unity player build that is over a size limit. It first pins which file is limited (a Web build file, an Android download, an iOS thinned size or a Steam patch), then measures what ships with a Build Report summary and a project checker, fixes the biggest category first and proves the result by rebuilding.

Two read-only Python scripts do the measuring. A reference covers glTFast models whose embedded images ship uncompressed, with two fixes, and per-platform references cover Web, Android, iOS and desktop or Steam.

What You Get

  • A five-step loop: pin the limited file, measure, find causes, fix the biggest category, rebuild and compare
  • A Build Report summarizer that lists categories and the largest assets and can fail a CI job over a budget
  • A project checker that names files, settings, estimated cost and a fix line, with a platform flag
  • References for glTF textures and for Web, Android, iOS and desktop or Steam size limits, plus an editor script for bulk texture limits

Common Use Cases

  • Getting a WebGL build under an itch.io per-file limit
  • Cutting an Android download size reported by Google Play
  • Finding glTF or GLB models that carry huge uncompressed textures
  • Failing a CI job when the uncompressed build passes a budget

What Makes It Unique

The skill starts by asking which size is limited and records a baseline, so effort goes to the number that matters. It finds a cause many texture checks miss: images embedded in glTF models bypass the Texture Importer, and the reference gives measured size tables and two fixes, including the sRGB step for moved textures.

Under The Hood

The agent loads the SKILL.md and reads only the platform reference that matches the target. It runs two Python scripts with the standard library: one parses the Unity Editor log for the last Build Report, and one scans the project’s meta files and models for size problems; both are read-only. The checker mentions git commands such as a Git LFS pull and a git move only in the fix lines it prints, so the agent decides whether to run them. It may run the optional Unity command line tool to build and keep a log, and the skill shows commands that fetch and run the glTF Transform tool through npx from the npm registry, which rewrites model files, so it asks you to commit first. It can add an editor script that changes texture import settings. Documentation links are named for re-checking.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers