scenario-builder

Automate planning, drafting, and validation of MiltonLearnMandarin scenario JSON files.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/mikhwan89/MiltonLearnMandarin --skill scenario-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scenario-builder
Source: https://github.com/mikhwan89/MiltonLearnMandarin/tree/main/.claude/skills/scenario-builder
Command: npx skills add https://github.com/mikhwan89/MiltonLearnMandarin --skill scenario-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps users create new scenarios for MiltonLearnMandarin by guiding and validating the JSON structure and frontmatter, ensuring consistent quality across dialogues, quizzes, and vocabulary.

Core Features & Use Cases

  • Provides a complete template and workflow for drafting 3–6 step dialogues and 3–5 quiz questions that meet age-appropriate guidelines.
  • Enforces the MiltonLearnMandarin JSON schema and frontmatter constraints, and assists with updating the scenario index.
  • Integrates with the development workflow to generate ready-to-use scenario JSON files that can be loaded by the app.

Quick Start

Create a new scenario JSON file that follows the schema and add it to the scenarios index.

Frequently Asked Questions about scenario-builder

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

FAQPage Schema
How do I validate JSON schema and frontmatter for Mandarin learning scenarios?

You can validate Mandarin scenario JSON by enforcing schema requirements and frontmatter constraints, checking 3–6 step dialogues and 3–5 quiz questions for proper pinyin, tone accuracy, and age-appropriate content. The skill ensures child-friendly content and QA coverage.

What is the required JSON structure for MiltonLearnMandarin scenarios?

The required JSON structure for MiltonLearnMandarin scenarios includes frontmatter constraints, 3–6 step dialogues, and 3–5 quiz questions. Scenarios must also include proper pinyin, age-appropriate content, and pass checks for tone accuracy and QA coverage before being added to the scenario index.

How do I generate child-friendly Mandarin dialogue and quiz templates?

You can generate child-friendly Mandarin templates by drafting 3–6 step dialogues and 3–5 quiz questions that meet age-appropriate guidelines. The skill provides a complete template and workflow to assist with creating safe content and integrating ready-to-use scenario JSON files.

Does scenario validation check for age-appropriateness and pinyin accuracy?

Yes, scenario validation checks for age-appropriateness, tone accuracy, and pinyin accuracy. It enforces child-friendly content guidelines and ensures QA coverage across all dialogues and quiz questions within the generated Mandarin scenario JSON files.

Can I use this workflow to update the Mandarin scenario index automatically?

Yes, you can use this workflow to update the scenario index. The skill assists with adding newly validated scenario JSON files to the index, integrating them directly into the development workflow so they can be loaded by the MiltonLearnMandarin app.