skills.rest
TMHSDigital
TMHSDigitalCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

steam-achievement-designer

Designs Steam achievement definitions and generates VDF or JSON configs for Steamworks upload.

1|Updated Mar 26, 2026
Search Tags:#game development#config generation#steam#achievements#steamworks#steam api#vdf
One-click install
npx skills add https://github.com/TMHSDigital/Steam-Cursor-Plugin --skill steam-achievement-designer-tmhsdigital
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: steam-achievement-designer
Source: https://github.com/TMHSDigital/Steam-Cursor-Plugin/tree/main/skills/steam-achievement-designer
Command: npx skills add https://github.com/TMHSDigital/Steam-Cursor-Plugin --skill steam-achievement-designer-tmhsdigital

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Planning and formatting Steam achievements for Steamworks upload is error-prone: API names must follow strict conventions, icons must meet exact size requirements, and the VDF config format is tedious to write by hand. This Skill structures achievement definitions and generates ready-to-upload configuration files. ## Core Features & Use Cases - Structured Achievement Definitions: Defines each achievement with API name, display name, description, hidden flag, and icon paths following Steamworks conventions. - VDF and JSON Config Generation: Produces bulk-upload VDF files or JSON configs for Steamworks, plus unlock code snippets in C++, C# (Steamworks.NET), and GDScript (GodotSteam). - Validation and Design Guidance: Enforces naming conventions, character limits, 64x64 icon requirements, and flags spoiler achievements as hidden. - Use Case: A developer lists milestones for their platformer (beat world 1, collect all coins, speedrun under 2 hours) and receives a complete VDF config, hidden-flag recommendations for spoiler achievements, and per-achievement unlock code snippets. ## Quick Start Ask the assistant to design Steam achievements for your game by listing your gameplay milestones and your Steam App ID.

Frequently Asked Questions about steam-achievement-designer

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

FAQPage Schema
How do I create Steam achievements for my game?▼

Define each achievement with a unique API name (ACH_ prefix, uppercase, underscores), a display name under 64 characters, and a description under 128 characters. Then generate a VDF config file for bulk upload to Steamworks and call SetAchievement plus StoreStats in your game code.

What are the Steam achievement icon requirements?▼

Steam achievement icons must be JPG or PNG at exactly 64x64 pixels. Each achievement needs two versions: a color icon for the unlocked state and a gray icon for the locked state, with a consistent art style and no text.

Why is my Steam achievement not unlocking in game?▼

The most common cause is forgetting to call StoreStats after SetAchievement, which means progress is only saved locally and lost on restart. You must also call RequestCurrentStats once at startup before any Get or Set operations.

What naming conventions do Steam achievement API names require?▼

API names should use an ACH_ prefix with uppercase letters and underscores only, such as ACH_BEAT_BOSS_1. Spaces and special characters cause silent failures, and names must stay under 128 characters and never change after release.

Can I generate Steam achievement configs as JSON instead of VDF?▼

Yes, achievement definitions can be generated as JSON for tools or pipelines that prefer it, containing the same fields: apiname, displayName, description, hidden flag, and icon paths. VDF remains the format for Steamworks bulk upload.

Is there a limit on the number of Steam achievements per game?▼

Steam enforces a hard cap of roughly 5000 stat and achievement entries per app, though 100-300 achievements is typical. Plan your full achievement list before implementation since API names cannot change after release.

Related Skills

Explore More Software Engineering Skills→
BAIZ1DBAIZ1D

game-design

Define core gameplay loops and calibrate difficulty for flow state.

Community
Intermediate
punkfuncgamespunkfuncgames

steam-module

Integrate Steamworks features into Unity games via a cohesive service layer.

Official
Advanced
punkfuncgamespunkfuncgames

achievement-module

Manage and evaluate Unity game achievements with Steam synchronization.

Official
Advanced
AradotsoAradotso
4

claude-code-cli-terminal-assistant

Edit multiple files and manage Git workflows via Claude Code CLI.

Official
Advanced