design-level-design

Use when designing game levels, environments, difficulty curves, pacing, encounter placement, or spatial layouts for any game genre. Triggers: level, pacing, difficulty curve, encounter, environment, spatial design.

6 stars

Best use case

design-level-design is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Use when designing game levels, environments, difficulty curves, pacing, encounter placement, or spatial layouts for any game genre. Triggers: level, pacing, difficulty curve, encounter, environment, spatial design.

Teams using design-level-design should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/level-design/SKILL.md --create-dirs "https://raw.githubusercontent.com/fcsouza/agent-skills/main/plugins/game-dev/design/level-design/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/level-design/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How design-level-design Compares

Feature / Agentdesign-level-designStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Use when designing game levels, environments, difficulty curves, pacing, encounter placement, or spatial layouts for any game genre. Triggers: level, pacing, difficulty curve, encounter, environment, spatial design.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Level Design

## Purpose

Environment layout, pacing, difficulty curves, accessibility, and spatial design for any game type.

## When to Use

Trigger: level design, environment layout, pacing, difficulty curve, level flow, spatial design, map design, area design, zone design, encounter design, tutorial level.

## Prerequisites

- `game-design-fundamentals`

## Core Principles

1. **"The level teaches the mechanic"** — Miyamoto. Every level introduces, tests, then twists a mechanic. The player should understand through doing, not reading.

2. **Pacing is rhythm** — Alternate intensity (combat/puzzle) with rest (exploration/story). A level without pacing variation is monotonous. Think of it like music: tension, release, tension, release.

3. **Spatial storytelling** — The environment tells a story without words. Broken furniture, scorch marks, an abandoned camp — the player pieces together what happened. Miyazaki's environmental narrative rewards observation.

4. **The golden path with optional detours** — There must be a clear main route so no player gets lost, but rewarding side paths for the curious. Jenova Chen's flow theory: the player should always feel pulled forward, never stuck.

5. **Difficulty is a curve, not a line** — Ramp, plateau, spike, rest. Never linear increase. Jonathan Blow's principle of mechanic honesty: each challenge should feel like a genuine insight, not an arbitrary wall.

6. **Accessibility is not optional** — Multiple difficulty modes, clear visual language, colorblind support, subtitles, remappable controls. Fumito Ueda's restraint and clarity: if a player can't parse what's happening, the design has failed.

7. **Playtesting reveals truth** — Your intuition about difficulty is wrong until proven by playtesters. Watch players silently. Where they get stuck is where your design failed, not where the player failed.

## Step-by-Step Instructions

### Phase 1: Concept

1. Define the level's **purpose** in the overall game progression. What does the player learn, feel, or achieve here?
2. Identify the **core mechanic(s)** this level introduces, tests, or twists.
3. Determine the **emotional arc** — what should the player feel at the start, middle, and end?
4. Set **constraints**: estimated playtime, difficulty band, technical budget.

### Phase 2: Layout

5. Sketch a **top-down layout** (pen and paper or text diagram). Mark:
   - Entry and exit points
   - Main path (golden path)
   - Side paths and optional areas
   - Encounter locations
   - Rest areas / safe zones
   - Key landmarks for orientation
6. Apply the **three-beat structure** to the main path:
   - **Introduction**: teach or reintroduce the mechanic in a safe context.
   - **Development**: test the mechanic with increasing complexity.
   - **Twist**: combine the mechanic with something unexpected or subvert expectations.
7. Place **landmarks** so the player always knows where they are. If you can't describe "you're near the [landmark]" for every area, add more landmarks.

### Phase 3: Pacing

8. Map **intensity over time** using a pacing graph. Plot encounters by intensity (1-10) against progression (0-100%).
9. Ensure **valleys** exist between peaks. Two high-intensity encounters back-to-back is exhausting. Insert exploration, story, or resource gathering between them.
10. Place the **climax** at roughly 75-85% through the level, then provide resolution / reward.

### Phase 4: Encounters

11. Design each encounter using the encounter template. For every encounter, answer:
    - What is the player supposed to learn or prove?
    - What happens if they fail?
    - Is there more than one valid approach?
12. Ensure **difficulty progression** within the level matches the difficulty curve template.

### Phase 5: Environmental Storytelling

13. Add **environmental details** that reward observation. These should never block progress but should enrich the experience.
14. Use the **show, don't tell** principle. A locked door with claw marks tells more than a text log explaining "the creature escaped."

### Phase 6: Accessibility Pass

15. Review all visual communication — can a colorblind player parse every important element?
16. Ensure all audio cues have visual alternatives.
17. Check that the critical path is navigable without precision timing (or provide an alternative in accessibility mode).
18. Verify text readability, subtitle availability, and input remapping support.

### Phase 7: Playtest

19. Run **silent playtests** — watch without helping. Record where players:
    - Get lost (navigation failure)
    - Get stuck (difficulty spike)
    - Get bored (pacing failure)
    - Miss content (discoverability failure)
20. Iterate based on playtest data, not personal preference.

## Code Examples

N/A — this is a design skill. Implementation code lives in `game-backend-architecture`.

## Cross-References

- `game-design-fundamentals` — Core design pillars and mechanics framework.
- `quest-mission-design` — Mission/quest structure that overlays on level layouts.
- `worldbuilding` — Lore, world rules, and narrative context for environments.
- `ui-ux-game` — HUD, minimap, waypoints, and player guidance systems.

## Pitfalls

