What Are Skills?
Skills are best-practice guides that make AI agents better at game development. Each skill is a folder with aSKILL.md that teaches the agent one discipline: composing a scene, building an FPS controller, generating a character model, setting up multiplayer, debugging a crash. The agent sees each skill’s name and one-line description, and loads the full body only when the situation matches.
Skills follow the Agent Skills open standard (<folder>/<skill>/SKILL.md), so the same files work in every agent listed on Every Supported Agent. The library ships inside the summer-engine npm package and is developed in the open at github.com/SummerEngine/summer. Every skill has its own page in these docs, with the full guide your agent reads: pick one from the catalog below or the Skills tab.
Quick Start
summer setup installs the whole library for the agent you name, in the same scope as the MCP config:
npx -y summer-engine@latest setup claude-code --yes
summer skills list # every skill, one line each
summer skills list --by-domain # grouped like this page
summer skills info debug # one skill's description and body
summer skills install --all --agent cursor # every skill for an agent
summer skills install --recommended --agent codex
summer skills install fps-controller --agent claude-code
summer skills install --all --agent cursor --force # refresh after an upgrade
--allinstalls every skill (default forsummer setup).--recommendedinstalls the smaller starter subset marked ★ below.--stable-onlyskips skills marked preview. Preview means the Summer team has not yet exercised the skill in-engine; the skill’s own text says so.--forcerewrites every installed skill and removes the copies older Summer versions wrote elsewhere (Cursor.mdcrules, OpenCodeagents/summer, per-agent folders from 3.1.0).--scope projectinstalls into the project folder so the skills travel with the game.
Where Skills Live
Most agents read the agentskills.io folder, so one install serves them all:| Agent | Skills folder (user) | Skills folder (project) |
|---|---|---|
| Codex, Cursor, Devin Desktop (formerly Windsurf), GitHub Copilot in VS Code, OpenCode, Zed, Kimi Code CLI, Crush, Amp, Factory Droid, Warp, Rovo Dev CLI, Grok Build | ~/.agents/skills (shared) | .agents/skills |
| Claude Code | ~/.claude/skills | .claude/skills |
| Antigravity | ~/.gemini/config/skills | .agents/skills |
| Cline (VS Code) | ~/.cline/skills | .cline/skills |
| Cline CLI | ~/.cline/skills | .cline/skills |
| Kilo Code | ~/.kilo/skills | .kilo/skills |
| GitHub Copilot CLI | ~/.copilot/skills | .github/skills |
| Kiro | ~/.kiro/skills | .kiro/skills |
| Goose | ~/.config/agents/skills | .agents/skills |
| Hermes Agent | ~/.hermes/skills | .agents/skills |
| Qwen Code | ~/.qwen/skills | .qwen/skills |
| Qoder CLI | ~/.qoder/skills | .qoder/skills |
| Mistral Vibe | ~/.vibe/skills | .agents/skills |
summer_get_agent_playbook tool.
summer doctor reports when installed skills are older than the CLI. Refresh with summer setup <agent> --yes --force. After an update to Summer 4.0, run it once so your skills use the 4.0 operation names.
Catalog
138 skills grouped by primary domain. Recommended marks the recommended set. A skill can belong to several domains; it is listed once, under its first. Rendered fromsummer-engine@4.9.2 on npm.
2D art
| Skill | Use when |
|---|---|
Character Portrait character-portrait Recommended | Generate one polished character bust for dialogue UI, character select, lore cards or codex entries. |
Concept Art concept-art Recommended | Explore art direction with 3-4 rough concept variants of a character, environment or prop. |
Create Asset Sheet create-asset-sheet | Generate a pack of 2D assets from one prompt (tile sheet, UI kit, character pack, biome), sliced. |
Hero Art hero-art (preview) | Hero splash art, seamless splash loops and rigged animated heroes, gated. |
Instantiate Asset Pack instantiate-asset-pack | Lay out a whole create-asset-sheet pack in the scene: composites, paint order, Sprite2D and NinePatch. |
Painted 2.5D World painted-25d-world (preview) | Build a 2D or 2.5D game as a painted world: a 3D blockout under one fixed camera, an AI paint-over projected onto it, sprite characters. |
Pixel Art pixel-art Recommended | Generate pixel-art sprites, items, tiles and portraits at a set resolution with a limited palette. |
Skybox Panorama skybox-panorama | Generate a 360-degree sky panorama and wire it as a PanoramaSkyMaterial Sky resource on WorldEnvironment. |
Sprite Sheet sprite-sheet | Generate animated 2D character sprite sheets (walk, attack, idle, death) for AnimatedSprite2D. |
Tileable Texture tileable-texture | Generate a seamless tileable texture for walls, floors or terrain, wired as a StandardMaterial3D albedo. |
UI Graphics ui-graphics | Generate game UI art (icons, buttons, panels, frames, HUD widgets) flat, on a transparent background. |
Use Widget Asset use-widget-asset | Wire a widget slice from an asset pack (panel, button, bar, toggle) into NinePatchRect or TextureRect. |
3D models
| Skill | Use when |
|---|---|
Character Model character-model Recommended | Generate a rigged humanoid (player, NPC, enemy, boss) from a T-pose reference, previewed before rigging. |
Environment Kit environment-kit | Generate a modular environment kit: walls, floor tiles, pillars, doors, arches in one visual style. |
Fabricating Assets fabricating-assets (preview) | Fabricate meshes with a Blender script (summer_fabricate_3d): exact-size kits, VFX meshes, post-processing. |
Organic Model organic-model | Generate organic 3D shapes (trees, rocks, mushrooms, plants, crystals) where irregularity looks natural. |
Prop Model prop-model Recommended | Generate one static 3D prop (sword, barrel, chest, lantern, statue): one object, no rig, a MeshInstance3D. |
Vehicle Model vehicle-model | Generate a hard-surface vehicle (car, spaceship, mech, boat, tank) as a static or VehicleBody3D mesh. |
Agent workflow
| Skill | Use when |
|---|---|
Bounded Engine Runs for Agents bounded-engine-runs Recommended (preview) | Run Summer headless or offscreen safely: time limits, one engine per project, import passes, crash checks. |
Brainstorming Ideas into Designs brainstorming Recommended | Explore user intent, requirements and design before any creative work: features, mechanics, behavior. |
Debugging Game Feel debugging-game-feel | Debug features that work but feel wrong: floaty jumps, mushy combat, sluggish camera. |
Diagnosing Performance Regressions diagnosing-perf-regressions | Find why frame rate, frame time or load time got worse since a known-good state. |
Dispatching Parallel Agents dispatching-parallel-agents | Work 2+ independent tasks in parallel when they share no state and have no sequential dependencies. |
Gameskill gameskill | Capture what a game-dev session learned as a reusable skill (project, user or Summer library) for next time. |
Godogen-Style Game Generation with Visual Proof QC godogen-visual-proof-game-generation (preview) | Godogen-style game generation with a visual QC loop — capture frames from the running game, self-verify against the brief, bounded fix rounds, proof clip. |
Headless Scripting headless-scripting Recommended | Run a GDScript file against Summer Engine from the shell for what no MCP tool does: navmesh, TileSets. |
Systematic Debugging investigating-bugs Recommended | Systematic investigation of any bug, test failure, or unexpected behavior before proposing fixes. |
Playtesting a Feature playtesting-a-feature Recommended | Before calling a gameplay feature done, run the game and walk through it. Static checks do not count. |
Running in the Cloud running-in-the-cloud | Run Summer Engine on a Linux box with no display: install, launch headless, xvfb, sign in without a browser. |
Skill Create skill-create | Bootstrap a new Summer library skill (library/skills/<slug>/ with resource.yaml and SKILL.md), frontmatter, and stub sections. |
Skill Improve skill-improve | Upgrade an underperforming Summer skill — run it against a behavioral spec with and without changes via a parallel-eval harness; ship the winner. |
Skill Test skill-test | Lint a Summer skill before commit, audit the whole library, or check a behavioral spec assertion — static structural rules plus behavioral specs. |
The Summer Board summer-board (preview) | Summer Board co-op: tasks, claims, files, card frames. |
How Granular to Model a Game summer-board-modeling (preview) | How granular to model a game on its Summer Board: what earns a type, what stays a note or a field, and starter type sets per genre. |
Board Cards in the Game summer-board-to-game (preview) | Bring a Summer Board’s typed cards into the game as Godot Resources, load them through BoardData, and keep board and game in step. |
Types on the Summer Board summer-board-types (preview) | Define and reuse types on a Summer Board (Character, Level, Item) so ideas become typed cards: read the board’s types first, reuse before you define. |
Summer from the Shell summer-cli Recommended (preview) | Summer as shell commands, no MCP: sign in, run operations, follow jobs, save files, drive the engine. |
Using Summer using-summer | Session bootstrap: how to find and use Summer skills and the summer-engine MCP before any response. |
Verification Before Completion verification-before-completion Recommended | Run verification and read its output before claiming work done, fixed or passing: evidence first. |
Writing Plans writing-plans | Turn a spec or requirements for a multi-step task into a written implementation plan before touching code. |
Writing Skills writing-skills | Create, edit, and verify agent skills — format, structure, testing with subagents, and best practices. |
AI and NPCs
| Skill | Use when |
|---|---|
Design NPC design-npc Recommended | Design enemy, NPC, boss or companion behavior: perception, state machine, telegraphs, script stub. |
Summer Router summer-router (preview) | AI characters for games on Summer Games: Summer Router replies, tools, speech, images. |
Animation
| Skill | Use when |
|---|---|
AnimationTree animation-tree | Wire AnimationTree state machines and blend trees: locomotion blends, attack interrupts, hit reactions. |
Character Animation Wiring character-animation-wiring | Wire a rigged character end to end: real clips and bones, locomotion states, method tracks, root motion. |
Facial Animation & Lipsync facial-and-lipsync | Make a character’s mouth move with a voice-over: phonemes, viseme blendshapes, facial expressions. |
Generate Motion generate-motion Recommended | Attach a library animation clip (idle, walk, run, attack) to a rigged character via AnimationPlayer. |
Procedural Animation procedural-animation | Runtime bone changes on top of clips: head look-at, foot IK, hand grabs a prop, lean, recoil. |
Retarget Motion retarget | Apply animation clips from one rigged character to another: one clip library, many models. |
Text to Motion text-to-motion (preview) | Make custom 2-second animation clips from text on the user’s own rigged models: people, animals, props. |
Asset pipeline
| Skill | Use when |
|---|---|
Asset Strategy asset-strategy Recommended | Route any ‘I need a [thing]’ asset request to the right skill: 2D, 3D, audio, video, VFX or animation. |
Single-Image → Editable Scene Reconstruction lumera-single-image-scene-reconstruction (preview) | Lumera-style single image to editable 3D scene — VLM-parsed object boxes and parametric lights, per-object meshes, HDR probe, .tscn assembly, refinement loop. |
Auto-Rigging Static Meshes with Skin-Tokens.cpp skintokens-auto-rigging (preview) | Offline auto-rigging with skin-tokens.cpp (GGML SkinTokens/TokenRig port) — skeleton and skin weights from a static GLB mesh on CPU/Vulkan, into Summer Engine. |
Summer API summer-api (preview) | Summer API game assets: models, estimate, one job or a batch, download the files. |
Summer Assets Without the Engine summer-assets | Game assets for any engine, no Summer Engine: find, generate and download them. |
Audio
| Skill | Use when |
|---|---|
Adaptive Music adaptive-music | Wire music stems to game state: combat, explore, boss and tension crossfades on a shared bus. |
Ambient Bed ambient-bed | Generate a long looping location ambience (forest, dungeon, city, cave) on the Ambient bus. |
Audio Direction audio-direction Recommended | Define the game’s sound (music style, SFX vocabulary, dynamic music) as .summer/audio-bible.md. |
Music Track music-track Recommended | Generate a music track: game loops of 30s or more with a loop point, or linear cinematic cues. |
Sound Effect sound-effect Recommended | Make sound effects (swings, hits, whooshes, reloads, UI): three versions to pick from, then wire them. |
Voice Line voice-line Recommended | Generate voice lines (NPC barks, narrator, dialogue) with a character-to-voice choice and multi-line support. |
Character controllers
| Skill | Use when |
|---|---|
Character Movement character-movement (preview) | Player controllers for 2D and 3D, plus the standard third-person controller for Summer humanoids. |
FPS Controller fps-controller Recommended | First-person controller: WASD, mouse look, jump, coyote time, jump buffering, air control. |
Publishing and growth
| Skill | Use when |
|---|---|
Grow Analytics grow-analytics | Read a creator’s Summer Grow numbers (page views, launches, sessions, play time), compare windows. |
Launch Ready launch-ready (preview) | Get a game ready to launch on Summer Games and take it live: upload, real screenshots, store art and listing, gathered and filled in. |
Make Content make-content | Make a finished, postable video of your game, cut per platform and saved for review. |
Publish Your Game publish-your-game | Publish a game on Summer Games over MCP: store page, art, build upload, go live. |
Release Checklist release-checklist (preview) | Pre-launch check for Summer Games: export, upload checks, store art, listing fields. |
Store Art store-art | Make Summer Games store art per slot: key art, icons, screenshots, trailer, sizes. |
Store Listing store-listing | Write a Summer Games store page: title, tagline, descriptions, tags, what never to write. |
Debugging
| Skill | Use when |
|---|---|
Debug debug Recommended | Disciplined bug, crash and error loop: script errors, console, debugger, hypothesis, fix, verify. |
Deployment
| Skill | Use when |
|---|---|
Export and Ship export-and-ship Recommended | Prepare a game export: check templates and targets, validate release assets, build after approval. |
Release Readiness release-readiness (preview) | Prove players can play a Summer release: server, online join, progress, files. |
Remote Deploy remote-deploy Recommended | Run or test the game on a real phone, tablet or computer with Remote Deploy and on-device debugging. |
Editor
| Skill | Use when |
|---|---|
Driving the Editor UI driving-the-editor-ui (preview) | Drive the editor UI by name: run actions, clear blocking dialogs, switch screens, read a dock. |
Gameplay
| Skill | Use when |
|---|---|
Auto-Fire Weapon Targeting auto-fire-targeting | Fix auto-fire targeting (survivors, ARPG, tower defense) with pending damage to stop overkill. |
Celeste-Style Momentum Platforming celeste-momentum-platforming (preview) | Celeste-style 2D precision platformer movement — momentum running, coyote time, variable jumps, dash, wall jump/slide, climb stamina, pixel corner correction. |
Combat Basics combat-basics (preview) | Damage: hitbox and hurtbox Areas, a reusable Health component, damage signals, knockback, projectiles. |
Design Mechanic design-mechanic Recommended | Design one mechanic in detail (input, feedback, failure modes, tunables) as a doc plus a script stub. |
In-Game Purchases with Sparks in-game-purchases (preview) | Sell items for Sparks via the Summer purchase sheet: checkout, not enough Sparks, unlocks, grants. |
Web and Touch Input web-and-touch-input Recommended (preview) | Browser and phone input: the first-click rule for sound and mouse capture, focus, touch buttons, a stick. |
Level design
| Skill | Use when |
|---|---|
Concept to Level concept-to-level (preview) | 3D map from concept art to a shippable level: user questions, owned lanes, render checks, collision in step. |
Design Level design-level Recommended | Design one level (layout, pacing, encounters, secrets) as a design doc plus a node-tree skeleton. |
Scene to Level scene-to-level | Turn a reference image or concept art into a playable scene: concept, asset pack, terrain, assembly. |
Multiplayer
| Skill | Use when |
|---|---|
Multiplayer multiplayer Recommended | Start here for Summer multiplayer: how authority, clients, Worlds and Sessions fit, and what comes next. |
Multiplayer Movement multiplayer-movement | Movement in Summer multiplayer: owners move instantly, others glide, the authority checks each pose. |
Multiplayer Project multiplayer-project | Set up a Summer multiplayer project: entry scenes, World and queue files, joining, a first Local Play. |
Multiplayer Publish multiplayer-publish | Ship a hosted Summer multiplayer game: the bundle, server preset, pre-upload checks, a new Build. |
Multiplayer State multiplayer-state | Authority-owned state in Summer multiplayer: shared and private State groups, Commands, Events. |
Multiplayer Testing multiplayer-testing | Test a Summer multiplayer game with Local Play: several players, bad network, bots, a passing run. |
Summer Analytics summer-analytics | Send game events to Summer analytics from the authority or client: fire-and-forget, never blocking gameplay. |
Summer Friends summer-friends (preview) | Summer friends in a game: a consented friends list, profile and chat screens, direct messages. Hosted only. |
Summer Leaderboards summer-leaderboards (preview) | Leaderboards in a Summer game: queue ratings from matches, and Game rankings your authority scores. |
Summer Match Results summer-match-results | End a Summer match: report each player’s win, loss or draw, show results on clients, then close the World. |
Summer Matchmaking summer-matchmaking (preview) | Get players into matches with Summer matchmaking: queues, teams, accept prompts, join progress and failures. |
Summer Parties summer-parties (preview) | Let a Summer party play together: the leader presses Play, members follow into the same match. Hosted only. |
Summer Player Data summer-player-data | Save a player’s progress so it follows them to every match: authority load and commit, autosave, safe retries. |
Summer Store summer-store (preview) | Sell Summer items for Sparks: shop, checkout, slugs, bundles, sales, owned items, summer.items.json sync. |
Summer World Chat summer-world-chat (preview) | Add match chat to a Summer game: one World channel shared by everyone in the match. Hosted only. |
Summer World Saves summer-world-saves (preview) | Keep a persistent Summer World between restarts: checkpoint saves, restore before join, the final save. |
Navigation
| Skill | Use when |
|---|---|
Navigate Summer navigate-summer Recommended | Open a Summer page or editor view for the person: studio.open, and engine.view_set while you work. |
Performance
| Skill | Use when |
|---|---|
Tune Performance tune-performance Recommended | Profile a slow game, find rendering, physics or script hotspots, and propose fixes with expected gains. |
Rendering and lighting
| Skill | Use when |
|---|---|
3D Lighting 3d-lighting Recommended | Light a 3D scene: sun, omni and spot lights, WorldEnvironment, sky, shadows and ambient. |
Art Direction art-direction Recommended | Define the game’s visual style (palette, mood, lighting, post) as an art bible in .summer/art-bible.md. |
Forward+ and Compatibility Without Surprises compatibility-renderer-traps Recommended (preview) | Make a Forward+ game look right on the Compatibility renderer: instance uniforms, MultiMesh, vertex colors. |
PSX Retro Rendering psx-retro-rendering (preview) | PlayStation 1 rendering in Summer Engine — low-res output, RGB5 and exact dither, affine textures, vertex snapping, blend modes, fog; limits named. |
Real-Time Wet Surfaces realtime-wet-surfaces (preview) | Real-time wetness on existing materials without losing their values — value-copying wet shader, geometry-driven wet mask, instance-uniform wet amount. |
A Great Look in the Compatibility Renderer web-compatibility-look Recommended (preview) | Make a browser game look high-end in the Compatibility renderer (WebGL 2): what works, recipes, speed. |
Runtime
| Skill | Use when |
|---|---|
Agent Playtesting agent-playtesting Recommended (preview) | Playtest by driving the live game: deterministic launch, frame-stamped probes, scripted or recorded input. |
Scenes and project
| Skill | Use when |
|---|---|
Brainstorm Game brainstorm-game Recommended | Turn a vague game idea into a 1-page brief (genre, scope, core loop, mechanics) in .summer/GameSoul.md. |
Browse Templates browse-templates Recommended | List Summer Engine project templates, present the choices, and create a project from the chosen one. |
Camera Rigs camera-rigs (preview) | Camera rigs: Camera2D follow with limits, first-person head, SpringArm3D third-person, top-down, FOV. |
Make Game make-game Recommended | Orchestrate ‘make me a game’: brainstorm, plan, scaffold, mechanics, art, audio, polish, verify, ship. |
New Project new-project Recommended | Create and open a fresh Summer Engine project with summer dev; verify the project connection. |
Play play Recommended | Run the project in Summer Engine, wait briefly, then report a clean run, errors or warnings. |
Scene Composition scene-composition Recommended | Scene structure: node hierarchy, when to extract sub-scenes, reusable prefabs, instance vs add node. |
Scene Hierarchy Design for Summer Engine scene-hierarchy-design (preview) | Structure scenes by access pattern: asset vs live hierarchies, wrapper nodes, sub-scenes, path-agnostic code. |
Scene Scripting scene-scripting Recommended | Build scenes, levels, HUDs and wiring with one editor GDScript (summer_run_script) instead of call chains. |
Spatial Placement spatial-placement Recommended (preview) | Place 3D objects and modular kit pieces from measured geometry: floors, walls, facades, pipes, alcoves. |
Verifying Scenes verifying-scenes Recommended (preview) | Prove scene work landed: snapshot, diff, screenshots, runtime reads, 3D audits, shot sheets and zooms. |
Build 3D Worlds with Spatial Evidence world-building-3d Recommended (preview) | Compose, ground and space 3D scenes with Summer’s four spatial tools, one geometric decision at a time. |
Scripting
| Skill | Use when |
|---|---|
GDScript Patterns gdscript-patterns Recommended | GDScript conventions: type hints, signals, exports, onready, lifecycle methods, node paths, naming. |
Save / Load save-load (preview) | Save and load game state: user:// paths, JSON progress vs ConfigFile settings, versioned saves, autosave. |
Tools
| Skill | Use when |
|---|---|
Summer Apps summer-apps Recommended (preview) | Build a Summer App, a team tool inside Summer Studio (balance table, quest editor, tracker), data and tools. |
UI
| Skill | Use when |
|---|---|
Summer Apps Design summer-apps-design Recommended (preview) | How a Summer App should look: layout, Summer UI kit components, tables, charts, states, pre-ship check. |
UI Basics ui-basics Recommended | Build UI: HUDs, menus, health bars, dialogue boxes, Control trees, anchors, containers and themes. |
Visual effects
| Skill | Use when |
|---|---|
Game Feel game-feel Recommended | Add juice: hit-flash, trauma camera shake and audio ducking, one hit fires all three. |
Dissolve vfx-dissolve | Dissolve effect: a mesh burns away with a glowing edge, from a noise-threshold ShaderMaterial. |
Fire vfx-fire Recommended | Fire effect: animated flames from GPUParticles3D, a particle shader and a noise color ramp. |
Hit Spark vfx-hit-spark | Hit-spark effect: a one-shot burst of additive particles oriented to the surface, fired on impact. |
Lightning vfx-lightning | Lightning bolt effect: a jagged procedural path with a glow shader, end sparks and screen shake. |
Magic Glow vfx-magic-glow | Magic-glow effect: a pulsing OmniLight3D, drifting additive motes and an optional emission shader. |
Muzzle Flash vfx-muzzle-flash Recommended | Muzzle-flash effect: a one-shot ~80 ms burst at a gun barrel, from particles or a star-burst quad. |
Smoke vfx-smoke | Smoke effect: a rising column or puff of soft particles with a noise and density falloff shader. |
Water Ripple vfx-water-ripple | Water-ripple effect: animated normal-distortion ripples on a water plane or Decal, set off by impacts. |
Video
| Skill | Use when |
|---|---|
Animated Loop animated-loop | Generate a short seamless video loop: splash background, animated logo backdrop, idle title screen. |
Cinematic Cutscene cinematic-cutscene Recommended | Generate a non-interactive cutscene: a reference-locked 5-10s video shot with optional voiced dialogue. |
Trailer Shot trailer-shot | Generate trailer footage: slow-mo combat, establishing shots, hero beats, splash screens, 5-10 seconds. |
For AI Agents
Once installed, the agent discovers skills on its own. Start a session by readingusing-summer (the bootstrap skill): it explains how to find the right skill and the right summer_* MCP tool before answering a game-development request. Skills reference the operations and engine value formats (Vector3(0, 10, 0), Color(1, 0.5, 0, 1)).
Contributing a Skill
A skill is one folder inlibrary/skills/<slug>/ with a resource.yaml (id, summary, use_when, facets.domains) and a SKILL.md. Run npm run generate:registry and the tests; the index, the agent manifests and this catalog’s source regenerate from it. The writing-skills skill in the library walks an agent through it.
Next Steps
Every Supported Agent
Config file and skills folder for each agent
CLI Reference
All CLI commands including skills
Need help? Ask in Discord first. That is where you get the fastest reply and support. For concrete help, email support@summerengine.com or founders@summerengine.com.

