platformer
Designs 2D platformers in any engine: jump feel (coyote time, jump buffering, variable height, fall gravity, corner correction), wall jumps, hazards, checkpoints and one-way platforms. Use for a Mario- or Celeste-like, or a jump that feels floaty or laggy.
Install / Use
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill platformerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of platformer
platformer scores 94/100 on our quality scale, 34th of 329 Other skills we index (top 11%).
Its SKILL.md is 6.5 KB long, well organised into 19 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 8,904 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 4 days ago, so platformer is actively maintained.
- Our last check on 2026-11-16 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
platformer compared with similar skills
All 4 of these similar skills score higher than platformer; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| platformer (this skill)by gamedev-skills | 94 | 8.9k | 4d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install platformer?
- Run
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill platformer. The install tabs above show the steps for each supported agent. - Which AI agents does platformer work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is platformer safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is platformer still maintained?
- The repository was last updated 4 days ago, so platformer is actively maintained.
Skill content
View source on GitHubname: platformer description: > Build a 2D platformer: run/jump control with coyote time, jump buffering, and variable jump height, plus tiled levels and hazards. Use for a platformer or Mario/Celeste-like, or tuning jump feel.
Platformer
A playbook for 2D platformers β the run/jump controller "feel", level structure, hazards, and goals. This is a compositional skill: it wires an engine movement skill, a tilemap skill, and design skills into a working game. It does not re-teach physics or tilemaps; it tells you what to build and how to make jumping feel good.
When to use
- Use when building a side-scrolling or single-screen platformer, a "Mario-like" / "Celeste-like", or any game whose core verb is jump between surfaces.
- Use when a jump feels floaty, unresponsive, or "unfair" and you need feel fixes (coyote time, jump buffering, variable height, corner correction).
When not to use: top-down movement with no gravity β use the engine movement skill
directly. 3D first-person traversal β fps-shooter. Grid/turn movement β roguelike.
For the raw kinematic body API, use godot-2d-movement (or your engine's controller skill).
Core loop
Observe a gap/hazard β commit to a jump or move β land safely (or die) β reach the next checkpoint/goal. A platformer lives or dies on the moment-to-moment feel of that single jump, repeated thousands of times. Tighten the controller first; everything else is content.
Must-have systems
- Run/jump controller β horizontal accel/decel, gravity, jump, with the feel aids below.
- Solid + one-way collision β ground, walls, and "jump-through" platforms.
- Level geometry β a tilemap or hand-placed colliders; the playable space.
- Hazards + death/respawn β spikes, pits, enemies; reset to the last checkpoint.
- Checkpoints / level goal β progress markers and a win condition (flag, door, exit).
- Camera β follows the player with a deadzone and look-ahead, clamped to level bounds.
- Juice β landing dust, squash/stretch, hit-stop, sound. Cheap, huge feel payoff.
Design knobs (make the jump feel right)
Tune these by outcome (height in tiles, time to apex in seconds), not by raw numbers.
| Knob | Effect | Sane starting point |
|------|--------|---------------------|
| Max jump height | reach | 3β4 tiles |
| Time to apex | "weight"/snappiness | 0.30β0.40 s |
| Fall gravity multiplier | snappy, non-floaty fall | 1.5β2.0Γ rise gravity |
| Coyote time | jump just after leaving a ledge | 0.08β0.12 s (~5β7 frames @60) |
| Jump buffer | press just before landing still jumps | 0.10β0.15 s |
| Variable jump cut | tap = short hop, hold = full | cut upward velocity Γ0.4β0.5 on release |
| Apex hang | brief float at the top for air control | reduce gravity Γ0.5 near |vy|<threshold |
| Ground accel / friction | responsiveness vs. ice | reach top speed in 0.05β0.1 s |
| Corner correction | nudge past a ledge clipped by 1β2 px | nudge up to ~4 px sideways |
Derive gravity and jump velocity from the feel values rather than guessing β see Pattern 1.
Patterns
1. Solve jump physics from height + time (not magic numbers)
# Pseudocode. Pick the FEEL you want, then derive the physics. y-axis points DOWN.
# From kinematics: h = (g * t^2) / 2 and v0 = g * t.
JUMP_HEIGHT = 3.5 * TILE # how high, in world units
TIME_TO_APEX = 0.35 # seconds to reach the top
gravity = (2 * JUMP_HEIGHT) / (TIME_TO_APEX ** 2) # rising gravity
jump_velocity = -(2 * JUMP_HEIGHT) / TIME_TO_APEX # negative = upward
fall_gravity = gravity * 1.8 # heavier on the way down β less floaty
2. Coyote time + jump buffer + variable height (the feel core)
# Pseudocode in the per-frame update. dt = seconds since last frame.
# Timers count DOWN; refresh coyote while grounded, buffer on a fresh press.
if on_floor:
coyote_timer = COYOTE_TIME # 0.1
if jump_pressed_this_frame:
buffer_timer = JUMP_BUFFER # 0.12
coyote_timer -= dt
buffer_timer -= dt
# A jump is allowed if we pressed recently AND were grounded recently.
if buffer_timer > 0 and coyote_timer > 0:
velocity.y = jump_velocity
buffer_timer = 0
coyote_timer = 0 # consume both so we can't double-jump
# Variable height: releasing jump early while still rising cuts the arc short.
if jump_released_this_frame and velocity.y < 0:
velocity.y *= 0.45
# Asymmetric gravity: snappier fall than rise.
g = fall_gravity if velocity.y > 0 else gravity
velocity.y += g * dt
3. One-way platforms
Solid from above, pass-through from below. Most engines expose a "one-way collision" flag on the tile/collider; enable it and let the player drop through by disabling that collision for a few frames when the player holds Down + Jump. Do not re-implement collision math.
Pitfalls / failure modes
- Per-frame movement not scaled by
dtβ speed changes with frame rate. Every velocity integration and timer must usedt. (Seephysics-tuning.) - Floaty jumps β symmetric gravity. Make fall gravity heavier than rise gravity.
- "The jump didn't register" β no input buffering. Buffer presses for ~0.1 s before landing.
- "I fell off and couldn't jump" β no coyote time. Allow a jump for ~0.1 s after leaving ground.
- Sticking to walls / catching on tile seams β use a single capsule/box collider, not per-tile colliders, and add corner correction.
- Tunneling through floors at high speed β enable continuous collision / smaller fixed
timestep for fast bodies (see
physics-tuning). - Camera snaps and induces nausea β smooth/lerp the follow, add a deadzone, clamp to bounds.
- Difficulty wall from bad teaching β introduce one mechanic per area before combining them.
Composition (build it from these skills)
- Controller body:
godot-2d-movement(GodotCharacterBody2D); for other engines use the engine core + physics skill (unity-physics,phaser-arcade-physics,pygame-core). - Levels:
godot-tilemap/unity-tilemap-2dfor geometry;level-designfor layout, pacing, and teaching order. - Feel/physics:
physics-tuningfor timestep, CCD, and stability. - Input:
input-systemsfor buffering, rebinding, and gamepad support. - Polish:
audio-designfor SFX/music; the engine animation skill for squash/stretch. - Process:
prototype-fastto greybox the controller before building content.
References
- For jump math derivation, a full feel-tuning table, corner correction, moving/one-way
platforms, and camera follow, read
references/feel-tuning.md.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio β 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
x402
121.0kSet up Browser Use Cloud payments with x402 β pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
