game-design-analyzer

Generate expert game design analysis reports from Steam URLs or JSON inputs.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/godavidgpg/game-design-analyzer-upstage --skill game-design-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: game-design-analyzer
Source: https://github.com/godavidgpg/game-design-analyzer-upstage/tree/main
Command: npx skills add https://github.com/godavidgpg/game-design-analyzer-upstage --skill game-design-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai, requests, python-docx, fpdf2, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill turns a game name or Steam URL into a structured, expert-level game design analysis report, saving you the time of manually collecting Steam info and translating it into MDA, fun patterns, emotions, accessibility, and competitor positioning.

Core Features & Use Cases

  • Steam data collection + review patterning: Pulls core game info from Steam and summarizes player sentiment from recent reviews.
  • Expert framework analysis (6 perspectives): Produces analysis using Jesse Schell, Raph Koster, MDA, Tynan Sylvester, Shigeru Miyamoto, and Hidetaka Miyazaki frameworks.
  • Designer-vs-player gap + competitor comparison: When requested, adds intent vs experience gaps and embeds competitors to quantify similarity and positioning.
  • Multi-format report outputs: Generates report files as DOCX, PDF, MD, or JSON depending on your chosen output extension.

Quick Start

Call the game-design-analyzer skill with the request “/game-design-analyzer Hollow Knight” to generate a report for Hollow Knight.

Frequently Asked Questions about game-design-analyzer

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

FAQPage Schema
How do I generate a game design analysis report from a Steam URL?

To generate a game design analysis report, input a game name or Steam URL to trigger automated Steam API data collection, review summarization, and multi-framework expert analysis. The skill outputs the final structured report directly to DOCX, PDF, MD, or JSON files.

Can I benchmark competitor games using Steam review data and embeddings?

Yes, competitor benchmarking is supported by calculating embedding similarity to quantify game positioning. The analysis uses Solar Embedding APIs to compare your target game against competitors and includes this positioning data within the generated design report.

What game design frameworks are used for analyzing Steam games?

Game design analysis uses six expert frameworks: Jesse Schell, Raph Koster, MDA, Tynan Sylvester, Shigeru Miyamoto, and Hidetaka Miyazaki. These perspectives evaluate mechanics, dynamics, aesthetics, and player experience patterns extracted from Steam data.

Do I need an API key to analyze Steam reviews and generate DOCX reports?

Yes, you must configure a UPSTAGE_API_KEY environment variable to run the analysis. The skill relies on Upstage Solar Pro 3 and Solar Embedding APIs for processing Steam review patterns and generating multi-format documents like DOCX or PDF.

Can I identify gaps between designer intent and player experience in Steam reviews?

Yes, you can request an optional intent-versus-experience gap analysis. This feature processes Steam review patterns to identify mismatches between what designers intended and what players actually reported experiencing in the final report.

What is the best way to export MDA framework analysis results for a game?

The best way to export MDA framework analysis is by specifying your desired output path and file extension. The skill directly generates and saves the final report as DOCX, PDF, MD, or JSON formats using python-docx and fpdf2 libraries.