patch-notes
Skill9 starsChanged 7 months agoMITView on GitHub
Generate player-facing patch notes from changelog. Friendly tone, organized by category, acknowledges community feedback.
13 other projects use a version of this.
Adopted by
Most recently taken up by
- chuanglibs/Claude-Code-Game-Studios-Codextheir own version, first seen Nov 15, 2026
- Donchitos/Claude-Code-Game-Studiostheir own version, first seen Nov 9, 2026
- striderZA/OpenCodeGameStudiostheir own version, first seen Nov 4, 2026
- venus2099/codex-game-studiostheir own version, first seen Oct 17, 2026
- scotidev/GameDevStudiotheir own version, first seen Oct 9, 2026
- HunLuanZhiZhu/Game-Studios-Plugintheir own version, first seen Oct 5, 2026
Other versions13 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 13
- Donchitos/Claude-Code-Game-Studios★ 39ksame name
- pixel-cellar/Claude-Code-Game-Studios★ 324same name
- striderZA/OpenCodeGameStudios★ 124same name
- cenconq25/claude-code-app-studio★ 40same name
- CoralGame/Claude-Code-Game-Studios★ 19same name
- dawn840705/codex-code-studios★ 17same name
- lilangMax/ClaudeCodeGameStudios★ 8same name
- hongyuanc/codex-game-studios★ 5same name
- chuanglibs/Claude-Code-Game-Studios-Codex★ 1same name
- dawn840705/claude-code-studios★ 1same name
3 more not listed
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 repository51 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- asset-auditSkill
- asset-from-imageSkill
- balance-checkSkill
- brainstormSkill
- bug-reportSkill
- changelogSkill
- code-reviewSkill
- datastore-reviewSkill
- design-reviewSkill
- design-systemSkill
- doctorSkill
- economy-auditSkill
- estimateSkill
- exploit-checkSkill
- gate-checkSkill
- gddSkill
- generate-assetSkill
- hotfixSkill
- launch-checklistSkill
- luau-lintSkill
- map-systemsSkill
- milestone-reviewSkill
- monetization-modelSkill
- onboardSkill
- perf-profileSkill
- project-stage-detectSkill
- prototypeSkill
- publish-reviewSkill
- release-checklistSkill
- remotes-auditSkill
- retention-analysisSkill
- retrospectiveSkill
- reverse-documentSkill
- scope-checkSkill
- sprint-planSkill
- startSkill
- studio-inspectSkill
- studio-screenshotSkill
- studio-testSkill
- team-combatSkill
- team-economySkill
- team-polishSkill
- team-releaseSkill
- team-uiSkill
- tech-debtSkill
- wiki-ingestSkill
- wiki-lintSkill
- wiki-querySkill
- wiki-seedSkill
- wiki-updateSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 12 edited versions we read keep these.
3
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
- Distinctive: line 32
Use categories with emojis (players love them, and Roblox's audience responds to visual punctuation):
- Distinctive: line 58
Enthusiastic but honest: Don't overpromise; don't undersell
- Distinctive: line 65
Length: Keep under 500 words (attention spans are short)
“Common” is measured: kept by at least 6 in 10 of the 12 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.
Files
/patch-notes — Player-Facing Patch Notes
Delegate to: community-manager (with writer for final polish)
Purpose
Patch notes are NOT a technical changelog. They're marketing and community communication. The audience is players, not developers.
Steps
1. Source Material
- Technical changelog (from
/changelog) - Design docs for new features
- Screenshots or videos of new content (if available)
- Community feedback that shaped changes (credit your community!)
2. Translation Rules
Convert technical language to player language:
| Technical | Player |
| "Fixed race condition in DataStore" | "Fixed a bug that sometimes lost items on disconnect" |
| "Refactored combat hit detection" | "Combat feels more responsive" |
| "Rebalanced weapon damage curves" | "Rebalanced weapons — see table below" |
| "Added rate limiting to remote" | (don't mention — it's invisible to players) |
3. Structure
Use categories with emojis (players love them, and Roblox's audience responds to visual punctuation):
# [Game Name] Update v[X.Y.Z] — [Theme Name]
## ✨ New Content
- **Feature Name**: Short description, 1-2 sentences. Include screenshot if possible.
## ⚔️ Balance Changes
- **Item Name**: What changed. "Buffed" or "Nerfed" framing.
## 🐛 Bug Fixes
- Fixed [player-facing description]
- Fixed [player-facing description] (thanks @PlayerName for the report!)
## 📋 Known Issues
- [Known issue players should know about] (being worked on)
## 🎁 Free Gift
- Log in this week to receive [reward]!
Thank you for playing! — [Studio]4. Tone Guidelines
- Friendly: Like talking to friends, not a corporate announcement
- Enthusiastic but honest: Don't overpromise; don't undersell
- Credit the community: Name contributors when possible
- Positive framing: "Improved" > "Fixed broken"
- Transparent: Admit mistakes, explain fixes
- Forward-looking: Tease what's coming next if appropriate
5. Platform Considerations
- Length: Keep under 500 words (attention spans are short)
- Images: Pair each new content item with an image if possible
- Roblox-specific: Mention in-game items by name, use Roblox terminology
- Social sharing: Structure so it can be tweeted/shared in chunks
6. Example Output
# MyGame Update v1.3 — The Winter Festival ❄️
## ✨ New Content
- **Winter Event**: Visit the new Winter Village for seasonal quests (ends Jan 15)
- **New Cosmetics**: Arctic Fox pet, Penguin companion, Snowflake Crown
- **New Mini-Game**: Snowball fight arena — compete in 4v4 matches!
## ⚔️ Balance Changes
- **Fire Sword**: Damage increased from 50 → 65 (you asked, we delivered!)
- **Dragon Boss**: HP reduced by 15% (was too tanky after last patch)
- **XP Boost**: Daily XP boost now stacks with 2x XP GamePass
## 🐛 Bug Fixes
- Fixed: Players occasionally lost inventory on disconnect (big thanks to @PlayerName for the detailed report!)
- Fixed: Shop prices sometimes displayed wrong
- Fixed: Daily reward occasionally not claiming
## 📋 Known Issues
- Some players report lag in the new arena — we're investigating
- If you find anything odd, report it in our Discord!
## 🎁 Free Gift
- Log in before Jan 10 to claim a free **Winter Gift Box** containing 100 gems!
Thank you for playing! We read every piece of feedback.
— FoG Studios7. Distribution
On approval, save to production/releases/patch-notes-<version>.md.
Offer to format for:
- Discord announcement
- In-game MOTD
- Twitter/X thread
- Roblox group announcement
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
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.

