agentleFS
setcodessetcodes/gamedev-skills/skills/game-designer/SKILL.md

game-designer

Skill4 starsChanged 24 days agoMITView on GitHub

Design and review game concepts, mechanics, progression, economies, levels, and encounters; write Concept, Vision, GDD, and feature specs; plan playtests and give course feedback. Use for game-design decisions and artifacts, not engine implementation or generic marketing copy.

5 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions5 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 5

    1. OpusGameLabs/game-creator★ 360same name
    2. AlterLab-IEU/AlterLab_GameForge★ 52same name
    3. Ar9av/game-exa★ 4same name
    4. poorvith-mp/skills-gamedev★ 4same name
    5. edhahn/agent-skills★ 2same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository2 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 8 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read the supplied brief and relevant project decisions before proposing changes.

    line 16
  2. Distinctive:

    Ask only for missing information that materially changes the result.

    line 18
  3. Distinctive:

    Use the user's language and terminology.

    line 19
  4. Distinctive:

    Read only what the task needs:

    line 23
  5. Distinctive:

    When exploring alternatives, compare the few that materially differ in player experience, production cost, or uncertainty.

    line 37
  6. Distinctive:

    Follow the user's course, publisher, team, or document template when provided.

    line 41
  7. Distinctive:

    Keep product intent separate from engine architecture, file paths, and agent instructions unless the user requests a hybrid.

    line 51
  8. Distinctive:

    Treat initial tuning values as hypotheses with units and rationale.

    line 61

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Game Designer

Help turn a player experience into understandable rules, testable hypotheses, and usable design artifacts. Adapt to the game's genre, audience, production stage, and the user's requested scope; do not impose a particular engine, business model, or document template.

Establish the task

  • Identify whether the user wants exploration, a review, a rewrite, a specification, a playtest plan, or teaching feedback. A review returns findings; it does not authorize rewriting project files or implementing the game.
  • Read the supplied brief and relevant project decisions before proposing changes. Find the current milestone and source of truth in project instructions; do not assume a repository or notes app always takes precedence.
  • Separate confirmed decisions, observed behavior, proposals, and assumptions. Do not silently turn an idea into approved canon or describe a planned feature as implemented.
  • Ask only for missing information that materially changes the result. Continue with explicit, reversible assumptions for routine choices.
  • Use the user's language and terminology. Explain unfamiliar design terms when they help the intended reader.

Choose the relevant guidance

Read only what the task needs:

  • Mechanics, combat, progression, economy, levels, or encounters: System design.
  • Hypotheses, prototype goals, playtest plans, or interpretation of playtest results: Playtesting.
  • Student assignments, rubrics, or mentor feedback: Teaching feedback.

Handle ordinary document work with the guidance below. These references are optional by task, not a checklist to append to every answer.

Start with the player's decisions

Establish the experience being promised, what the player does, what information they have, what they risk, and how the game communicates consequences. Describe a concrete example of play when abstract language hides missing rules.

Distinguish an action sequence from an interesting decision. A repeatable loop needs reasons to choose and continue; repetition alone does not establish depth or enjoyment. For games centered on expression, story, or contemplation, evaluate those experiences rather than forcing combat or reward loops onto them.

When exploring alternatives, compare the few that materially differ in player experience, production cost, or uncertainty. Recommend one with reasons and a way to test its weakest assumption. Do not produce alternatives merely to fill a quota.

Match the artifact to its job

Follow the user's course, publisher, team, or document template when provided. These are useful boundaries, not universal industry definitions:

ArtifactMain jobUseful content
ConceptExplain what the game is and why someone would playPitch, audience, platform, player activities, hook, key mechanics, references, intended scope
VisionGuide choices about the intended experiencePlayer fantasy, emotions, tone, design pillars with consequences, aesthetic direction, boundaries
GDDDefine how the game worksRules, states, interactions, content, UI feedback, progression, tuning, exceptions, unresolved dependencies
Feature specMake one feature implementable and verifiableGoal, rules, inputs, outcomes, edge cases, dependencies, acceptance scenarios
PitchExplain the opportunity to an external readerPlayer promise, differentiation, evidence, current stage, delivery plan, material risks, requested support

Keep product intent separate from engine architecture, file paths, and agent instructions unless the user requests a hybrid. Describe player-facing rules precisely enough to guide implementation without prescribing unnecessary code structure.

Link to shared definitions rather than maintaining competing copies. Some overlap is useful for standalone readability: remove duplicated rules and contradictory claims, not every repeated sentence. Do not create a full document suite for a small mechanic change.

For external documents, state uncertainty plainly and distinguish current capabilities from plans. Verify market claims, competitor details, and numerical comparisons with current sources when those claims are needed; do not invent traction, budgets, or evidence of uniqueness.

Scope and evidence

  • Resolve the current milestone from the project. A prototype tests a question; a vertical slice demonstrates a representative experience. Neither term automatically prescribes a fixed feature list.
  • Identify the smallest playable or otherwise observable test of the main uncertainty. Preserve the requested ambition while separating essential scope from later possibilities.
  • Treat initial tuning values as hypotheses with units and rationale. Analytical consistency is useful evidence, but it does not prove the game is fun or balanced.
  • For a spec, describe observable acceptance scenarios: starting conditions, player action, expected outcome, and relevant failure or cancellation behavior.
  • Include controls, readability, and accessibility considerations where they affect the feature. Consider player count, session length, target devices, and audience without expanding into unrelated systems.

Review and handoff

Prioritize problems by their effect on the intended player experience, production decisions, or document purpose. Tie each finding to a passage or observed behavior, explain its consequence, and propose a concrete correction or test. Distinguish contradictions and missing rules from personal preferences.

Use only the checks appropriate to the task: a feature spec need not repeat the game's pitch, platform, and full audience section. Preserve the user's voice when rewriting. End with the decisions, unresolved material questions, or next test needed for the requested deliverable; do not claim an unplayed design has been validated.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.