This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Steam Developer Tools is a Cursor IDE plugin (v1.0.0) that integrates Steam and Steamworks APIs for game developers, modders, 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, estimating wishlists, automating builds, validating release readiness, scripting steamcmd, managing communities, optimizing store pages, planning pricing strategy, configuring DLC, setting up playtests, creating bug report workflows, integrating anti-cheat, providing a testing sandbox, and guiding platform migration.
This plugin uses Markdown skill files and MDC rule files for AI guidance, paired with the companion Steam MCP Server (separate repo) which provides 25 API tools (18 read-only + 7 write/guidance) for live data access. No build system, no npm, no compiled code in this repo.
The project is on a themed release roadmap toward v1.0.0 (see ROADMAP.md). The current release is v1.0.0 "Stable" — the production release. 30 skills, 9 rules, 25 MCP tools.
.cursor-plugin/plugin.json - Plugin manifest (name, version, skills/rules directory pointers)
skills/<skill-name>/SKILL.md - AI workflow definitions (one per skill)
rules/<rule-name>.mdc - Code quality and security rules (applied by Cursor AI)
Each SKILL.md uses YAML frontmatter followed by markdown sections: Trigger, Required Inputs, Workflow, and Example.
| Skill | Purpose |
|---|---|
steam-store-lookup |
Look up games/apps by name or App ID via Steam Store API |
steamworks-app-config |
Generate depot VDF configs, build pipelines, DLC setup |
steam-api-reference |
Search and present Steam Web API / Steamworks SDK docs |
steam-player-stats |
Query player counts, achievement rates, leaderboards, libraries |
steam-workshop-helper |
Look up Workshop items and document UGC integration patterns |
steam-achievement-designer |
Design achievements, generate VDF/JSON configs, provide unlock code |
steam-multiplayer-networking |
Lobby creation, matchmaking, Steam Networking Sockets, dedicated servers |
steam-cloud-saves |
ISteamRemoteStorage manual cloud and Auto-Cloud configuration |
steam-leaderboards |
Create/query leaderboards, upload scores, download entries |
steam-friends-social |
Friends list, rich presence, game invites, overlay, avatars |
steam-input-controller |
ISteamInput action sets, bindings, controller glyph retrieval |
steam-inventory-economy |
Item schema, drops, crafting, microtransactions, Steam Item Store |
steam-profile-lookup |
Resolve vanity URLs, fetch player summaries, owned games, level/badges |
steam-game-comparison |
Side-by-side comparison of price, reviews, player counts, genres |
steam-review-analysis |
Fetch and analyze game reviews: sentiment, complaints, review bombing |
steam-price-history |
Pricing trends, sale history, regional pricing, value scoring |
steam-market-research |
Genre trends, tag popularity, competitor ID, market gap analysis |
steam-wishlist-estimates |
Estimate wishlists from public signals, conversion benchmarks |
steam-build-automation |
SteamPipe CI/CD: GitHub Actions, GitLab CI, Jenkins, Docker builds |
steam-release-checklist |
Pre-release validation: store page, depots, achievements, pricing, Deck |
steam-steamcmd-helper |
steamcmd scripting reference, commands, Docker, troubleshooting |
steam-community-management |
Announcements, events, forums, update templates, Community Hub |
steam-store-page-optimizer |
Capsule images, descriptions, tags, trailers, demos, screenshots |
steam-pricing-strategy |
Base pricing, regional pricing, discounts, sales, bundles, F2P |
steam-dlc-expansion-planning |
DLC setup, season passes, content cadence, pricing tiers |
steam-playtest-setup |
Steam Playtest config, open/closed playtests, key distribution |
steam-bug-report-template |
Bug report templates, crash dumps, system info, known issues |
steam-anticheat-integration |
EAC, BattlEye, VAC setup, Proton/Deck compatibility |
steam-testing-sandbox |
App ID 480 sandbox, test accounts, console commands, dev workflow |
steam-migration-guide |
Platform migration (Epic/GOG/itch.io to Steam), engine SDK integration |
| Rule | Scope | Purpose |
|---|---|---|
steam-appid-validation.mdc |
steam_appid.txt, *.vdf, steamcmd configs |
Enforces App ID consistency; warns if 480 (SpaceWar test) is used in production |
steamworks-secrets.mdc |
Global (all files) | Flags Steam API keys (32-char hex), ssfn files, publisher credentials, DRM keys |
steam-deck-compat.mdc |
*.cpp, *.h, *.hpp, *.cs, *.gd, *.vdf, *.cfg, *.ini, *.json |
Flags Steam Deck compat issues: hardcoded resolutions, mouse-only input, anti-cheat, Windows paths |
steam-api-key-usage.mdc |
*.sh, *.ps1, *.py, *.js, *.ts, *.yml, *.yaml |
Flags raw curl/fetch to Steam APIs when MCP tools are available; suggests equivalent MCP tool |
steam-build-config-validation.mdc |
*.vdf, *build*, *depot* |
Validates VDF build configs: missing depots, mismatched App IDs, invalid file mappings |
steam-launch-options-check.mdc |
*.vdf, *launch*, *config*.json, *config*.cfg |
Flags launch option issues: missing executables, wrong OS targeting, missing descriptions |
steam-save-compat.mdc |
*.cpp, *.h, *.hpp, *.cs, *.gd, *.json, *.cfg |
Flags save practices breaking cross-platform cloud sync: endianness, paths, serialization |
steam-network-security.mdc |
*.cpp, *.h, *.hpp, *.cs, *.gd |
Flags insecure networking: unvalidated auth tickets, trusting client data, missing encryption |
steam-api-error-handling.mdc |
*.cpp, *.h, *.hpp, *.cs, *.gd |
Flags missing Steamworks error handling: unchecked init, missing StoreStats, ignored callbacks |
The Steam MCP Server provides 25 tools (17 read-only + 8 write/guidance). Skills reference these tools in their ## MCP Usage sections. When the MCP server is configured in Cursor, skills prefer MCP tool calls over shell curl commands.
| MCP Tool | Auth | Maps to |
|---|---|---|
steam_getAppDetails({ appid }) |
None | Store API appdetails |
steam_searchApps({ query }) |
None | Store API storesearch |
steam_getPlayerCount({ appid }) |
None | GetNumberOfCurrentPlayers |
steam_getAchievementStats({ appid }) |
None | GetGlobalAchievementPercentagesForApp |
steam_getWorkshopItem({ publishedfileid }) |
None | GetPublishedFileDetails |
steam_getReviews({ appid, filter, language }) |
None | Store API appreviews |
steam_getPriceOverview({ appids, cc }) |
None | Store API appdetails (price filter) |
steam_getAppReviewSummary({ appid }) |
None | Store API appreviews (summary only) |
steam_getRegionalPricing({ appid, countries }) |
None | Store API appdetails (multi-region) |
steam_getNewsForApp({ appid, count?, maxlength? }) |
None | ISteamNews/GetNewsForApp |
steam_getPlayerSummary({ steamid }) |
Key | GetPlayerSummaries |
steam_getOwnedGames({ steamid }) |
Key | GetOwnedGames |
steam_queryWorkshop({ appid }) |
Key | IPublishedFileService/QueryFiles |
steam_getLeaderboardEntries({ appid, leaderboardid }) |
Key | ISteamLeaderboards/GetLeaderboardEntries |
steam_resolveVanityURL({ vanityurl }) |
Key | ResolveVanityURL |
steam_getSchemaForGame({ appid }) |
Key | ISteamUserStats/GetSchemaForGame |
steam_getPlayerAchievements({ steamid, appid }) |
Key | ISteamUserStats/GetPlayerAchievements |
steam_getLeaderboardsForGame({ appid }) |
Key | ISteamLeaderboards/GetLeaderboardsForGame |
steam_createLobby({ type, max_members, metadata }) |
SDK guide | ISteamMatchmaking code examples |
steam_uploadWorkshopItem({ appid, title, ... }) |
SDK guide | ISteamUGC upload code examples |
steam_updateWorkshopItem({ publishedfileid, ... }) |
Publisher key | IPublishedFileService/UpdateDetails |
steam_setAchievement({ steamid, appid, achievement }) |
Publisher key | ISteamUserStats/SetUserStatsForGame |
steam_clearAchievement({ steamid, appid, achievement }) |
Publisher key | ISteamUserStats/SetUserStatsForGame (value 0) |
steam_uploadLeaderboardScore({ appid, leaderboardid, ... }) |
Publisher key | ISteamLeaderboards/SetLeaderboardScore |
steam_grantInventoryItem({ appid, steamid, itemdefid }) |
Publisher key | IInventoryService/AddItem |
No build step required. Changes to skills/ and rules/ are picked up by Cursor automatically.
Local testing - symlink the plugin directory:
Windows (PowerShell as Admin):
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.cursor\plugins\local\steam-cursor-plugin" -Target (Get-Location)Unix/macOS (bash):
ln -s "$(pwd)" ~/.cursor/plugins/local/steam-cursor-plugin- Skill API names:
ACH_prefix, uppercase with underscores (e.g.ACH_BEAT_FINAL_BOSS). Stable after release. - Depot ID pattern:
appid + N(e.g., App ID2345678→ depots2345679(Win),2345680(macOS),2345681(Linux)) - Steam API key: Never hardcode. Use the
STEAM_API_KEYenvironment variable or a.envfile (already in.gitignore). - App ID
480(SpaceWar) is the Steam SDK test app - thesteam-appid-validationrule warns if it appears in production contexts. - Secrets rule flags: 32-char hex strings near "steam"/"api",
*.ssfnfiles,config.vdf, steamcmd login lines, CEG/DRM keys.
| Endpoint | Auth |
|---|---|
ISteamApps/GetAppList/v2/ |
None |
store.steampowered.com/api/appdetails?appids={id} |
None |
ISteamUserStats/GetNumberOfCurrentPlayers/v1/ |
None |
ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/ |
None |
ISteamUserStats/GetPlayerAchievements/v1/ |
API key |
IPlayerService/GetOwnedGames/v1/ |
API key |
ISteamUser/ResolveVanityURL/v1/ |
API key |
ISteamUser/GetPlayerSummaries/v2/ |
API key |
IPlayerService/GetBadges/v1/ |
API key |
IPlayerService/GetRecentlyPlayedGames/v1/ |
API key |
IPlayerService/GetSteamLevel/v1/ |
API key |
ISteamUser/GetFriendList/v1/ |
API key |
ISteamLeaderboards/GetLeaderboardEntries/v1/ |
API key |
IInventoryService/GetInventory/v1/ |
API key |
| Publisher/partner endpoints | API key + IP allowlist |
Regional pricing: append &cc={country}&l={language} to store API calls.