playtest-report

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

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

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.txt and generate a structured playtest 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 structured playtest report for my game?

Run the skill in new mode to generate a blank playtest report template covering session info, first impressions, gameplay flow, bugs, and quantitative data. Fill it in during or after the playtest session.

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, fills the report template with structured findings, and flags observations that conflict with your design documents.

Can playtest findings be routed to design and bug workflows?

Yes. Findings are categorized into design changes, balance adjustments, bug reports, and polish items, each routed to a corresponding follow-up command such as propagate-design-change, balance-check, or bug-report.

Where are generated playtest reports saved?

Reports are saved to production/qa/playtests/playtest-[date]-[tester].md after asking for your confirmation. The directory is created automatically if it does not exist.

What are the limitations of automated playtest note analysis?

Analysis quality depends on the detail in raw notes and the availability of design documents for cross-referencing. It structures and categorizes feedback but does not replace human judgment on subjective fun or feel issues.