new-project is a skill from the Summer skill library: a guide your AI agent reads when the task matches, so it builds the good version on the first try. Create and open a fresh Summer Engine project with summer dev; verify the project connection.
When your agent uses it
- The user wants a fresh blank Summer Engine project — from scratch, blank canvas
- Starting a Summer Engine project with no template, only a name, ready for an empty main scene
Install
summer setup installs every skill for your agent. To add only this one:
claude-code for your agent, such as codex or cursor. See Skills for every option.
The skill
Use this when the user wants a blank project instead of a template.When to use this skill
- “Let’s start a new project.”
- “I want to make a [game type] from scratch.”
- “Blank project.”
- “Empty project.”
- “I don’t want a template, just a blank starting point.”
When NOT to use this skill
- “Show me templates” / “use a template” →
browse-templates. - “Make me a game” with a defined idea → run
brainstorm-gamefirst to scope, then come back here once the user knows what they want. - “I have an existing Godot project I want to import” → not this skill; have the user run
summer open <path>directly.
Steps
1. Ask the project name
One question, no menu:“What do you want to call your project?”Default:
my-game. If they say “anything is fine” or similar, use my-game and move on. The directory name is reversible — they can always rename.
2. Pick the starting scene
Two built-in options:empty— rootNode3Donly. Pure blank canvas. Best for: experimentation, when the user knows exactly what they want to build.3d-basic— rootNode3Dwith a procedural sky on aWorldEnvironment, a sun with soft shadows, a tinted ground, one hero mesh and aCamera3Dthat frames it. Best for: first-time users who want something they can press Play on.
“Empty (just a root node) or 3d-basic (camera, light, and a floor — you can press play immediately)?”If the user has clearly invoked
brainstorm-game already and the brief calls for 3D, default to 3d-basic and mention you did. If 2D or 2.5D, use empty, keep its Node3D root and build the world with painted-25d-world (a painted 3D blockout under a fixed orthographic camera with sprite characters).
3. Create and open it
One command creates the project and opens it. Followsummer-cli’s “Start or reconnect to Summer Engine” sequence for CLI availability, installation and readiness. Start without --yes:
summer dev empty my-game. If Summer Engine is installed, no installation approval is needed. If it is missing, a non-interactive call returns needs_confirmation without installing or creating the project. Ask the person about the download (about 660 MB), then repeat the same command with --yes after they agree. It writes project.godot and the chosen main.tscn (no network call for these two), opens the editor and waits for its local API.
No shell in this session (a chat app)? Call projects.create_local with template and name, then projects.open_local with its projectPath (and install: true only after the user said yes to installing the engine).
From the created project’s folder, confirm the intended project and engine version with summer_get_project_context or summer engine get-project-context. If startup reports that assets are still importing, follow the readiness steps in summer-cli; if verification still fails, run summer doctor and surface the specific failure to the user.
4. Don’t keep going automatically
After scaffolding, stop and let the user direct. A common mistake: firefps-controller or design-mechanic automatically because “now we make a game.” Wait. The user might want to:
- Brainstorm what to build (
brainstorm-game) - Set the visual direction (
art-direction) - Jump straight into a known mechanic (
design-mechanic) - Build a specific controller (
fps-controller)
Anti-patterns
Edge cases
- Engine not running → that’s fine.
summer dev(orprojects.open_local) starts it;summer createalone doesn’t need it. - User wants 2D or 2.5D → use
empty, keep theNode3Droot and followpainted-25d-world. Use aNode2Droot only when the user asks for a classic 2D tile or pixel game. - Directory exists → a folder that already holds
project.godotis just opened; one with other files is refused. Ask for a different name; don’t try to overwrite.
Closing
End with: “Project<name> is created and open. What do you want to build first?”
From a shell
No Summer MCP tools in this session? Run each one as a command; whensummer --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 '<json>', and summer ops describe <op> prints the exact input. The summer-cli skill has the rest.
Related skills
summer-cli: Summer as shell commands, no MCP: sign in, run operations, follow jobs, save files, drive the engine.make-game: Orchestrate ‘make me a game’: brainstorm, plan, scaffold, mechanics, art, audio, polish, verify, ship.painted-25d-world: 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.
Source:
library/skills/new-project/SKILL.md, rendered from summer-engine@4.9.2 on npm.
