gdx-claude-skills

libGDX Claude Code Skills

28 Claude Code skills that correct documented blind spots in Claude's knowledge of libGDX and related game development libraries. Each skill is a concise reference document targeting specific API traps, surprising behaviors, and poorly documented features that the base model gets wrong.

Designed for libGDX 1.14.1 (HEAD). Validated against Claude Sonnet 4.5 with a 59-test automated harness — 100% pass rate with skills, zero regressions.

Version notice: These skills are verified against libGDX 1.14.1 (current HEAD) and Claude model versions Opus 4.6, Sonnet 4.5, and Haiku 4.5. Future libGDX releases may change APIs, defaults, or behavior that these skills document. Future model versions may fix (or introduce) blind spots that shift which skills provide value. If you're using a different libGDX version or a newer Claude model, verify claims against source before relying on them.

Installation

Via Plugin (recommended)

# Add the marketplace (one-time)
/plugin marketplace add kyu-n/gdx-claude-skills

# Install the plugin
/plugin install gdx-claude-skills

Manual

Copy the skills you need into your project's .claude/skills/ directory or your user-level ~/.claude/skills/ directory:

# All skills
cp -r skills/* ~/.claude/skills/

# Or specific skills
cp -r skills/libgdx-box2d ~/.claude/skills/
cp -r skills/libgdx-2d-rendering ~/.claude/skills/

Claude Code automatically loads matching skills based on their description field when relevant to the conversation.

What Problems Do These Solve?

Claude's training data covers libGDX, but the model consistently gets specific details wrong — deprecated methods presented as current, constructor signatures with wrong argument order, invented APIs that don't exist, and subtle behavioral details (like coneDegrees being a half-angle, not full arc). These aren't gaps in general understanding; they're precise factual errors that produce code that compiles but behaves incorrectly.

For example:

Category	What Claude says	What's actually true
Deprecated API	config.renderInterval = 1/20f	renderInterval removed in 1.9.14; use config.updatesPerSecond = 20 (int)
Deprecated backend	Recommends gdx-backend-robovm for iOS	Apple deprecated OpenGL ES; use gdx-backend-robovm-metalangle
Wrong threading	downloadComplete() runs on background thread	Already on GL thread (internal postRunnable)
Wrong lifecycle	pause() fires on Alt+Tab (LWJGL3)	Only fires on minimize; use Lwjgl3WindowListener.focusLost()
Wrong defaults	preferredFramesPerSecond defaults to 60 (iOS)	Defaults to 0 (= max supported by screen)
Invented API	Color.CORNFLOWER_BLUE	No such constant in libGDX; use Color.SKY or raw floats
Invented API	window.getContentTable()	getContentTable() is on Dialog, not Window — Window extends Table directly
Missing method	InputProcessor has 8 methods	Has 9 — touchCancelled is consistently omitted
Subtle bounds	MathUtils.random() treats int and float the same	random(int,int) inclusive upper; random(float,float) exclusive upper
Wrong class	MessageDispatcher.getInstance() (gdx-ai)	MessageManager.getInstance() — MessageDispatcher has no getInstance()

See SUMMARY.md for methodology and full results.

Skills

Core

Skill	Covers
libgdx-application-lifecycle	ApplicationListener/Adapter, create vs constructor, render = update + draw, delta time, pause/resume platform differences, Disposable types
libgdx-audio-lifecycle	Sound vs Music, pan (mono only), Android 1MB limit, OGG unsupported on iOS, OnCompletionListener + looping incompatibility, Music auto-pause
libgdx-input-handling	Polling vs event-driven, InputProcessor/InputAdapter, InputMultiplexer, coordinate unprojection, GestureDetector, scrolled() direction, Android back/menu keys
libgdx-file-io-preferences	FileHandle/FileType, platform-specific paths, local vs internal vs external, Preferences API

Rendering