playtest-report

Generates structured playtest report templates and analyzes raw playtest notes into categorized findings.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill playtest-report-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: playtest-report
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/playtest-report
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill playtest-report-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Playtest feedback often arrives as scattered, unstructured notes that are hard to act on. This Skill standardizes playtest feedback collection by generating a consistent report template and converting raw tester notes into structured, categorized findings. ## Core Features & Use Cases - Template Generation: Produces a complete playtest report template covering session info, first impressions, gameplay flow, bugs, and quantitative data. - Notes Analysis: Reads raw playtest notes and fills the template with structured findings, flagging observations that conflict with design intent. - Action Routing: Categorizes findings into design changes, balance adjustments, bug reports, and polish items, then routes each to the appropriate follow-up workflow. - Use Case: After a playtest session, point the Skill at your raw notes file to produce a structured report saved to production/qa/playtests/, with prioritized next steps for the design team. ## Quick Start Use the playtest-report skill to analyze my raw playtest notes at notes/session-01.md and generate a structured report.

Frequently Asked Questions about playtest-report

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

FAQPage Schema
How do I create a playtest report template for game testing?

Run the skill in new mode to generate a complete markdown template covering session info, first impressions, gameplay flow, bugs encountered, quantitative data, and overall assessment. The template standardizes feedback across all testers.

How to analyze raw playtest notes into structured feedback?

Use analyze mode with the path to your raw notes file. The skill reads the notes, cross-references existing design documents, fills the report template with structured findings, and flags observations that conflict with design intent.

What categories does playtest feedback get sorted into?

Findings are categorized into four buckets: design changes for fun or confusion issues, balance adjustments for difficulty problems, bug reports for reproducible defects, and polish items for non-blocking friction. Each category routes to a specific follow-up workflow.

Where are playtest reports saved after generation?

Reports are saved to production/qa/playtests/playtest-[date]-[tester].md after you confirm the write operation. The skill creates the directory if it does not exist.

When is the creative director review skipped in playtest reports?

The CD-PLAYTEST creative director review only runs in full review mode. It is skipped in solo and lean modes, with a note added to the report explaining the skip before saving.