player-friction-reviewer

Identify and document player friction in onboarding, tutorials, and UI interactions.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/hoonzinope/skills --skill player-friction-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: player-friction-reviewer
Source: https://github.com/hoonzinope/skills/tree/main/game-skill/player-friction-reviewer
Command: npx skills add https://github.com/hoonzinope/skills --skill player-friction-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

The friction reviewer helps game teams systematically identify and log sources of player friction during onboarding, tutorials, and UI interactions, directing findings to a centralized document.

Core Features & Use Cases

  • Identify friction sources such as tutorial overload, hidden rules, and UI blocking strategies.
  • Log issues to .documents/game/PLAYER_FRICTION_REVIEW.md with a consistent, auditable format.
  • Leverage scaffolding tooling (scripts/scaffold_doc.py) and templates (assets/TEMPLATE.md) to generate or extend the documentation.

Quick Start

Run the scaffold tool to create or append the PLAYER_FRICTION_REVIEW.md document using assets/TEMPLATE.md.

Frequently Asked Questions about player-friction-reviewer

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

FAQPage Schema
How do I document player friction in onboarding and UI interactions?

To document player friction, you can systematically identify issues like tutorial overload and UI blocking, then log findings to a structured markdown file using provided scaffolding scripts and templates for auditable tracking.

What is player friction in game tutorials and UI flows?

Player friction refers to obstacles users encounter during onboarding or UI interactions, such as hidden rules or tutorial overload, which disrupt the player experience and require systematic identification and logging for resolution.

How do I track and log UI friction issues for my game?

You track UI friction issues by logging them into a centralized markdown document with a dated, structured format, maintaining a change history to ensure auditability across onboarding sequences and UI guidance reviews.

Can I generate a player friction review document automatically?

Yes, you can generate a player friction review document by running a scaffold tool that utilizes markdown templates to create or append structured findings directly into your game documentation directory.

What are common sources of player friction to look for during onboarding?

Common sources of player friction include tutorial overload, hidden rules, and UI blocking strategies, which can be surfaced by systematically reviewing onboarding flows and tutorial sequences for actionable issues.

Do I need specific dependencies to run the player friction logging tool?

No specific dependencies are required to run the player friction logging tool, as it operates using self-contained scripts and markdown asset templates to scaffold and extend the review documentation.