How do I install the Game Design skill?

Run npx skillmds@latest add ziadnagar/game-design in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Game Design skill do?

Game design principles. GDD structure, balancing, player psychology, progression. It is listed under Coding & Dev Tools on SkillMD.

Is Game Design safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Game Design?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Game Design free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Game Design?

ZiadNagar (@ziadnagar) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Game Design by ziadnagar — Agent Skill

Name: Game Design
Author: ZiadNagar

File contents

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
Achiever	Goals, completion
Explorer	Discovery, secrets
Socializer	Interaction, community
Killer	Competition, dominance

Reward Schedules

Schedule	Effect	Use
Fixed	Predictable	Milestone rewards
Variable	Addictive	Loot drops
Ratio	Effort-based	Grind games

4. Difficulty Balancing

Flow State

Too Hard → Frustration → Quit
Too Easy → Boredom → Quit
Just Right → Flow → Engagement

Balancing Strategies

Strategy	How
Dynamic	Adjust to player skill
Selection	Let player choose
Accessibility	Options for all

5. Progression Design

Progression Types

Type	Example
Skill	Player gets better
Power	Character gets stronger
Content	New areas unlock
Story	Narrative advances

Pacing Principles

Early wins (hook quickly)
Gradually increase challenge
Rest beats between intensity
Meaningful choices

6. Anti-Patterns

❌ Don't	✅ Do
Design in isolation	Playtest constantly
Polish before fun	Prototype first
Force one way to play	Allow player expression
Punish excessively	Reward progress

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

---name: game-designdescription: Game design principles. GDD structure, balancing, player psychology, progression.---# 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 something2. FEEDBACK → Game responds3. REWARD → Player feels good4. 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 ||------|-----------|| **Achiever** | Goals, completion || **Explorer** | Discovery, secrets || **Socializer** | Interaction, community || **Killer** | Competition, dominance |### Reward Schedules| Schedule | Effect | Use ||----------|--------|-----|| **Fixed** | Predictable | Milestone rewards || **Variable** | Addictive | Loot drops || **Ratio** | Effort-based | Grind games |---## 4. Difficulty Balancing### Flow State```Too Hard → Frustration → QuitToo Easy → Boredom → QuitJust Right → Flow → Engagement```### Balancing Strategies| Strategy | How ||----------|-----|| **Dynamic** | Adjust to player skill || **Selection** | Let player choose || **Accessibility** | Options for all |---## 5. Progression Design### Progression Types| Type | Example ||------|---------|| **Skill** | Player gets better || **Power** | Character gets stronger || **Content** | New areas unlock || **Story** | Narrative advances |### Pacing Principles- Early wins (hook quickly)- Gradually increase challenge- Rest beats between intensity- Meaningful choices---## 6. Anti-Patterns| ❌ Don't | ✅ Do ||----------|-------|| Design in isolation | Playtest constantly || Polish before fun | Prototype first || Force one way to play | Allow player expression || Punish excessively | Reward progress |---> **Remember:** Fun is discovered through iteration, not designed on paper.

Frequently asked questions

Game Design