Agent skill

Game Design

by xenitV1 in xenitV1/Antigravity-Workflows

Game design principles. An agent skill from xenitV1/Antigravity-Workflows.

MITAuto-check passedGame Development

Install Game Design

skills CLI
$ npx skills add xenitV1/Antigravity-Workflows --skill game-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install xenitV1/Antigravity-Workflows game-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/xenitV1/Antigravity-Workflows.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/game-development/game-design .claude/skills/game-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
game-design
GitHub stars
130
Used in
9 other repos
Token cost
~650 tokens
SKILL.md length
217 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

Game design principles. An agent skill from xenitV1/Antigravity-Workflows.

  • Works in 6 steps: Core Loop Design → Game Design Document (GDD) → Player Psychology → …
  • Tasks that involve Game design
  • SKILL.md covers 1. Core Loop Design, 2. Game Design Document (GDD), 3. Player Psychology and 4. Difficulty Balancing, plus 2 more sections
  • Calls just

What it does

Game Design is an agent skill from xenitV1/Antigravity-Workflows. Game design principles. GDD structure, balancing, player psychology, progression.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development, covering Game design. The licence is MIT.

When your agent uses it

  • Tasks that involve Game design

Example prompts

  • “/game-design”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Core Loop Design
  2. Game Design Document (GDD)
  3. Player Psychology
  4. Difficulty Balancing
  5. Progression Design
  6. Anti-Patterns

What it can do on your machine

Read from SKILL.md and the folder at commit f0a1fa7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • just

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Game Design loads about 650 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 217 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~650

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from xenitV1/Antigravity-Workflows at commit f0a1fa7, republished under its MIT licence (© xenitV1). 217 words, ~650 tokens.

Download SKILL.mdSave it as .claude/skills/game-design/SKILL.md (or your agent's skills folder).
name
game-design
description
Game design principles. GDD structure, balancing, player psychology, progression.
allowed-tools
Read, Glob, Grep

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
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 Loop30-second gameplay
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
TypeDriven By
AchieverGoals, completion
ExplorerDiscovery, secrets
SocializerInteraction, community
KillerCompetition, dominance
Reward Schedules
ScheduleEffectUse
FixedPredictableMilestone rewards
VariableAddictiveLoot drops
RatioEffort-basedGrind games

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.

© xenitV1, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/game-development/game-design of xenitV1/Antigravity-Workflows.

Open the folder on GitHubat commit f0a1fa7

Used in 9 other repositories

We found 26 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 9 other GitHub owners. This page covers the copy in xenitV1/Antigravity-Workflows, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Game Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Game Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Game Design this skillxenitV1/Antigravity-Workflows1309 repos~650Automated safety check: PassMIT
Threejs Gameplay Systemsvalkor-ai/loom1.2k1 repos~1.4kAutomated safety check: PassApache-2.0
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
Game Asset Spec WriterDonchitos/Claude-Code-Game-Studios26k—~5kAutomated safety check: PassMIT
Game Build From Designzenstory-ai/novel-to-game841—~661Automated safety check: PassMIT
Game Experience Density OptimizerDY-2026/GameDesignOS414—~2.1kAutomated safety check: PassMIT

Similar skills

  • Build and iterate playable Three.js game systems: starter scaffold, architecture, design briefs, core loops, level and encounter design, entities, input, camera, collision and physics, scoring…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Game DevelopmentAuto-check passed
  • Godot Gdscript Patterns

    925236118/AlphaAgent

    Master Godot 4 GDScript patterns including signals, scenes, state machines, and optimization.

    103 GitHub starsUsed in 10 repos~5k tokens
    Game DevelopmentAuto-check passed
  • Game Asset Spec Writer

    Donchitos/Claude-Code-Game-Studios

    Writes per-asset visual specs and AI image-generation prompts for a game's characters, enemies and screens, driven by the GDD, art bible and an entity inventory.

    26k GitHub stars~5k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Game Build From Design

    zenstory-ai/novel-to-game

    Builds a risk-matched whitebox or an approved production game candidate from a game design for its target runtime, with replayable evidence.

    841 GitHub stars~661 tokensUpdated 6 days ago
    Game DevelopmentAuto-check passed
  • 当用户需要把游戏体验浓度、留存、首局节奏、Demo 完成率、单机总旅程、D1/D7、反馈、具身感、氛围、认知负荷、最佳刺激窗口、FEP/free-energy、预测误差、Markov blanket、习惯化或 liveops 参与问题,编译成可上线、可埋点、可复盘、可回滚的一周 ED 实验包时使用。Use when converting game experience-density and…

    414 GitHub stars~2.1k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed
  • Threejs Gameplay Systems

    corosolto/client

    Build and iterate playable Three.js game systems. An agent skill from corosolto/client.

    257 GitHub stars~1.5k tokensUpdated yesterday
    Game DevelopmentAuto-check passed

More from xenitV1/Antigravity-Workflows

All 42 skills in this repo
  • Parallel Agents

    xenitV1/Antigravity-Workflows

    Native multi-agent orchestration using Claude Code's Agent Tool.

    130 GitHub starsUsed in 9 repos~1.3k tokens
    Auto-check passed
  • Mobile Design

    xenitV1/Antigravity-Workflows

    Mobile-first design thinking and decision-making for iOS and Android apps.

    130 GitHub starsUsed in 2 repos~3.7k tokens
    Auto-check: notes
  • Bash Linux

    xenitV1/Antigravity-Workflows

    Bash/Linux terminal patterns. An agent skill from xenitV1/Antigravity-Workflows.

    130 GitHub starsUsed in 8 repos~1k tokens
    Auto-check: notes
  • Performance Profiling

    xenitV1/Antigravity-Workflows

    Performance profiling principles. An agent skill from xenitV1/Antigravity-Workflows.

    130 GitHub starsUsed in 8 repos~772 tokens
    Auto-check: notes
  • Plan Writing

    xenitV1/Antigravity-Workflows

    Structured task planning with clear breakdowns, dependencies, and verification criteria.

    130 GitHub starsUsed in 8 repos~994 tokens
    Auto-check passed
  • Behavioral Modes

    xenitV1/Antigravity-Workflows

    AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate).

    130 GitHub starsUsed in 7 repos~1.3k tokens
    Auto-check passed

