level-design
Expert game level design for planning, building, verifying, critiquing and fixing levels, maps, jump puzzles and worlds in any engine (Unreal, Unity, Godot). Covers briefs, layout and flow, verticality, pacing and beat charts, player guidance, teaching mechanics, encounters, metrics, fun checks, accessibility, blockout and playtesting, plus checker scripts for tile maps, grid puzzles, 2D platformer reach, 3D jump links and lock-and-key graphs. Deep guides for puzzle and platformer levels, 3D traversal, hidden and optional jumping puzzles, parkour, obby and KZ-style movement maps, and genre guides for shooters, stealth, horror, dungeons/metroidvanias, multiplayer, open worlds, RPGs, roguelikes, tactics, RTS, tower defense, casual/mobile, VR, co-op PvE, boss arenas/raids, racing and UGC platforms. Use whenever the user is designing, sketching, generating, blocking out, reviewing or fixing a level, map, puzzle, jumping puzzle, traversal route, arena, track or dungeon, even if they don't say "level design".
- Version
- 1.1.0
- License
- MIT
- Compatibility
- Bundled checker scripts need Python 3.8+ and code execution; without them, checks are hand-traced and labelled unverified.
Pinned to revision 4f1e0ca64206, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/level-design/SKILL.md
- skills/level-design/SOURCES.md
- skills/level-design/agents/openai.yaml
- skills/level-design/assets/example-jump-sequence.md
- skills/level-design/assets/hypothesis-card.md
- skills/level-design/assets/insight-card.md
- skills/level-design/assets/jump-sequence-spec.md
- skills/level-design/assets/level-brief-template.md
- skills/level-design/assets/movement-kit.md
- skills/level-design/assets/project-context-template.md
- skills/level-design/evals/critique-seeded-defects/case.yaml
- skills/level-design/evals/critique-seeded-defects/files/design_notes.md
- skills/level-design/evals/critique-seeded-defects/files/platformer_1-3.txt
- skills/level-design/evals/critique-seeded-defects/files/player_kit.json
- skills/level-design/evals/critique-seeded-defects/files/puzzle1.txt
- skills/level-design/evals/critique-seeded-defects/files/puzzle2.txt
- skills/level-design/evals/critique-seeded-defects/files/puzzle3.txt
- skills/level-design/evals/critique-seeded-defects/graders/01-the-review-states-that-puzzle2-is-unsolv.md
- skills/level-design/evals/critique-seeded-defects/graders/02-the-review-states-that-puzzle3-can-be-so.md
- skills/level-design/evals/critique-seeded-defects/graders/03-the-review-states-that-the-platformer-fl.md
- skills/level-design/evals/critique-seeded-defects/graders/04-the-review-flags-the-secret-door-marked.md
- skills/level-design/evals/critique-seeded-defects/graders/05-the-review-flags-the-6-flashes-per-secon.md
- skills/level-design/evals/critique-seeded-defects/graders/06-the-review-flags-either-the-missing-chec.md
- skills/level-design/evals/critique-seeded-defects/graders/07-problems-are-ordered-by-importance-with.md
- skills/level-design/evals/critique-seeded-defects/place-files.sh
- skills/level-design/evals/critique-seeded-defects/prompt.md
- skills/level-design/evals/level-design-facts-check/case.yaml
- skills/level-design/evals/level-design-facts-check/graders/01-taylor-s-principle-about-difficulty-is-d.md
- skills/level-design/evals/level-design-facts-check/graders/02-the-response-states-that-flashes-should.md
- skills/level-design/evals/level-design-facts-check/graders/03-the-response-mentions-an-area-limit-for.md
- skills/level-design/evals/level-design-facts-check/graders/04-the-response-mentions-saturated-red-flas.md
- skills/level-design/evals/level-design-facts-check/graders/05-no-fabricated-direct-quotes-are-attribut.md
- skills/level-design/evals/level-design-facts-check/prompt.md
- skills/level-design/evals/movement-map-difficulty-tiers/case.yaml
- skills/level-design/evals/movement-map-difficulty-tiers/graders/01-each-course-lists-its-jumps-with-numeric.md
- skills/level-design/evals/movement-map-difficulty-tiers/graders/02-difficulty-rises-from-easy-to-hard-on-mo.md
- skills/level-design/evals/movement-map-difficulty-tiers/graders/03-the-easy-course-keeps-its-jumps-well-ins.md
- skills/level-design/evals/movement-map-difficulty-tiers/graders/04-checkpoint-or-respawn-rules-are-stated-f.md
- skills/level-design/evals/movement-map-difficulty-tiers/graders/05-the-response-says-how-to-calibrate-or-ve.md
- skills/level-design/evals/movement-map-difficulty-tiers/prompt.md
- skills/level-design/evals/platformer-walljump-world2/case.yaml
- skills/level-design/evals/platformer-walljump-world2/graders/01-the-tile-map-is-rectangular-within-120x2.md
- skills/level-design/evals/platformer-walljump-world2/graders/02-the-flag-is-reachable-from-the-start-for.md
- skills/level-design/evals/platformer-walljump-world2/graders/03-the-level-cannot-be-completed-without-th.md
- skills/level-design/evals/platformer-walljump-world2/graders/04-the-wall-jump-is-first-introduced-in-a-l.md
- skills/level-design/evals/platformer-walljump-world2/graders/05-at-least-one-checkpoint-c-is-placed-befo.md
- skills/level-design/evals/platformer-walljump-world2/graders/06-design-reasoning-ties-gap-widths-and-wal.md
- skills/level-design/evals/platformer-walljump-world2/graders/07-the-response-does-not-claim-the-level-is.md
- skills/level-design/evals/platformer-walljump-world2/prompt.md
- skills/level-design/evals/sokoban-ice-teaching-levels/case.yaml
- skills/level-design/evals/sokoban-ice-teaching-levels/graders/01-each-of-the-three-level-grids-is-rectang.md
- skills/level-design/evals/sokoban-ice-teaching-levels/graders/02-each-of-the-three-levels-is-actually-sol.md
- skills/level-design/evals/sokoban-ice-teaching-levels/graders/03-each-level-s-ice-tiles-matter-the-level.md
- skills/level-design/evals/sokoban-ice-teaching-levels/graders/04-the-three-levels-form-a-teaching-progres.md
- skills/level-design/evals/sokoban-ice-teaching-levels/graders/05-an-intended-solution-in-u-d-l-r-notation.md
- skills/level-design/evals/sokoban-ice-teaching-levels/graders/06-the-response-does-not-claim-a-level-is-s.md
- skills/level-design/evals/sokoban-ice-teaching-levels/prompt.md
- skills/level-design/evals/soulslike-lift-jump-detour/case.yaml
- skills/level-design/evals/soulslike-lift-jump-detour/graders/01-every-jump-in-the-detour-is-given-as-num.md
- skills/level-design/evals/soulslike-lift-jump-detour/graders/02-no-required-jump-in-the-detour-exceeds-t.md
- skills/level-design/evals/soulslike-lift-jump-detour/graders/03-the-reward-or-destination-is-visible-bef.md
- skills/level-design/evals/soulslike-lift-jump-detour/graders/04-the-design-states-what-happens-when-the.md
- skills/level-design/evals/soulslike-lift-jump-detour/graders/05-the-detour-ends-by-looping-back-to-the-m.md
- skills/level-design/evals/soulslike-lift-jump-detour/graders/06-the-lift-s-timing-window-for-the-step-of.md
- skills/level-design/evals/soulslike-lift-jump-detour/graders/07-the-response-does-not-claim-the-route-is.md
- skills/level-design/evals/soulslike-lift-jump-detour/prompt.md
- skills/level-design/evals/soulslike-vertical-castle-district/case.yaml
- skills/level-design/evals/soulslike-vertical-castle-district/graders/01-the-design-includes-a-topology-diagram-e.md
- skills/level-design/evals/soulslike-vertical-castle-district/graders/02-vertical-structure-is-made-explicit-floo.md
- skills/level-design/evals/soulslike-vertical-castle-district/graders/03-at-least-one-hidden-vertical-route-a-dro.md
- skills/level-design/evals/soulslike-vertical-castle-district/graders/04-drop-heights-are-tied-to-the-stated-fall.md
- skills/level-design/evals/soulslike-vertical-castle-district/graders/05-the-critical-path-to-the-boss-does-not-d.md
- skills/level-design/evals/soulslike-vertical-castle-district/graders/06-a-beat-chart-or-ordered-sequence-covers.md
- skills/level-design/evals/soulslike-vertical-castle-district/prompt.md
- skills/level-design/evals/tactics-flooded-subway-map/case.yaml
- skills/level-design/evals/tactics-flooded-subway-map/graders/01-a-top-down-map-is-provided-with-a-stated.md
- skills/level-design/evals/tactics-flooded-subway-map/graders/02-cover-placement-is-described-or-shown-so.md
- skills/level-design/evals/tactics-flooded-subway-map/graders/03-the-8-turn-limit-is-analysed-against-mov.md
- skills/level-design/evals/tactics-flooded-subway-map/graders/04-enemy-groups-and-any-reinforcements-are.md
- skills/level-design/evals/tactics-flooded-subway-map/graders/05-the-flooded-terrain-or-elevation-is-used.md
- skills/level-design/evals/tactics-flooded-subway-map/prompt.md
- skills/level-design/references/accessibility.md
- skills/level-design/references/boss-arenas-and-raids.md
- skills/level-design/references/fun-checks.md
- skills/level-design/references/genre-action-combat.md
- skills/level-design/references/genre-casual-mobile.md
- skills/level-design/references/genre-coop-pve.md
- skills/level-design/references/genre-dungeon-metroidvania.md
- skills/level-design/references/genre-horror.md
- skills/level-design/references/genre-multiplayer.md
- skills/level-design/references/genre-open-world.md
- skills/level-design/references/genre-racing.md
- skills/level-design/references/genre-roguelike-procedural.md
- skills/level-design/references/genre-rpg-narrative.md
- skills/level-design/references/genre-stealth-immersive-sim.md
- skills/level-design/references/genre-strategy-rts.md
- skills/level-design/references/genre-tactics.md
- skills/level-design/references/genre-tower-defense.md
- skills/level-design/references/genre-ugc-platforms.md
- skills/level-design/references/genre-vr.md
- skills/level-design/references/grid-conventions.md
- skills/level-design/references/jump-puzzles.md
- skills/level-design/references/layout-and-flow.md
- skills/level-design/references/metrics.md
- skills/level-design/references/platformer-3d.md
- skills/level-design/references/platformer-camera.md
- skills/level-design/references/platformer-checks.md
- skills/level-design/references/platformer-craft.md
- skills/level-design/references/platformer-metrics.md
- skills/level-design/references/playtesting-and-critique.md
- skills/level-design/references/principles.md
- skills/level-design/references/process.md
- skills/level-design/references/puzzle-craft.md
- skills/level-design/references/puzzle-sequencing.md
- skills/level-design/references/puzzle-verification.md
- skills/level-design/references/review-rubric.md
- skills/level-design/references/verticality.md
- skills/level-design/scripts/beat_lint.py
- skills/level-design/scripts/dependency_chart.py
- skills/level-design/scripts/graph_check.py
- skills/level-design/scripts/grid_lint.py
- skills/level-design/scripts/grid_puzzle_solve.py
- skills/level-design/scripts/jump_links.py
- skills/level-design/scripts/level_metrics.py
- skills/level-design/scripts/platformer_reach.py
- skills/level-design/scripts/tests/fixtures/beats/bad.md
- skills/level-design/scripts/tests/fixtures/beats/good.md
- skills/level-design/scripts/tests/fixtures/graph/consumed_softlock.json
- skills/level-design/scripts/tests/fixtures/graph/cycle_dead.mmd
- skills/level-design/scripts/tests/fixtures/graph/deps_bad.txt
- skills/level-design/scripts/tests/fixtures/graph/deps_ok.txt
- skills/level-design/scripts/tests/fixtures/graph/deps_wide.json
- skills/level-design/scripts/tests/fixtures/graph/dungeon.md
- skills/level-design/scripts/tests/fixtures/graph/keys_ok.json
- skills/level-design/scripts/tests/fixtures/graph/oneway_trap.json
- skills/level-design/scripts/tests/fixtures/graph/unreachable.json
- skills/level-design/scripts/tests/fixtures/links/chain.json
- skills/level-design/scripts/tests/fixtures/links/depth.md
- skills/level-design/scripts/tests/fixtures/links/kz.md
- skills/level-design/scripts/tests/fixtures/links/teasers.md
- skills/level-design/scripts/tests/fixtures/links/traps.md
- skills/level-design/scripts/tests/fixtures/platformer/collectibles.txt
- skills/level-design/scripts/tests/fixtures/platformer/gap5.txt
- skills/level-design/scripts/tests/fixtures/platformer/gap7.txt
- skills/level-design/scripts/tests/fixtures/platformer/height_ladder.txt
- skills/level-design/scripts/tests/fixtures/platformer/kit.json
- skills/level-design/scripts/tests/fixtures/platformer/ladder.txt
- skills/level-design/scripts/tests/fixtures/platformer/ladder_removed.txt
- skills/level-design/scripts/tests/fixtures/platformer/oneway.txt
- skills/level-design/scripts/tests/fixtures/platformer/oneway_solid.txt
- skills/level-design/scripts/tests/fixtures/platformer/softlock.txt
- skills/level-design/scripts/tests/fixtures/platformer/spikes_narrow.txt
- skills/level-design/scripts/tests/fixtures/platformer/spikes_wide.txt
- skills/level-design/scripts/tests/fixtures/platformer/steps3.txt
- skills/level-design/scripts/tests/fixtures/platformer/tall_wall.txt
- skills/level-design/scripts/tests/fixtures/platformer/tunnel.txt
- skills/level-design/scripts/tests/fixtures/puzzle/exit_level.txt
- skills/level-design/scripts/tests/fixtures/puzzle/ice_box_slide.txt
- skills/level-design/scripts/tests/fixtures/puzzle/ice_player_slide.txt
- skills/level-design/scripts/tests/fixtures/puzzle/key_door.txt
- skills/level-design/scripts/tests/fixtures/puzzle/key_door_bypass.txt
- skills/level-design/scripts/tests/fixtures/puzzle/open_room_4box.txt
- skills/level-design/scripts/tests/fixtures/puzzle/open_room_4box_8x10.txt
- skills/level-design/scripts/tests/fixtures/puzzle/open_room_7box_cap.txt
- skills/level-design/scripts/tests/fixtures/puzzle/pit_fill.txt
- skills/level-design/scripts/tests/fixtures/puzzle/platformer_chunk.txt
- skills/level-design/scripts/tests/fixtures/puzzle/ragged_sokoban.txt
- skills/level-design/scripts/tests/fixtures/puzzle/ruled_fenced.md
- skills/level-design/scripts/tests/fixtures/puzzle/shortcut_room.txt
- skills/level-design/scripts/tests/fixtures/puzzle/switch_gate.txt
- skills/level-design/scripts/tests/fixtures/puzzle/two_box.txt
- skills/level-design/scripts/tests/fixtures/puzzle/unsolvable_corner.txt
- skills/level-design/scripts/tests/fixtures/puzzle/unsolvable_search.txt
- skills/level-design/scripts/tests/fixtures/puzzle/unstack.txt
- skills/level-design/scripts/tests/fixtures/puzzle/unstack_draft.txt
- skills/level-design/scripts/tests/fixtures/puzzle/walled_12x12_5box.txt
- skills/level-design/scripts/tests/test_beat_lint.py
- skills/level-design/scripts/tests/test_dependency_chart.py
- skills/level-design/scripts/tests/test_graph_check.py
- skills/level-design/scripts/tests/test_grid_lint.py
- skills/level-design/scripts/tests/test_grid_puzzle_solve.py
- skills/level-design/scripts/tests/test_jump_links.py
- skills/level-design/scripts/tests/test_level_metrics.py
- skills/level-design/scripts/tests/test_platformer_reach.py
Every link opens the file at its source, pinned to the revision this page describes.