playtest-report

Generate structured playtest reports from raw playtest notes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nevesb/idol-agency-maker --skill playtest-report-nevesb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: playtest-report
Source: https://github.com/nevesb/idol-agency-maker/tree/main/.claude/skills/playtest-report
Command: npx skills add https://github.com/nevesb/idol-agency-maker --skill playtest-report-nevesb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns inconsistent, freeform playtest notes into a consistent, actionable playtest report so teams can prioritize fixes and design changes without manual reformatting or lost observations.

Core Features & Use Cases

  • Template Generation: Produce a complete playtest report template including session info, first impressions, gameplay flow, bugs, quantitative data, and top priorities.
  • Analyze Raw Notes: Read raw playtest notes from a file path, populate the template with structured findings, and flag observations that conflict with design intent.
  • Categorization & Routing: Classify findings into design changes, balance adjustments, bug reports, and polish items, and provide guidance or automated next-step tasks including an optional Creative Director review.
  • Use Case: Run after a playtest session to produce a saved report that routes critical bugs to triage, proposes design changes, and documents priorities for the development backlog.

Quick Start

Run the playtest-report skill in analyze mode on your raw notes file to generate and save a structured playtest report for the team to act on.

Frequently Asked Questions about playtest-report

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

FAQPage Schema
How do I generate a structured playtest report from raw notes?

To generate a structured playtest report, run the skill in analyze mode on your raw notes file. It reads the notes, categorizes findings into design, balance, bug, and polish buckets, and saves a standardized report to your production paths after user confirmation.

What is the best way to standardize playtest feedback for game development?

Standardizing playtest feedback involves applying a consistent template that captures session metadata, first impressions, and gameplay flow. This process categorizes observations into actionable buckets, ensuring teams can prioritize fixes without manual reformatting or lost observations.

How does categorizing playtest observations into design and bug buckets work?

Categorizing playtest observations works by classifying raw findings into distinct buckets: design changes, balance adjustments, bug reports, and polish items. The skill cross-references design documents to flag conflicts and optionally triggers a creative director review.

Can I trigger a creative director review automatically from playtest notes?

Yes, you can trigger a creative director review from playtest notes. The skill spawns gate tasks for review and routes critical findings, proposing design changes and documenting priorities for the development backlog after generating the report.

Do I need design documents to cross-reference during playtest analysis?

Yes, design documents are used to cross-reference during playtest analysis to flag observations that conflict with design intent. This ensures the structured report accurately identifies necessary design changes and balance adjustments.