Scenario Transformer Agent

Transform validated dialogue and blanks into RoleplayScript TypeScript format.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/mdrashedmamun/fluentstep-ielts-roleplay-engine --skill scenario-transformer-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Scenario Transformer Agent
Source: https://github.com/mdrashedmamun/fluentstep-ielts-roleplay-engine/tree/main/.claude/agents/scenario-transformer
Command: npx skills add https://github.com/mdrashedmamun/fluentstep-ielts-roleplay-engine --skill scenario-transformer-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the complex process of converting raw dialogue and identified blanks into a production-ready TypeScript format for IELTS roleplay scenarios, including metadata, character assignments, and pedagogical insights.

Core Features & Use Cases

  • Metadata Generation: Automatically creates scenario IDs, titles, descriptions, category classifications, and difficulty levels.
  • Character Assignment: Assigns realistic and diverse character names based on context.
  • Answer Variations: Transforms primary answers and alternatives into a structured format.
  • Deep Dive Insights: Generates pedagogical explanations for vocabulary, phrasal verbs, and idioms, linking them to learning objectives.
  • Code Generation: Outputs valid TypeScript code for integration into the application's static data.
  • Use Case: After a dialogue is validated, this agent takes the output and transforms it into a fully formatted RoleplayScript object, ready to be added to the application's scenario library.

Quick Start

Use the scenario transformer agent to convert the validated dialogue report into a RoleplayScript TypeScript object.

Frequently Asked Questions about Scenario Transformer Agent

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

FAQPage Schema
How do I convert raw IELTS dialogue into TypeScript format?

To convert IELTS dialogue into TypeScript format, this Skill transforms validated dialogue and blanks into production-ready RoleplayScript objects. It automatically generates scenario metadata, character assignments, answer variations, and pedagogical insights for static data integration.

How does metadata generation work for roleplay scenarios?

Metadata generation for roleplay scenarios works by parsing dialogue content for keywords, vocabulary complexity, and sentence structure. This mechanism automatically determines category classifications and difficulty levels to create structured scenario IDs, titles, and descriptions.

Can I use validated dialogue directly to create pedagogical insights?

Yes, you can use validated dialogue directly to create pedagogical insights. The processing logic transforms primary answers and alternatives into a structured format while generating deep dive explanations for vocabulary, phrasal verbs, and idioms linked to learning objectives.

What's the best way to assign character names in dialogue scripts?

The best way to assign character names in dialogue scripts is through context-based parsing. The Skill assigns realistic and diverse character names automatically based on the contextual cues found within the validated dialogue content during the TypeScript transformation process.

Do I need to manually format answer variations for TypeScript code generation?

No, you do not need to manually format answer variations for TypeScript code generation. The Skill automates this by transforming primary answers and alternatives into a structured TypeScript format suitable for integration into your application's static data library.

When do I need to transform dialogue into RoleplayScript format?

You need to transform dialogue into RoleplayScript format after a dialogue is validated and blanks are identified. This step is required when preparing production-ready TypeScript code to add new IELTS roleplay scenarios to your application's static data library.