wimpysworld/nix-config/using-ebitengine

Claude Code and agent skill by wimpysworld/nix-config

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Install

npx vskill@latest install wimpysworld/nix-config/using-ebitengine

SKILL.md

Using Ebitengine

Ebitengine is a 2D game engine for Go. This skill covers sharp rendering, efficient drawing, Kage shaders, and headless runs.

Freshness. Upstream wrote this guidance against Ebitengine at commit 345100b0e4b75ed7e06d2a1cd84571814a5e6140.
exp/vmhost is experimental, and its API can change. If this guidance disagrees with the source, the source wins.
Use the godoc and source of the target Ebitengine version for API and platform behaviour.
Report drift to the user. Do not edit the installed skill.

Core facts

These facts apply to every Ebitengine task.

  • Render detail at the resolution where it is displayed. Implement LayoutF and return the outside dimensions times ebiten.Monitor().DeviceScaleFactor().

A low-resolution stage anywhere in the path loses detail that later scaling cannot recover.

  • The number of Go drawing calls is not the number of GPU draw commands. Ebitengine packs eligible images into automatic texture atlases and merges compatible successive draws.

Check the real commands with -tags=ebitenginedebug before you change drawing code for performance.

  • Kage coordinates are atlas-absolute, in pixels. Put //kage:unit pixels in every shader.

Subtract the image origin before you scale a coordinate, and add the origin back after.

  • Ebitengine uses premultiplied alpha everywhere, shaders included. A shader must return a premultiplied vec4.
  • Prefer a headless run for screenshots, golden-image tests, and input repros. An app built with -tags ebitenginevmguest runs as an exp/vmhost guest of a hidden host.

The host driver is scripts/headless-driver/main.go. A Guigui app is an ebiten.Game, so the same procedure applies to it.

  • Compile against the target Ebitengine version before you use a newer API such as FilterPixelated or imageSrcNAtFromSrc0Pos.

References

All reference paths in this skill are relative to the skill root. Read the reference for the task before you write code.

TaskReference
A new app, layout, text, UI, image scaling, final presentation, blurry output, pixel art, high-DPI displays, input coordinatesreferences/crisp-rendering.md
Drawing code, sprites, offscreen passes, batching, texture atlases, unmanaged images, rendering performancereferences/efficient-rendering.md
A headless run with no display or visible window: screenshots, golden images, input injection, multi-tick repros, audio checksreferences/headless-run.md and scripts/headless-driver/main.go
Writing, reviewing, or debugging a Kage shader: coordinate model, sampling, premultiplied alpha, language limits, a compile checkreferences/kage-shaders.md
Porting a shader from GLSL, Shadertoy, HLSL, Unity, or Godot to Kage, and the CPU-side draw callreferences/kage-porting.md
Kage snippets: normalisation, addressing modes, bilinear sampling, pixelation, blur, branchless selectors, debugging rampsreferences/kage-recipes.md

For a shader port, read references/kage-shaders.md first, then references/kage-porting.md.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/wimpysworld/nix-config/using-ebitengine/badge)](https://verified-skill.com/skills/wimpysworld/nix-config/using-ebitengine)

Something wrong with this skill or its page? Tell us.