Supports game design workflows by applying MDA frameworks, player aesthetics, and core loop balancing.

Install

mkdir -p .claude/skills/game-design-fabioc-aloha && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10307" && unzip -o skill.zip -d .claude/skills/game-design-fabioc-aloha && rm skill.zip

Installs to .claude/skills/game-design-fabioc-aloha

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Game mechanics, level design, player psychology, systems balancing, and narrative design for game developers.
109 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Balance game mechanics and systems
  • Design level layouts and flow
  • Map player experience goals
  • Refine core game loops
  • Apply MDA framework analysis

How it works

It uses the MDA framework to align mechanics, dynamics, and aesthetics, ensuring that game systems create intended player experiences and agency.

Inputs & outputs

You give it
Game design concept or mechanic
You get back
Balanced system or design specification

When to use game-design

  • Balance game mechanics
  • Design a level layout
  • Map out player experience goals
  • Refine the core game loop

About this skill

Game Design Skill

Game mechanics, level design, player psychology, systems balancing, and narrative design for game developers.

Core Principle

A great game teaches you how to play it without telling you. Every mechanic, level layout, and narrative beat exists to create player agency — the feeling that choices matter and mastery is earned.

Core Mechanics

MDA Framework

LayerStands ForPerspective
MechanicsRules, systems, algorithmsDesigner builds
DynamicsBehaviors that emerge from mechanicsPlayer experiences
AestheticsEmotional responsesPlayer feels

Design flows: Mechanics → Dynamics → Aesthetics Player experiences: Aesthetics ← Dynamics ← Mechanics

Eight Kinds of Fun (Aesthetics)

AestheticDescriptionExample Games
SensationSensory pleasureJourney, Flower
FantasyMake-believe, immersionSkyrim, Mass Effect
NarrativeStory as dramaThe Last of Us, Disco Elysium
ChallengeObstacle course, masteryDark Souls, Celeste
FellowshipSocial frameworkAmong Us, MMOs
DiscoveryExploration, curiosityBreath of the Wild, Outer Wilds
ExpressionSelf-discovery, creativityMinecraft, Dreams
SubmissionPastime, zone-outStardew Valley, idle games

Game Loops

Core Loop

The repeatable cycle that forms the foundation of gameplay:

Action → Reward → Progression → New Action

Game Design Document (GDD) Structure

title: "Game Name"
genre: "Action RPG"
platform: ["PC", "Console"]
target_audience: "16-35, hardcore gamers"
core_loop:
  action: "Combat encounter"
  reward: "XP, loot drops"
  progression: "Level up, unlock skills"
pillars:
  - "Player agency in story outcomes"
  - "Deep crafting system"
  - "Challenging but fair combat"
aesthetics: ["Challenge", "Fantasy", "Discovery"]

Nested Loops

Loop LevelTimescaleExample (RPG)
MicroSecondsCombat: attack → dodge → counter
CoreMinutesQuest: accept → explore → complete → reward
MetaHoursCharacter build: level up → unlock skills → tackle harder content
MacroDays/WeeksSeasonal events, guild wars, leaderboard resets

Level Design

Design Pillars

  1. Readability — Player understands the space and objectives at a glance
  2. Flow — Smooth navigation, no dead ends without purpose
  3. Pacing — Tension and release cycle (combat → exploration → puzzle → reward)
  4. Teaching — Introduce mechanics in safe spaces before testing them

Level Design Process

  1. Paper design — Sketch layout, define critical path, mark encounters
  2. Graybox — Blockout in engine with primitive geometry
  3. Playtest graybox — Test flow, pacing, sightlines before art investment
  4. Art pass — Replace primitives with final art, lighting, audio
  5. Polish — VFX, particles, ambient audio, secondary animations
  6. QA — Bug testing, boundary testing, performance profiling

Spatial Communication

