skills.rest
Xyrces
XyrcesCOMMUNITY
Explore all skills by this author →
GitHub

onboarding_tutorial_design

Design game onboarding and tutorial plans with progressive mechanics and contextual prompts.

2|Updated Jul 2, 2026
Search Tags:#onboarding#game design#progressive disclosure#ftue#player retention#tutorial design
One-click install
npx skills add https://github.com/Xyrces/godot-ecs-gamedev-playbook --skill onboarding-tutorial-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: onboarding_tutorial_design
Source: https://github.com/Xyrces/godot-ecs-gamedev-playbook/tree/main/skills/onboarding_tutorial_design
Command: npx skills add https://github.com/Xyrces/godot-ecs-gamedev-playbook --skill onboarding-tutorial-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps game teams design onboarding and tutorials that teach mechanics clearly without flooding players with text, confusion, or early frustration.

Core Features & Use Cases

  • Progressive Disclosure: Introduce mechanics one at a time so players can learn, practice, and then combine them naturally.
  • Contextual Hinting: Trigger help at the moment of need using in-world prompts, stuck detection, and optional hints.
  • Level-Based Teaching: Use encounter layout, safe first encounters, and environmental gating to teach through play instead of explanation.
  • Flow and Difficulty Pacing: Adapt challenge to keep players engaged, reduce churn, and maintain a steady learning curve.
  • FTUE Optimization: Improve first-time player experience with fast interactivity, minimal text, skip options, and saved tutorial progress.
  • Use Case: A designer can use this Skill to build a movement-and-jump tutorial that teaches one mechanic at a time, fades prompts as players succeed, and resumes correctly if they quit mid-run.

Quick Start

Ask for a tutorial design plan for your game that introduces one mechanic at a time, uses contextual prompts, and includes skip, hint, and save-progress behavior.

Frequently Asked Questions about onboarding_tutorial_design

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

FAQPage Schema
How do I design a game tutorial that teaches mechanics without overwhelming players?▼

Design game tutorials using progressive disclosure to introduce mechanics one at a time, letting players learn, practice, and combine them naturally. This prevents cognitive overload and reduces early player frustration.

What is progressive disclosure in game onboarding and FTUE design?▼

Progressive disclosure in game onboarding introduces mechanics one at a time so players can learn, practice, and then combine them naturally. This technique maintains a steady learning curve and reduces player churn.

How do I set up contextual hints and stuck detection for an RPG tutorial?▼

Set up contextual hints by triggering help at the moment of need using in-world prompts and stuck detection. This provides optional assistance during RPG tutorials without flooding players with text.

What's the best way to pace difficulty and teach level-based mechanics in action games?▼

Pace difficulty in action games by using encounter layout, safe first encounters, and environmental gating to teach through play instead of explanation. This maintains engagement and adapts challenge to reduce churn.

Can I include skip options and saved tutorial progress in my FTUE flow?▼

Yes, you can include skip options and saved tutorial progress in your FTUE flow. Supporting these features ensures players can resume correctly if they quit mid-run, improving first-time player experience and retention.

Why does my game onboarding lose players before they finish the first level?▼

Game onboarding loses players when it floods them with text, confusion, or early frustration. Optimizing FTUE with fast interactivity, minimal text, and safe first encounters helps maintain player learning and retention.

Related Skills

Explore More Design & Creative Skills→
GeargrindadminGeargrindadmin

game-design

Structure core loop mechanics and Game Design Document composition for game development.

Community
Basic
nuoyanruoshuinuoyanruoshui
47

playtest-report

Convert raw playtest notes into structured reports with prioritized findings.

Community
Advanced
microlinkhqmicrolinkhq
142

onboard

Design onboarding flows with progressive disclosure and measurable success criteria.

Official
Intermediate
johnatas-henriquejohnatas-henrique

reverse-document

Generate design, architecture, and concept documentation from existing code.

Community
Advanced