game-design
Learn the essentials of game design through core loop mechanics, game design document structure, and player motivation frameworks. This skill covers difficulty balancing, progression design, and practical anti-patterns to avoid during development. Build engaging games by understanding the 30-second loop, reward systems, and flow state principles.
Game Design teaches core loop structure, balancing techniques, and player psychology for building engaging games.
AI-generated summary based on this skill's SKILL.md
Install
vudovn/ag-kit/game-design · repository language: TypeScript
git clone https://github.com/vudovn/ag-kit
cp -r ag-kit/.agents/skills/game-development/game-design ~/.claude/skills/game-designnpx skillfed install vudovn/ag-kit/game-designFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do you structure a game design document?
game-design teaches you to build a GDD with essential sections including core mechanics, player motivation types, progression systems, and difficulty balancing. A well-structured game design document captures your game's 30-second core loop, reward schedules, and pacing strategy. The skill covers anti-patterns to avoid and best practices for organizing sections so your design remains clear through development iterations.
What is the 30-second game loop and why does it matter?
game-design emphasizes that the 30-second game loop is the fundamental repeating action cycle players experience. This core loop defines your game's moment-to-moment gameplay and directly impacts engagement. Understanding how to design this loop—balancing difficulty, reward timing, and player agency—is central to creating fun experiences and achieving flow state where players remain optimally challenged.
How can I balance game difficulty to achieve flow state?
game-design covers difficulty balancing as a key lever for flow state, where challenge matches player skill. The skill teaches you to adjust progression systems, pacing, and reward schedules so players stay engaged without frustration. By understanding player motivation types and anti-patterns, you learn when to increase challenge, introduce new mechanics, and provide meaningful progression that sustains long-term engagement.
What player motivation types should I design for?
game-design teaches player psychology frameworks showing how different motivation types drive engagement. By understanding what compels players—whether through achievement, exploration, social connection, or mastery—you can design reward systems and progression mechanics that resonate. This knowledge helps you create games that feel fun and meaningful rather than relying on guesswork or anti-patterns.
How do I design a progression system that keeps players advancing?
game-design covers progression system design as a pacing tool that sustains player advancement and motivation. The skill teaches you to structure unlocks, difficulty curves, and reward schedules so players always have clear goals. Effective progression balances challenge with achievable milestones, preventing both boredom and frustration while maintaining the engaging 30-second loop throughout your game.
What are common game design anti-patterns I should avoid?
game-design identifies anti-patterns that undermine engagement, such as poor pacing, misaligned difficulty, and reward systems that don't match player psychology. The skill teaches you to recognize when progression stalls, when core loops become tedious, or when difficulty spikes break flow state. Understanding these pitfalls helps you iterate faster and build games that maintain player motivation from start to finish.
SKILL.md
rendered from the published skill — quoted content, verbatim
Game Design Principles
> Design thinking for engaging games.
1. Core Loop Design
The 30-Second Test
Every game needs a fun 30-second loop:
1. ACTION → Player does something
2. FEEDBACK → Game responds
3. REWARD → Player feels good
4. REPEAT
Loop Examples
| Genre | Core Loop |
|---|---|
| Platformer | Run → Jump → Land → Collect |
| Shooter | Aim → Shoot → Kill → Loot |
| Puzzle | Observe → Think → Solve → Advance |
| RPG | Explore → Fight → Level → Gear |
2. Game Design Document (GDD)
Essential Sections
| Section | Content |
|---|---|
| Pitch | One-sentence description |
| Core Loop | 30-second gameplay |
| Mechanics | How systems work |
| Progression | How player advances |
| Art Style | Visual direction |
| Audio | Sound direction |
Principles
- Keep it living (update regularly)
- Visuals help communicate
- Less is more (start small)
3. Player Psychology
Motivation Types
| Type | Driven By |
|---|---|
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
.agents/skills/game-development/game-design/SKILL.md