TechniquePurpose
Weenies (landmarks)Draw player toward objectives (Disney's castle principle)
BreadcrumbsPickups/lights along intended path
GatingLock progression behind ability/key acquisition
ChokepointsFunnel players through narrative beats
VistasReward exploration with visual payoff

Player Psychology

Flow State (Csikszentmihalyi)

  • Challenge ≈ Skill — Too easy = boredom; too hard = frustration
  • Dynamic difficulty adjustment (DDA) keeps players in the flow channel
  • Provide clear goals, immediate feedback, and sense of control

Motivation Frameworks

TheoryComponentsDesign Implication
Self-DeterminationAutonomy, Competence, RelatednessPlayer choice, skill growth, social features
Bartle TypesAchiever, Explorer, Socializer, KillerContent for each player type
Operant ConditioningReinforcement schedulesReward timing (variable ratio is most engaging)

Onboarding Best Practices

  1. Let players do before telling them
  2. One mechanic per tutorial section
  3. Safe failure — let players fail without punishment in early areas
  4. Contextual prompts, not text walls
  5. Veteran players can skip or fast-track tutorials

Systems Design & Balancing

Economy Design

Currency TypeEarnable BySinks
Soft currencyNormal gameplayCommon items, upgrades
Hard currencyPremium purchase or rare earnPremium cosmetics, time skips
EnergyTime-gated regenerationPlay sessions (mobile)

Balancing Methodology

  1. Spreadsheet modeling — Define formulas for damage, health, progression curves
  2. Power budget — Each item/character gets a fixed power budget; trade-offs within budget
  3. Internal playtesting — Team plays the game, not just tests it
  4. Telemetry — Track win rates, pick rates, engagement per feature
  5. Iterative tuning — Small changes, measure impact, repeat

Progression Curves

Curve TypeShapePlayer Feeling
LinearConstant ratePredictable, can feel grindy
ExponentialSlow start, fast growthPower fantasy, late-game trivialization
LogarithmicFast start, diminishing returnsAccessible, respects veteran time
S-CurveSlow → fast → slowBest of both worlds, natural pacing

Narrative Design

Environmental Storytelling

  • Tell stories through objects, placement, and state (not cutscenes)
  • "What happened here?" is more engaging than "Here's what happened"
  • Every room should tell a micro-story through its contents

Quest Design Patterns

TypeStructurePlayer Agency
Main questCritical path, mandatoryLow (must complete)
Side questOptional, character-drivenMedium (player chooses when/whether)
Radiant/proceduralAuto-generatedLow (filler, use sparingly)
BranchingPlayer choices affect outcomeHigh (consequences matter)
EnvironmentalDiscovered through explorationHigh (player-driven discovery)

Dialogue Systems

  • Branching trees — Explicit choices, clear consequences
  • Hub and spoke — Central topic, player explores branches
  • Parser-driven — Text input interpreted (niche but immersive)
  • Contextual barks — NPC reactions to player state/actions

Monetization Ethics

Ethical Monetization

  • Cosmetics over power (avoid pay-to-win)
  • Transparent odds for randomized rewards
  • No dark patterns targeting vulnerable populations
  • Age-appropriate controls and spending limits
  • Value proposition: players should feel good about purchases

Anti-Patterns to Avoid

PatternWhy It's Harmful
Loot boxes with opaque oddsGambling mechanics, regulatory risk
Pay-to-win advantageDestroys competitive integrity
Artificial scarcity pressureFOMO manipulation
Energy paywallsPunishes engagement
Targeting whalesExploits vulnerable spending habits

When not to use it

  • When designing non-interactive media

Limitations

  • Requires iterative tuning based on telemetry
  • Balancing depends on defined progression curves

How it compares

It provides a structured framework for game design that prioritizes player psychology and system balance over intuitive guessing.

Compared to similar skills

game-design side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
game-design (this skill)03moNo flagsIntermediate
ui-ux-pro-max1,9095moReviewIntermediate
drawio-diagrams-enhanced1,3209moReviewIntermediate
svg-precision5274moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

ui-ux-pro-max

nextlevelbuilder

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.

1,9092,023

drawio-diagrams-enhanced

jgtolentino

Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.

1,3201,999

svg-precision

dkyazzentwatwa

Deterministic SVG generation, validation, and rendering. Use for icons, diagrams, charts, UI mockups, or technical drawings requiring structural correctness and cross-viewer compatibility.

5271,229

mobile-ios-design

wshobson

Master iOS Human Interface Guidelines and SwiftUI patterns for building native iOS apps. Use when designing iOS interfaces, implementing SwiftUI views, or ensuring apps follow Apple's design principles.

272711

blender-toolkit

Dev-GOM

Automate Blender tasks like creating 3D shapes, managing materials, and retargeting Mixamo animations with real-time control.

175510

infographic-creation

antvis

Create beautiful infographics based on the given text content. Use this when users request creating infographics.

120358

Search skills

Search the agent skills registry