Skills

Playtest Report

Structured playtest report template, or turn existing playtest notes into structured...

Install

npx skills add Donchitos/Claude-Code-Game-Studios --skill playtest-report -g -a claude-code -y
Category
Writing
Updated
17d ago
License
MIT
Context cost
Mediumabout 1,603 tokens
Runs scripts
No, instructions only

What it does

Structured playtest report template, or turn existing playtest notes into structured feedback.

!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

Phase 2A: New Template Mode

Generate this template and output it to the user:

# Playtest Report

## Session Info
- **Date**: [Date]
- **Build**: [Version/Commit]
- **Duration**: [Time played]
- **Tester**: [Name/ID]
- **Platform**: [PC/Console/Mobile]
- **Input Method**: [KB+M / Gamepad / Touch]
- **Session Type**: [First time / Returning / Targeted test]

## Test Focus
[What specific features or flows were being tested]

## First Impressions (First 5 minutes)
- **Understood the goal?** [Yes/No/Partially]
- **Understood the controls?** [Yes/No/Partially]
- **Emotional response**: [Engaged/Confused/Bored/Frustrated/Excited]
- **Notes**: [Observations]

## Gameplay Flow
### What worked well
- [Observation 1]

### Pain points
- [Issue 1 -- Severity: High/Medium/Low]

### Confusion points
- [Where the player was confused and why]
Read the whole SKILL.md on GitHub

More in Writing