game-design-docs
Installation
SKILL.md
Game Design Docs
Use this skill to create documents that help an AI game-building agent make consistent decisions across sessions. The document should be short enough to stay current and specific enough to constrain implementation.
Source Traceability
Primary source: The Art of Game Design: A Book of Lenses, Third Edition by Jesse Schell, especially chapter 27 on design documents and team communication. The workflow is transformed and paraphrased.
Supporting source: the rest of the game skill pack, which turns design lenses into implementable briefs.
Workflow
- Decide the document's job: alignment, implementation, content production, tuning, playtest, or memory.
- Keep stable intent separate from volatile implementation details.
- Capture decisions, rejected alternatives, open questions, and validation evidence.
- Link specs to code, data, assets, tests, and telemetry when possible.
- Update docs after design decisions, not after every small code edit.