How do I install the Optimization skill?

Run npx skillmds@latest add nethercore-systems/optimization in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Optimization safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Optimization?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Optimization free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Optimization?

nethercore-systems (@nethercore-systems) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Optimization by nethercore-systems — Agent Skill

Name: Optimization
Rating: 4.2 (5 reviews)
Author: nethercore-systems

Optimization

Optimization techniques for Nethercore WASM games. Covers WASM binary size reduction (LTO, wasm-opt), texture and mesh compression, audio optimization, and state size minimization. Use when a ROM exceeds size limits or when reducing build output size.

File contents

Nethercore Optimization

Measure first; use existing build/platform features before adding tooling. Keep simulation and asset correctness while reducing the resource actually over budget.

WASM

[profile.release]
lto = true
opt-level = "z"
codegen-units = 1
panic = "abort"

Compare size and runtime performance; "s" may be better for a particular game. Strip symbols only when debugging requirements permit. wasm-opt is optional, not a dependency to install blindly. If used, optimize the actual manifest-selected WASM before nether pack and rerun the cart; optimizing a loose file after packing changes nothing in the cart.

Textures and meshes

ZX RGBA8/BC7 selection is explicit [game].compress_textures, not automatically all textures. BC7 uses 16 bytes per 4x4 block, approximately 1 byte/pixel on aligned dimensions, not 0.5. Keep atlas padding/alpha and inspect actual VRAM.

Distinguish float input vertices from packed ROM/GPU vertices. Use zx-common's format/stride functions, not a fixed universal table. Drop attributes only when the render mode/material/normal mapping/skinning permits it. Preserve complete intended geometry through the first-mesh/primitive GLB importer.

Audio and state

Target PCM is 22050 Hz mono i16; raw WAV currently needs to arrive in that format. XM/IT pattern data plus shared samples can be compact, but there is no guaranteed percentage saving or fixed bytes-per-second for a tracker module.

Use bounded arrays when they fit. A Vec is not inherently non-deterministic if allocator/data/RNG state are snapshotted and iteration is stable. Smaller integer fields need explicit range/scale/overflow policy; i16 alone does not define fixed-point math. Do not reduce numeric accuracy merely to satisfy an arbitrary state-size target.

See optimization techniques for the verification sequence.

---name: optimizationdescription: Optimization techniques for Nethercore WASM games. Covers WASM binary size reduction (LTO, wasm-opt), texture and mesh compression, audio optimization, and state size minimization. Use when a ROM exceeds size limits or when reducing build output size.license: Apache-2.0---# Nethercore OptimizationMeasure first; use existing build/platform features before adding tooling. Keep simulation and asset correctness while reducing the resource actually over budget.## WASM```toml[profile.release]lto = trueopt-level = "z"codegen-units = 1panic = "abort"```Compare size and runtime performance; `"s"` may be better for a particular game. Strip symbols only when debugging requirements permit. `wasm-opt` is optional, not a dependency to install blindly. If used, optimize the actual manifest-selected WASM before `nether pack` and rerun the cart; optimizing a loose file after packing changes nothing in the cart.## Textures and meshesZX RGBA8/BC7 selection is explicit `[game].compress_textures`, not automatically all textures. BC7 uses 16 bytes per 4x4 block, approximately 1 byte/pixel on aligned dimensions, not 0.5. Keep atlas padding/alpha and inspect actual VRAM.Distinguish float input vertices from packed ROM/GPU vertices. Use `zx-common`'s format/stride functions, not a fixed universal table. Drop attributes only when the render mode/material/normal mapping/skinning permits it. Preserve complete intended geometry through the first-mesh/primitive GLB importer.## Audio and stateTarget PCM is 22050 Hz mono i16; raw WAV currently needs to arrive in that format. XM/IT pattern data plus shared samples can be compact, but there is no guaranteed percentage saving or fixed bytes-per-second for a tracker module.Use bounded arrays when they fit. A `Vec` is not inherently non-deterministic if allocator/data/RNG state are snapshotted and iteration is stable. Smaller integer fields need explicit range/scale/overflow policy; `i16` alone does not define fixed-point math. Do not reduce numeric accuracy merely to satisfy an arbitrary state-size target.See [optimization techniques](references/optimization-techniques.md) for the verification sequence.

Frequently asked questions