- **Linear corridors with no player choice** — Even a simple fork that reconnects gives the player agency. Straight lines feel like you're being pushed.
- **Difficulty spikes without buildup** — A sudden hard encounter after easy ones feels unfair. Ramp into difficulty so the player feels prepared.
- **Empty spaces that waste player time** — Every area should have a purpose: encounter, story, resource, or scenic reward. Walking through nothing is not "atmosphere," it's boredom.
- **Inconsistent visual language** — If glowing objects mean "interactable" in one area, they must mean that everywhere. Breaking visual conventions confuses players.
- **Tutorial levels that are boring** — The tutorial IS the game. If the tutorial isn't fun, players quit before reaching the "real" game.
- **Overreliance on text or UI for guidance** — If you need a waypoint marker to prevent players from getting lost, the level layout itself has failed. Fix the layout first, add markers as a secondary aid.
- **Designing for yourself instead of the player** — You know the solution. The player doesn't. What feels "obvious" to you is often invisible to a first-time player.

## Designer Philosophy

- **Shigeru Miyamoto**: "A good game is one that you can always feel you are progressing in."
- **Hidetaka Miyazaki**: "The environment should make you wonder what happened here."
- **Jenova Chen**: "I want players to feel a sense of journey."
- **Jonathan Blow**: "Every puzzle should feel like a genuine insight."
- **Fumito Ueda**: "Minimalism in design amplifies emotional impact."

## Sources

- GDC Vault — Level design talks (particularly "The Level Design of God of War," "Designing Unforgettable Levels," "10 Principles of Good Level Design")
- *Level Up! The Guide to Great Video Game Design* — Scott Rogers
- Nintendo design philosophy — Miyamoto's "garden" approach to level design
- *A Theory of Fun for Game Design* — Raph Koster
- *The Art of Game Design: A Book of Lenses* — Jesse Schell
- *Dark Souls* postmortems — Miyazaki on environmental storytelling and interconnected world design
- *Journey* postmortem — Jenova Chen on flow and emotional pacing
- *The Witness* developer commentary — Jonathan Blow on puzzle integrity and mechanic honesty

Related Skills

narrative-character-design-narrative

6
from fcsouza/agent-skills

Use when creating game characters, NPCs, character arcs, dialogue systems, archetypes, or character bibles. Triggers: character, NPC, dialogue, archetype, character bible, motivation arc.

design-ui-ux-game

6
from fcsouza/agent-skills

Use when designing game UI — HUD patterns, menu systems, onboarding flows, feedback loops, accessibility features, or notification systems. Triggers: HUD, menu, onboarding, accessibility, UI, UX, game interface.

design-skill-progression-trees

6
from fcsouza/agent-skills

Use when designing or implementing skill trees, talent trees, ability progression systems, or unlock graphs. Triggers: skill tree, talent tree, ability tree, progression system, unlock, prestige, node, skill points.

design-quest-mission-design

6
from fcsouza/agent-skills

Use when designing quests, missions, objectives, quest trees, or reward structures. Requires quest-narrative-coherence check before any quest creation. Triggers: quest, mission, objectives, quest tree, rewards.

design-procedural-gen

6
from fcsouza/agent-skills

Use when implementing procedural content generation, dungeon or map generation, procedural loot tables, world seeds, noise-based terrain, NPC behavior variation, or wave function collapse. Triggers: procedural, dungeon gen, map gen, loot table, world seed, noise, BSP, wave function collapse, randomization.

design-game-economy-design

6
from fcsouza/agent-skills

Use when designing virtual economies, currencies, sink/faucet balance, loot tables, crafting systems, shops, or inflation control. Triggers: economy, currency, sinks, loot, inflation, crafting, shop.

design-game-design-fundamentals

6
from fcsouza/agent-skills

Use when designing core game loops, feedback systems, player motivation models, MDA framework analysis, progression curves, difficulty tuning, reward schedules, or any genre-agnostic game design theory.

react-animations

6
from fcsouza/agent-skills

Use when implementing animations, transitions, or motion effects in React apps. Invoke this skill whenever someone asks about animation, transition, motion, framer motion, react spring, GSAP, entrance/exit effects, scroll animation, parallax, gesture, drag, card flip, screen shake, health bar, damage numbers, loading states, page transitions, hover effects, or any element that should move, fade, scale, or respond to interaction — even if they don't use the word "animation".

openclaw-genie

6
from fcsouza/agent-skills

Use when the user asks about OpenClaw — installation, configuration, agents, channels, memory, tools, hooks, skills, deployment, Docker, multi-agent, OAuth, gateway, CLI, browser, exec, PDF, voice, secrets, sandboxing, sessions, cron, webhooks, heartbeat, sub-agents, nodes, companion devices, canvas, camera, or messaging platform integration. Also invoke for questions about running OpenClaw agents: memory recall (memory_search), cron scheduling, multi-agent setup, or any openclaw.json behavior. OpenClaw has proprietary configuration syntax (SecretRef, dmPolicy, node.invoke, tool profiles) and CLI commands that require this skill to answer correctly.

game-lore

6
from fcsouza/agent-skills

Adds or updates a single world lore entry (faction, location, NPC, or event) — validates against existing lore for consistency, applies the right template, and updates docs/world-lore.md. Extract the entry type (faction/location/npc/event) and name from the user's message.

game-expand

6
from fcsouza/agent-skills

Adds a new feature to an existing MVP plan — scoped architect interview, scope validation against original plan, and integration into the build sequence. Extract the feature name or description from the user's message. Requires docs/mvp-first-draft.md — run game-architect first.

game-build

6
from fcsouza/agent-skills

Builds a game component from the MVP plan — production TypeScript + Vitest tests + mock dependencies + build registry tracking. Extract the component name from the user's message (or "status" to check progress). Requires docs/mvp-first-draft.md — run game-architect first.