gd-design-theory

Applies game design theory frameworks to analyze mechanics, engagement, and player psychology.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Unity-UPM-Packages/Antigravity-skills --skill gd-design-theory-unity-upm-packages
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gd-design-theory
Source: https://github.com/Unity-UPM-Packages/Antigravity-skills/tree/main/.agents/skills/gd-design-theory
Command: npx skills add https://github.com/Unity-UPM-Packages/Antigravity-skills --skill gd-design-theory-unity-upm-packages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game designers often struggle to explain why a mechanic works, diagnose why players churn, or justify design decisions with more than intuition. This Skill provides a structured encyclopedia of established game design theories and psychology models to ground analysis and recommendations in academic frameworks. ## Core Features & Use Cases - Player Psychology Models: Apply Self-Determination Theory, Flow Theory, Loss Aversion, Operant Conditioning, and Bartle's Player Types to diagnose motivation and engagement problems. - Systems & Structure Frameworks: Use MDA, Meaningful Play, the Magic Circle, and Koster's Theory of Fun to analyze game structure from mechanics to player experience. - Engagement & Retention Analysis: Apply the Hooked Model, Octalysis, Compulsion Loops, and Game Feel checklists to evaluate retention and moment-to-moment interaction quality. - Use Case: When players abandon your game at Level 12, use the decision matrix to identify the applicable theory (Flow), diagnose the difficulty spike pushing players into anxiety, and cite the framework in your design document. ## Quick Start Analyze why players are quitting my mobile game at level 12 using game design theory and recommend fixes grounded in established frameworks.

Frequently Asked Questions about gd-design-theory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose why players are quitting my game?▼

Use Self-Determination Theory to check which of the three needs (autonomy, competence, relatedness) is unmet, then apply Flow Theory to determine if players are in the boredom or anxiety zone. The decision matrix maps churn questions directly to these frameworks.

What is the MDA framework in game design?▼

MDA stands for Mechanics, Dynamics, and Aesthetics, a framework by Hunicke, LeBlanc, and Zubek for analyzing games systematically. Designers build from mechanics to aesthetics, while players experience aesthetics first, so design backwards from the desired emotion.

How do I make a game mechanic more engaging?▼

Apply Koster's Theory of Fun to check if players are still learning patterns, and use the Game Feel juice checklist to add visual effects, sound, screen feedback, and haptics to every action. Also verify the action is discernible and integrated per Meaningful Play.

Which reward schedule creates the strongest player engagement?▼

Variable Ratio schedules, where rewards arrive randomly after an unpredictable number of actions, produce the strongest engagement per Operant Conditioning research. Gacha and loot boxes use this schedule, so apply it responsibly to avoid exploitative design.

When should I use the Octalysis framework versus the Hooked Model?▼

Use the Hooked Model to design the habit loop of trigger, action, variable reward, and investment for retention. Use Octalysis as a checklist of eight core drives to balance extrinsic motivators like scarcity with intrinsic ones like epic meaning.