mcpField
G
game-design

game-design

github.com/sickn33Creative & media48.7k76 installsUpdated 1d ago
Repository

About game-design

Game Design Principles is a guidance skill for game designers covering core loops, design documents, difficulty, and progression. It treats its principles as starting points to test through prototyping and playtesting, not as guaranteed outcomes.

Key features

  1. 01Design core gameplay loops
  2. 02Structure a game design document
  3. 03Consider player motivations and rewards
  4. 04Balance difficulty and accessibility
  5. 05Plan progression and pacing
  6. 06Iterate through prototypes and playtests

Use cases

  1. 01Design a core loop for a game prototype
  2. 02Draft or refine a game design document
  3. 03Evaluate difficulty and progression through playtests

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill game-design

After installing, type/game-designin Claude Code to confirm it loaded.

Details

From the project README

Game Design Principles

Design thinking for engaging games.


1. Core Loop Design

The 30-Second Test
Prototype a short loop; 30 seconds is a heuristic, not a universal rule:
1. ACTION → Player does something
2. FEEDBACK → Game responds
3. REWARD → Player feels good
4. REPEAT
Loop Examples
GenreCore Loop
PlatformerRun → Jump → Land → Collect
ShooterAim → Shoot → Kill → Loot
PuzzleObserve → Think → Solve → Advance
RPGExplore → Fight → Level → Gear

2. Game Design Document (GDD)

Essential Sections
SectionContent
PitchOne-sentence description
Core LoopActions, feedback and meaningful outcomes
MechanicsHow systems work
ProgressionHow player advances
Art StyleVisual direction
AudioSound direction
Principles
  • Keep it living (update regularly)
  • Visuals help communicate
  • Less is more (start small)

3. Player Psychology

Motivation Types

This is a historical player-type heuristic, not an exhaustive taxonomy or a validated label for an individual. Confirm motivations through voluntary playtests.

TypeDriven By
AchieverGoals, completion
ExplorerDiscovery, secrets
SocializerInteraction, community
KillerCompetition, dominance
Reward Schedules
ScheduleEffectUse
FixedPredictableMilestone rewards
VariableUnpredictable outcomesOptional rewards with transparent odds
RatioReward after a number of responsesCan be fixed or variable; a separate dimension from predictability

4. Difficulty Balancing

Flow State
Too Hard → Frustration → Quit
Too Easy → Boredom → Quit
Just Right → Flow → Engagement
Balancing Strategies
StrategyHow
DynamicAdjust to player skill
SelectionLet player choose
AccessibilityOptions for all

5. Progression Design

Progression Types
TypeExample
SkillPlayer gets better
PowerCharacter gets stronger
ContentNew areas unlock
StoryNarrative advances
Pacing Principles
  • Early wins (hook quickly)
  • Gradually increase challenge
  • Rest beats between intensity
  • Meaningful choices

6. Anti-Patterns

❌ Don't✅ Do
Design in isolationPlaytest constantly
Polish before funPrototype first
Force one way to playAllow player expression
Punish excessivelyReward progress

Remember: Fun is discovered through iteration, not designed on paper.

When to Use

Use when designing a playable core loop, preparing a GDD, balancing difficulty, or evaluating progression through playtests.

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Verification

Treat tables as design starting points, not guarantees. Prototype the selected mechanic, test accessibility and recovery paths, and measure frame timing, memory and behavior on target hardware before claiming completion. Store submission and licensing requirements must be checked against current official platform documentation.

Comments

Markdown supported