> ## Documentation Index > Fetch the complete documentation index at: https://docs.summerengine.com/llms.txt > Use this file to discover all available pages before exploring further. # Gameskill skill for AI agents > Capture what a game-dev session learned as a reusable skill (project, user or Summer library) for next time. A Summer Engine skill for AI agents. `gameskill` is a skill from the [Summer skill library](/mcp/skills): a guide your AI agent reads when the task matches, so it builds the good version on the first try. Capture what a game-dev session learned as a reusable skill (project, user or Summer library) for next time. | | | | - | - | | Status | Stable | | Domains | Agent workflow, Meta | | Version | `1.0.2` | | Engine version | `>=4.6` | | Recommended set | No, installed by `--all` or by name | ## When your agent uses it * Finishing a game-development session with learnings worth capturing as a reusable skill * A session found a technique, workaround, or convention worth reusing across Summer sessions ## Install `summer setup` installs every skill for your agent. To add only this one: ```bash theme={null} npx -y summer-engine@latest skills install gameskill --agent claude-code ``` Swap `claude-code` for your agent, such as `codex` or `cursor`. See [Skills](/mcp/skills#quick-start) for every option. ## The skill You are being invoked at the end (or middle) of a game-development session. Turn what you just figured out into a durable skill so future agents start where you ended. This is the meta-skill: the loop that turns ad-hoc fixes into reusable expertise. ## Where a captured skill goes Summer resolves skills in this order: the game project, then the user's agent skills directory, then the skills bundled with the Summer package. Pick the narrowest home that fits: 1. **The game project** (default). Write `SKILL.md` into the project-scoped skills directory of the agent you are running in: `.claude/skills//` for Claude Code, `.agents/skills//` for Codex, Cursor, Devin Desktop and the other agents that read the shared folder. `summer skills install --scope project` shows the exact path for the current agent. Commit it with the game. 2. **The user's agent skills directory** when the lesson applies to every project on this machine (`~/.claude/skills//`, `~/.agents/skills//`). Do not edit skills that Summer installed there; they are overwritten on the next `summer setup`. 3. **The Summer library** when the lesson is general enough for every Summer user. Only possible inside a checkout of the `summerengine/summer` repository: add `library/skills//resource.yaml` and `library/skills//SKILL.md` (flat slugs, no category folders), then run `npm run generate:registry` and `npm run validate:library`. Everything under `registry/generated/` and every plugin manifest is generated from `library/`; never hand-edit them. Outside that checkout, send the lesson through `summer_call` `{"op":"docs.feedback"}` (or `summer tool library-feedback`) with the id of the closest existing skill so the maintainers can fold it in. Read the current project as ground truth. Working code from the real project beats invented examples. ## What to do, in order 1. One short sentence to the user: "Capturing learnings from this session into a skill." No plan dump. 2. Probe. Check which skills directories exist for this agent and project, and search the bundled library first (`summer_docs_search ""`, or `summer skills list`) so you extend an existing skill instead of duplicating it. 3. Recap the session. Pull out learnings that are non-obvious AND general, things a future agent could not derive from reading the codebase. Examples that count: * A working shader (the actual code) * A GDScript idiom that beat the obvious approach * A UI layout that survived the design pass * A bug, its root cause and the fix that was not in any docs * An engine quirk (type inference, signal gotchas, plugin configuration) * A spawning, AI or enemy pattern that worked * A performance fix with measured before and after * An asset workflow that beat the alternatives * A Summer tool that steered you wrong: report that with `summer_call` `{"op":"docs.feedback"}` on the tool's id, in addition to any skill Examples that do NOT count: one-off code with no general lesson, things already documented in an existing skill or the project's agent instructions, personal preferences without reasoning, anything manufactured to fill space. 4. Decide placement for each learning: extend an existing skill (name the file, quote the section, draft the addition) or create a new one (pick the home from the list above, name the slug, draft the full skill). Match the format of the bundled skills: YAML frontmatter with `name` and a "Use when ..." `description`, then the body. 5. One tight pause for the user. Five to ten lines: what files you will touch, what each captures, what gets left out. Wait for OK or a redirect. Do not ask multiple questions. 6. Apply. Write the files, run `git status` so the diff is visible, and if you touched the Summer library run the generator and validator. 7. Report. One short message: files changed, the future-agent payoff in one sentence per skill, and what (if anything) is still uncaptured. ## Style rules * Tight. No filler. * Capture the why, not just the what. "Use X" rots. "Use X because Y breaks under Z" survives. Lead with the reason. * Real working code from the active project beats invented examples. * VFX is code: shaders, GDScript and node setup. Never an image-generation pipeline. * No em dashes in skill text. Use periods or restructure. * No dates inside skill bodies. Skills are timeless guidance; dates belong in commit messages. * No specific game or project names inside skill bodies. The same skill may be installed by someone who never heard of your project. * Verify before claiming. If a skill says "Summer Engine does X", check it against the tool result or the running engine first. ## When there is nothing worth capturing Say so: "session was tactical, no durable learnings worth a skill." Better to ship nothing than to ship noise. ## From a shell No Summer MCP tools in this session? Run each one as a command; when `summer --version` is missing or below 4.0, use `npx -y summer-engine@latest` in place of `summer`. Fields are flags in kebab-case (`--scene-path res://main.tscn`) or one `--input ''`, and `summer ops describe ` prints the exact input. The `summer-cli` skill has the rest. | In this skill | Command | | - | - | | `docs.feedback` | `summer docs feedback` | | `summer_docs_search` | `summer docs search` | *** Source: [`library/skills/gameskill/SKILL.md`](https://github.com/SummerEngine/summer/blob/main/library/skills/gameskill/SKILL.md), rendered from `summer-engine@4.3.0` on npm. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.