Playtest Report

Turns raw playtest notes into structured reports or generates a blank template to standardize feedback collection. It reads your notes, cross-references design docs, then buckets findings into design changes, balance tweaks, bugs, and polish items. The routing is smart: it tells you to run propagate-design-change for mechanics issues or balance-check before tuning numbers. Includes a creative director gate that reviews whether findings align with your game pillars and core fantasy. The template itself is thorough, covering everything from first impressions to quantitative data and top priorities. If your playtests currently live in scattered Google Docs or Discord messages, this gives you a repeatable structure and automatically flags what needs attention first.

skills.sh installs: 760
GitHub stars: 37.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add donchitos/claude-code-game-studios --skill playtest-report --agent claude-code

Installs into .claude/skills of the current project.

Files

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys review_mode,automation

Resolved above — use as-is; --review overrides review_mode for this run. No block → defaults in .claude/docs/config-resolution.md.

Playtest Report

Phase 1: Parse Arguments

See .claude/docs/director-gates.md for the full check pattern. Individual gate definitions live in .claude/docs/director-gates/[gate-id].md — the spawned agent reads its own gate file; do not read it in the parent session.

Every AskUserQuestion call follows .claude/docs/automation-modes.md (collaborative asks always · guided major-only · autonomous logs and proceeds; automation_always_ask categories always prompt).

Determine the mode:

new → generate a blank playtest report template. This mode ends after Phase 2A: a blank template has nothing to route, review or save.
analyze [path] → read raw notes and fill in the template with structured findings
No argument → ask via AskUserQuestion: [A] New blank template / [B] Analyze notes — I'll give you the path