estella-performance

estella-performance is a skill for Claude Code, Codex from esengine/estella. It costs 88 tokens per session (1,219 once invoked), scanned A, original, Apache-2.0.

How to find and fix what makes an Estella game slow - measure the frame before touching anything, tell CPU from GPU from waiting, find the system or the draws that cost, apply the fix the engine already has (batching, LOD, quality levels, gated systems), and prove the gain with the same measurement on the device it…

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Install with agentmods
npx agentmods add skills/esengine/estella/estella-performance
About the project

Estella is a 2D and 3D game engine with a TypeScript interface, a C++/WebAssembly core, and a visual editor that also acts as an MCP server. It helps developers create, test, and export games for the web, desktop, mini-game platforms, playable ads, and native mobile devices. Its catalogue add-ons let coding agents operate the editor through the same tool surface used by its interface.

esengine/estella · 1,174 stars · on GitHub · estellaengine.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add esengine/estella --skill estella-performance
Clone the repo
git clone --depth 1 https://github.com/esengine/estella

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for estella-performance

README.md
[![agentmods](https://agentmods.dev/badge/skills/esengine/estella/estella-performance/github.svg)](https://agentmods.dev/skills/esengine/estella/estella-performance)
Your own site
<a href="https://agentmods.dev/skills/esengine/estella/estella-performance"><img src="https://agentmods.dev/badge/skills/esengine/estella/estella-performance/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for estella-performance

Your own site · 80×15
<a href="https://agentmods.dev/skills/esengine/estella/estella-performance"><img src="https://agentmods.dev/badge/skills/esengine/estella/estella-performance.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 88 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,219 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin unknown No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00088 $0.01219
Opus 5.5 $0.00035 $0.00488
Sonnet 5.5 $0.00018 $0.00244
Haiku 4.5 $0.00009 $0.00122

Measured today against content hash 794c93843634, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

estella-performance scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/estella-performance/SKILL.md · 69 lines

How it starts

The opening of the file, as written. The whole thing — 69 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Performance

Never say a game is fast or slow without a number, and never fix what was not measured. The loop is: measure, find the one largest cost, change one thing, measure again the same way.

Measure honestly

  • Measure the RUNNING game: set_play { state: "playing" }, then step a few hundred frames so shaders, streaming and generation are warm. The first frames of anything are not its cost.
  • profile_frames says where the frame went: cpuMs (work), gpuMs, and waitMs, which is the CPU waiting for the display and NOT a hotspot. stalled: true means no frame ran: say so, do not read the zeroes as fast. An editor window in the background runs at about 1 FPS, and that is not a result either.
  • Read p95 and p99 and the long frames, not only the average: a stutter is one bad frame the average hides.
  • This machine is not the target. A phone's CPU is several times slower than a desktop's: a system costing 0.5 ms here is 2 or 3 ms of a phone's 16. Judge desktop numbers at that scale, and measure on the device when it matters: a development build (export_game { debugChannel: true }) appears in device_targets, then set_profiler_source { source: realm } points profile_frames and capture_frame at it. A game can also record a .esprof with ProfileRecorder on a player's device; profile_capture reads it, worstFrame first.
  • Measure before and after the same way: same scene, same camera, same frames stepped. Two runs differ by noise; repeat and take the better of each before believing a small gain.

CPU: which system

profile_frames lists cost per domain (scripts, render, physics, ui) and the costliest systems with what their queries walked. get_systems gives the same per frame.

  • filtered near scanned is a system walking the whole world to throw it away. Query for the component it needs, or use a change filter that skips, not one that visits.
  • A system that runs every frame for a feature the scene may not use is gated with activeWhen: app.addSystemToSchedule(schedule, system, { activeWhen: [MyComponent] }) skips it while no entity has the component.
  • A frame where nothing changed should cost almost nothing. Writing a component every frame with the value it already has makes everything downstream redo its work (a UI write lays the whole tree out again): write only on change.
  • Allocation in a per-frame loop (new objects, arrays, closures) comes back as garbage-collection long frames.

Read the full file on GitHub · 69 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 69 lines · 88 tokens per session scan A 794c93843634

Subscribe to this mod's changes

estella-performance is a skill published in the GitHub repository esengine/estella (1,174 stars, last pushed today), licensed Apache-2.0. It adds 88 tokens to every session and 1,219 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-19.

Related

estella-performance compared with skills from other repositories

estella-performance next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
estella-performanceesengine/estellaSkill1.2ktodayApache-2.0A88Claude Code, Codex
cougr-game-startersalazarsebas/CougrSkill5328d agoMITA68Claude Code, Codex
hearth-artechoo19/hearthSkill431mo agoMITA89Claude Code
hearth-feelechoo19/hearthSkill431mo agoMITA97Claude Code
hearth-buildechoo19/hearthSkill431mo agoMITA75Claude Code
hearth-codeechoo19/hearthSkill431mo agoMITA88Claude Code
hearth-designechoo19/hearthSkill431mo agoMITA109Claude Code