Questions about Game Design

What does Game Design do?

Game design principles. An agent skill from xenitV1/Antigravity-Workflows. Game Design is an agent skill from xenitV1/Antigravity-Workflows. Game design principles.

When should I use Game Design?

Game Design fits situations like: tasks that involve Game design.

How do I install Game Design in Claude Code?

Run `npx skills add xenitV1/Antigravity-Workflows --skill game-design -a claude-code`. Or copy the skill folder (skills/game-development/game-design in xenitV1/Antigravity-Workflows) into .claude/skills/game-design in your project. Claude Code loads it when a task matches its description.

How do I install Game Design in Codex?

Run `npx skills add xenitV1/Antigravity-Workflows --skill game-design -a codex`. Or copy the skill folder (skills/game-development/game-design in xenitV1/Antigravity-Workflows) into .agents/skills/game-design in your project. Codex loads it when a task matches its description.

Can I use Game Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add xenitV1/Antigravity-Workflows --skill game-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/game-design, .gemini/skills/game-design, .github/skills/game-design and .opencode/skills/game-design in your project.

What does Game Design need to run?

Going by SKILL.md and its folder, Game Design needs the command-line tools its instructions call (just). Its frontmatter pre-approves these tools: Read, Glob, Grep.

Does Game Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Game Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Game Design use?

Game Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Game Design use?

About 650 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Game Design?

Skills that share tags, products or a category with Game Design: Threejs Gameplay Systems (valkor-ai/loom, 1.2k stars), Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars), Game Asset Spec Writer (Donchitos/Claude-Code-Game-Studios, 26k stars) and Game Build From Design (zenstory-ai/novel-to-game, 841 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Game Design?

xenitV1 (a GitHub user) maintains it in xenitV1/Antigravity-Workflows, which has 130 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on January 14, 2026.

Source: xenitV1/Antigravity-Workflows on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.