Skip to content

Commit 3e86d88

Browse files
committed
v0.3.0 "Insights" - add 4 analytics and market research skills
New skills: - steam-review-analysis: sentiment breakdown, review bombing detection, update impact - steam-price-history: regional pricing, sale patterns, value scoring, dev pricing guidance - steam-market-research: genre trends, competitor ID, market gaps, viability assessment - steam-wishlist-estimates: Boxleiter method, conversion benchmarks, revenue projections Docs updated: plugin.json, CHANGELOG, README, CLAUDE.md, CONTRIBUTING, ROADMAP Made-with: Cursor
1 parent f8f1284 commit 3e86d88

10 files changed

Lines changed: 705 additions & 14 deletions

File tree

.cursor-plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
22
"name": "steam-cursor-plugin",
33
"displayName": "Steam Developer Tools",
4-
"version": "0.2.0",
5-
"description": "Integrates Steam and Steamworks APIs for game developers and power users. 14 skills covering store data, multiplayer networking, cloud saves, leaderboards, input, inventory, social features, profile lookups, and game comparisons - plus 4 rules for App ID validation, secrets detection, Steam Deck compatibility, and MCP tool preference. Companion Steam MCP server provides 10 live API tools.",
4+
"version": "0.3.0",
5+
"description": "Integrates Steam and Steamworks APIs for game developers and power users. 18 skills covering store data, multiplayer networking, cloud saves, leaderboards, input, inventory, social features, profile lookups, game comparisons, review analysis, price history, market research, and wishlist estimates - plus 4 rules for App ID validation, secrets detection, Steam Deck compatibility, and MCP tool preference. Companion Steam MCP server provides 10 live API tools.",
66
"author": {
77
"name": "TMHSDigital",
88
"url": "https://github.com/TMHSDigital"

CHANGELOG.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,26 @@ All notable changes to Steam Developer Tools will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [0.3.0] - 2026-03-27
9+
10+
### Added
11+
12+
- **steam-review-analysis** skill: fetch and analyze Steam game reviews - sentiment breakdown, common complaints, comparison across updates, language distribution, review bombing detection
13+
- **steam-price-history** skill: pricing trends, sale history, regional pricing analysis, price-to-review value scoring, pricing strategy guidance for developers
14+
- **steam-market-research** skill: genre trend analysis, tag popularity, competitor identification, market gap analysis, viability assessment using Steam store data
15+
- **steam-wishlist-estimates** skill: estimate wishlists from follower counts and review data using the Boxleiter method, wishlist-to-sales conversion benchmarks, revenue estimation
16+
17+
### Changed
18+
19+
- Plugin version bumped to 0.3.0
20+
- Plugin description updated to reflect 18 skills
21+
- All documentation updated: README, CLAUDE.md, CONTRIBUTING.md, ROADMAP.md
22+
23+
### MCP Roadmap
24+
25+
- `steam.getReviews({ appid, filter, language, count })` - planned for MCP server v0.3.0 (review analysis skill uses curl fallback until available)
26+
- `steam.getPriceOverview({ appids, cc })` - planned for MCP server v0.3.0 (price history skill uses getAppDetails with cc parameter until available)
27+
828
## [0.2.0] - 2026-03-27
929

1030
### Added
@@ -43,5 +63,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
4363
- **steam-deck-compat** rule: flags common Steam Deck compatibility issues (hardcoded resolutions, mouse-only input, anti-cheat, Windows-only paths, missing controller support)
4464
- Plugin manifest, README, CONTRIBUTING guide, and license
4565

66+
[0.3.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.3.0
4667
[0.2.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.2.0
4768
[0.1.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.1.0

CLAUDE.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
44

55
## Project Overview
66

7-
**Steam Developer Tools** is a Cursor IDE plugin (v0.2.0) that integrates Steam and Steamworks APIs for game developers and power users. It provides AI-assisted workflows for querying Steam store data, managing Steamworks configurations, building multiplayer networking, implementing cloud saves, leaderboards, input, inventory/economy, social features, looking up API docs, fetching player statistics, integrating Workshop UGC, designing achievements, looking up player profiles, and comparing games.
7+
**Steam Developer Tools** is a Cursor IDE plugin (v0.3.0) that integrates Steam and Steamworks APIs for game developers and power users. It provides AI-assisted workflows for querying Steam store data, managing Steamworks configurations, building multiplayer networking, implementing cloud saves, leaderboards, input, inventory/economy, social features, looking up API docs, fetching player statistics, integrating Workshop UGC, designing achievements, looking up player profiles, comparing games, analyzing reviews, researching pricing, evaluating market fit, and estimating wishlists.
88

99
This plugin uses Markdown skill files and MDC rule files for AI guidance, paired with the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) (separate repo) which provides 10 read-only API tools for live data access. No build system, no npm, no compiled code in this repo.
1010

11-
The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next major milestone (v0.3.0 "Insights") adds analytics and market research skills. Subsequent releases add CI/CD automation (v0.4.0), community/monetization skills (v0.5.0), QA rules (v0.6.0), MCP write operations (v0.7.0), and polish (v0.8.0). Target at v1.0.0: 30 skills, 9 rules, 20 MCP tools.
11+
The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next major milestone (v0.4.0 "Ship It") adds CI/CD automation and build pipeline skills. Subsequent releases add community/monetization skills (v0.5.0), QA rules (v0.6.0), MCP write operations (v0.7.0), and polish (v0.8.0). Target at v1.0.0: 30 skills, 9 rules, 20 MCP tools.
1212

1313
## Plugin Architecture
1414

@@ -18,7 +18,7 @@ skills/<skill-name>/SKILL.md - AI workflow definitions (one per skill)
1818
rules/<rule-name>.mdc - Code quality and security rules (applied by Cursor AI)
1919
```
2020

21-
### Skills (14 total)
21+
### Skills (18 total)
2222

2323
Each `SKILL.md` uses YAML frontmatter followed by markdown sections: **Trigger**, **Required Inputs**, **Workflow**, and **Example**.
2424

@@ -38,6 +38,10 @@ Each `SKILL.md` uses YAML frontmatter followed by markdown sections: **Trigger**
3838
| `steam-inventory-economy` | Item schema, drops, crafting, microtransactions, Steam Item Store |
3939
| `steam-profile-lookup` | Resolve vanity URLs, fetch player summaries, owned games, level/badges |
4040
| `steam-game-comparison` | Side-by-side comparison of price, reviews, player counts, genres |
41+
| `steam-review-analysis` | Fetch and analyze game reviews: sentiment, complaints, review bombing |
42+
| `steam-price-history` | Pricing trends, sale history, regional pricing, value scoring |
43+
| `steam-market-research` | Genre trends, tag popularity, competitor ID, market gap analysis |
44+
| `steam-wishlist-estimates` | Estimate wishlists from public signals, conversion benchmarks |
4145

4246
### Rules (4 total)
4347

CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,12 @@ Cursor will pick up changes to skills and rules without restarting.
3636

3737
## Plugin Structure
3838

39-
The plugin currently has **14 skills** and **4 rules**.
39+
The plugin currently has **18 skills** and **4 rules**.
4040

4141
```
4242
.cursor-plugin/
4343
plugin.json # Plugin manifest (name, version, metadata)
44-
skills/ # 14 skill directories
44+
skills/ # 18 skill directories
4545
<skill-name>/
4646
SKILL.md # Skill definition with frontmatter + instructions
4747
rules/ # 4 rule files

README.md

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
<p align="center">
1212
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Steam-Cursor-Plugin/validate.yml?label=CI" alt="CI"></a>
1313
<a href="LICENSE"><img src="https://img.shields.io/badge/license-CC--BY--NC--ND--4.0-blue.svg" alt="License: CC BY-NC-ND 4.0"></a>
14-
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.2.0-green.svg" alt="Version"></a>
14+
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.3.0-green.svg" alt="Version"></a>
1515
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/stargazers"><img src="https://img.shields.io/github/stars/TMHSDigital/Steam-Cursor-Plugin?style=flat" alt="GitHub Stars"></a>
1616
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/commits/main"><img src="https://img.shields.io/github/last-commit/TMHSDigital/Steam-Cursor-Plugin" alt="Last Commit"></a>
1717
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin"><img src="https://img.shields.io/badge/Cursor-Plugin-8B5CF6.svg" alt="Cursor Plugin"></a>
@@ -22,7 +22,7 @@
2222
---
2323

2424
<p align="center">
25-
<strong>14 skills</strong> &nbsp;&bull;&nbsp; <strong>4 rules</strong> &nbsp;&bull;&nbsp; <strong>10 MCP tools</strong>
25+
<strong>18 skills</strong> &nbsp;&bull;&nbsp; <strong>4 rules</strong> &nbsp;&bull;&nbsp; <strong>10 MCP tools</strong>
2626
</p>
2727

2828
Query Steam store data, manage Steamworks app configurations, build multiplayer networking, implement cloud saves, design achievements, compare games, and look up player profiles - all from within Cursor's AI chat. Covers the full Steam &amp; Steamworks ecosystem with live data via the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp).
@@ -64,6 +64,10 @@ flowchart LR
6464
| **Steam Inventory & Economy** | Implement item systems, drops, crafting, the Steam Item Store, and in-game purchases via ISteamInventory and ISteamMicroTxn. |
6565
| **Steam Profile Lookup** | Look up any Steam user's public profile - games, playtime, level, badges, friends, and recent activity. |
6666
| **Steam Game Comparison** | Compare two or more Steam games side by side - price, reviews, player counts, genres, and platforms in a formatted table. |
67+
| **Steam Review Analysis** | Fetch and analyze game reviews - sentiment breakdown, common complaints, comparison across updates, and review bombing detection. |
68+
| **Steam Price History** | Pricing trends, sale history, regional pricing analysis, and price-to-value scoring for any Steam game. |
69+
| **Steam Market Research** | Genre trend analysis, tag popularity, competitor identification, and market gap analysis using Steam store data. |
70+
| **Steam Wishlist Estimates** | Estimate wishlists from public signals using the Boxleiter method, with conversion rate benchmarks and revenue projections. |
6771

6872
### Rules
6973

@@ -160,7 +164,7 @@ Compare Hades, Dead Cells, and Hollow Knight - price, reviews, and current playe
160164
```
161165

162166
<details>
163-
<summary><strong>More examples (all 14 skills)</strong></summary>
167+
<summary><strong>More examples (all 18 skills)</strong></summary>
164168

165169
**Store Lookup**
166170
```
@@ -232,6 +236,26 @@ Look up the Steam profile for vanity URL "gaben"
232236
Compare App IDs 570 and 730 side by side.
233237
```
234238

239+
**Review Analysis**
240+
```
241+
Analyze recent reviews for Baldur's Gate 3. Are players happy with the latest patches?
242+
```
243+
244+
**Price History**
245+
```
246+
What's the pricing history for Hades? Is it a good deal right now?
247+
```
248+
249+
**Market Research**
250+
```
251+
I'm thinking about making a cozy farming sim. Is the market too saturated?
252+
```
253+
254+
**Wishlist Estimates**
255+
```
256+
My game has 25,000 wishlists two weeks before launch. What should I expect for sales?
257+
```
258+
235259
</details>
236260

237261
## Configuration
@@ -282,7 +306,7 @@ See [ROADMAP.md](ROADMAP.md) for the full themed release plan (v0.2.0 through v1
282306
| Version | Theme | Highlights |
283307
|---------|-------|------------|
284308
| **v0.2.0** | Live Data | Steam MCP server with 10 read-only tools, skill updates |
285-
| **v0.3.0** | Insights | Review analysis, price history, market research, wishlist estimates |
309+
| **v0.3.0 (current)** | Insights | Review analysis, price history, market research, wishlist estimates |
286310
| **v0.4.0** | Ship It | CI/CD automation, release checklist, steamcmd helper, build validation rules |
287311
| **v0.5.0** | Grow | Community management, store page optimization, pricing strategy, DLC planning |
288312
| **v0.6.0** | Quality | Playtest setup, anti-cheat integration, save compat / network security / error handling rules |

ROADMAP.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22

33
Themed release plan toward v1.0.0.
44

5-
**Current:** v0.2.0 - 14 skills, 4 rules, companion [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) with 10 read-only tools.
5+
**Current:** v0.3.0 - 18 skills, 4 rules, companion [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) with 10 read-only tools.
66

77
**Target:** v1.0.0 - 30 skills, 9 rules, 20 MCP tools.
88

99
| Version | Theme | New Skills | New Rules | MCP Tools | Total Skills | Total Rules |
1010
|---------|-------|-----------|-----------|-----------|-------------|-------------|
1111
| v0.1.0 | - | - | - | 0 | 14 | 3 |
12-
| v0.2.0 (current) | Live Data | 0 (updates) | 1 | 10 | 14 | 4 |
13-
| v0.3.0 | Insights | 4 | 0 | 2 | 18 | 4 |
12+
| v0.2.0 | Live Data | 0 (updates) | 1 | 10 | 14 | 4 |
13+
| v0.3.0 (current) | Insights | 4 | 0 | 2 | 18 | 4 |
1414
| v0.4.0 | Ship It | 3 | 2 | 0 | 21 | 6 |
1515
| v0.5.0 | Grow | 4 | 0 | 2 | 25 | 6 |
1616
| v0.6.0 | Quality | 3 | 3 | 0 | 28 | 9 |
@@ -214,3 +214,7 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
214214
- [x] ~~Steamworks SDK code generation~~ - covered by multiplayer, cloud, leaderboard, input, and inventory skills
215215
- [x] ~~Steam MCP server with 10 read-only tools~~ - companion repo [steam-mcp](https://github.com/TMHSDigital/steam-mcp), skills updated in v0.2.0
216216
- [x] ~~MCP tool preference rule~~ - `steam-api-key-usage.mdc` added in v0.2.0
217+
- [x] ~~Review analysis skill~~ - `steam-review-analysis` added in v0.3.0
218+
- [x] ~~Price history skill~~ - `steam-price-history` added in v0.3.0
219+
- [x] ~~Market research skill~~ - `steam-market-research` added in v0.3.0
220+
- [x] ~~Wishlist estimates skill~~ - `steam-wishlist-estimates` added in v0.3.0
Lines changed: 161 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,161 @@
1+
---
2+
name: steam-market-research
3+
description: Genre trend analysis, tag popularity, competitor identification, and market gap analysis using Steam store data. Use when evaluating a game concept's market fit, scouting competitors, or analyzing genre saturation.
4+
---
5+
6+
# Steam Market Research
7+
8+
## Trigger
9+
10+
Use this skill when the user:
11+
12+
- Wants to analyze a genre or tag's popularity on Steam
13+
- Needs to identify competitors for a game concept
14+
- Asks about market gaps or underserved niches
15+
- Wants to evaluate a game idea's viability
16+
- Needs data on release volume, review benchmarks, or pricing tiers within a genre
17+
- Asks "what's selling well" in a category
18+
19+
## Required Inputs
20+
21+
- **Genre, tag, or game concept** - the market segment to research
22+
- **Comparison scope** (optional) - number of competitors, time period, price range
23+
24+
## Workflow
25+
26+
> **Preferred:** If the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is available, use MCP tools. See [MCP Usage](#mcp-usage).
27+
28+
### 1. Define the Market Segment
29+
30+
Clarify the scope with the user:
31+
32+
- **Genre tags**: roguelike, metroidvania, city-builder, souls-like, etc.
33+
- **Theme tags**: pixel-art, cozy, horror, sci-fi
34+
- **Mechanics tags**: deck-building, turn-based, co-op, open-world
35+
- **Intersection**: e.g., "roguelike deck-builder" or "cozy farming sim"
36+
37+
### 2. Search for Competitors
38+
39+
```bash
40+
# Search by genre/tag keywords
41+
curl.exe "https://store.steampowered.com/api/storesearch/?term={genre_keyword}&l=english&cc=us"
42+
```
43+
44+
For broader market data, use the Steam search page with tag filtering:
45+
- `https://store.steampowered.com/search/?tags={tag_id}&sort_by=Reviews_DESC`
46+
- Common tag IDs: Roguelike (1716), Metroidvania (9551), City Builder (1643), Souls-like (29482)
47+
48+
### 3. Gather Competitor Data
49+
50+
For each top competitor (aim for 8-15 games), fetch details:
51+
52+
```bash
53+
curl.exe "https://store.steampowered.com/api/appdetails?appids={appid}"
54+
```
55+
56+
Collect per game:
57+
58+
| Field | Source |
59+
|-------|--------|
60+
| Name, release date | `appdetails` |
61+
| Price | `appdetails → price_overview` |
62+
| Review count & score | `appdetails → recommendations` |
63+
| Tags/genres | `appdetails → genres`, `categories` |
64+
| Current players | `GetNumberOfCurrentPlayers` |
65+
| Developer/publisher | `appdetails → developers` |
66+
67+
### 4. Analyze the Market
68+
69+
Present findings in these categories:
70+
71+
**Market Size & Health**
72+
- Total games in segment (estimate from search results)
73+
- Distribution of review scores (what % are Positive or better?)
74+
- Median review count (proxy for visibility/sales)
75+
76+
**Pricing Landscape**
77+
- Price distribution: Free, <$10, $10-20, $20-30, $30+
78+
- Median price for the genre
79+
- Correlation between price and review score
80+
81+
**Competitive Density**
82+
- Release frequency: how many new games in this segment per month?
83+
- Market leaders: top 5 by review count
84+
- Recent successes: top 5 from last 12 months
85+
86+
**Market Gaps**
87+
- Tag combinations with few entries but strong performers
88+
- Underserved platforms (Linux, Steam Deck)
89+
- Missing features common in adjacent genres
90+
91+
### 5. Format Output
92+
93+
> **Market Research: Roguelike Deck-Builders**
94+
>
95+
> **Segment size:** ~85 games tagged roguelike + deck-building
96+
> **Market leaders:**
97+
>
98+
> | Game | Reviews | Score | Price | Players |
99+
> |------|---------|-------|-------|---------|
100+
> | Slay the Spire | 142K | 97% | $24.99 | 8,200 |
101+
> | Monster Train | 18K | 92% | $24.99 | 1,100 |
102+
> | Inscryption | 65K | 96% | $19.99 | 2,400 |
103+
> | Balatro | 98K | 97% | $14.99 | 12,000 |
104+
>
105+
> **Pricing:** Median $14.99, range $4.99-$24.99
106+
> **Gap opportunities:** roguelike deck-builder with co-op (only 3 exist), horror-themed deck-builder (1 exists)
107+
> **Risk:** High competitive density, strong incumbents. Differentiation is critical.
108+
109+
### 6. Viability Assessment
110+
111+
Score the market opportunity:
112+
113+
| Factor | Weight | Score (1-5) |
114+
|--------|--------|-------------|
115+
| Market demand (search volume, wishlist signals) | 25% ||
116+
| Competitive density | 25% ||
117+
| Differentiation potential | 20% ||
118+
| Price ceiling | 15% ||
119+
| Audience crossover potential | 15% ||
120+
121+
Provide an overall recommendation: **Strong**, **Moderate**, **Cautious**, or **Avoid**.
122+
123+
## Key References
124+
125+
| Resource | URL |
126+
|----------|-----|
127+
| Steamworks Tags | https://partner.steamgames.com/doc/store/tags |
128+
| Steam Search API | https://store.steampowered.com/search/ |
129+
| Steam Spy (estimates) | https://steamspy.com/ |
130+
| Game Discover Co | https://gamediscover.co/ |
131+
| VG Insights | https://vginsights.com/ |
132+
133+
## Example Interaction
134+
135+
**User:** "I'm thinking about making a cozy farming sim. Is the market too saturated?"
136+
137+
**Agent:**
138+
1. Identifies key tags: farming simulation, cozy, life sim
139+
2. Searches Steam for games with those tags
140+
3. Fetches details for top 15 results
141+
4. Analyzes: 120+ farming sims, but only ~15 with >5K reviews
142+
5. Notes Stardew Valley dominance (500K+ reviews) but also recent successes (Sun Haven, Coral Island)
143+
6. Identifies gaps: farming + crafting automation, farming + mystery/detective
144+
7. Verdict: "Moderate opportunity. Market is large but well-served. Strong differentiation or unique hook required. Price ceiling $24.99."
145+
146+
## MCP Usage
147+
148+
| Step | MCP Tool | Auth | Replaces |
149+
|------|----------|------|----------|
150+
| Search for games | `steam.searchApps({ term })` | None | `curl` to `storesearch` |
151+
| Get game details | `steam.getAppDetails({ appid })` | None | `curl` to `appdetails` |
152+
| Player counts | `steam.getPlayerCount({ appid })` | None | `curl` to `GetNumberOfCurrentPlayers` |
153+
154+
All required MCP tools are already available. No new MCP tools needed for this skill.
155+
156+
## See Also
157+
158+
- [Steam Store Lookup](../steam-store-lookup/SKILL.md) - resolve names and get store data
159+
- [Steam Price History](../steam-price-history/SKILL.md) - pricing analysis for competitors
160+
- [Steam Game Comparison](../steam-game-comparison/SKILL.md) - detailed side-by-side competitor comparison
161+
- [Steam Wishlist Estimates](../steam-wishlist-estimates/SKILL.md) - estimate demand from public signals

0 commit comments

Comments
 (0)