AI Role-Playing for Workplace English Practice: A Technical Guide to the English-Level-Up-Tips Repository

The English-Level-Up-Tips repository provides a Markdown-based framework for practicing workplace English through AI role-playing, utilizing structured prompts in docs/threads/part-1/7-ai.md and curated vocabulary lists to simulate professional scenarios.

The byoungd/English-level-up-tips repository is a comprehensive, static knowledge base designed to help learners advance their English proficiency in professional contexts. Unlike traditional applications, this resource is structured as a GitBook-ready documentation suite that leverages large language models (LLMs) for interactive practice. The repository enables AI role-playing for workplace English practice through carefully crafted prompts and domain-specific vocabulary modules located in specific Markdown files.

Repository Architecture for AI-Powered Learning

Core Documentation Structure

The repository organizes its learning materials under the docs/ directory, with entry points at docs/en/README.md for English speakers and a root-level README.md for project overview. Navigation is driven by docs/SUMMARY.md, which functions as the table of contents for GitHub Pages or GitBook rendering.

The modular structure separates content into learning threads (docs/threads/part-1/, docs/threads/part-2/, etc.), with each directory representing a specific competency module covering understanding, vocabulary, listening, reading, speaking, writing, and AI integration.

The AI Integration Module

Located at docs/threads/part-1/7-ai.md, this file contains specific instructions for integrating LLM services including Gemini, ChatGPT, Claude, Perplexity, and DeepL Write. It provides prompt templates designed for workplace English practice scenarios, including role-specific instructions that maintain professional tone and industry-appropriate terminology.

Implementing AI Role-Playing Prompts

Workplace simulation requires context-rich prompts. According to the source code in docs/threads/part-1/7-ai.md, the repository recommends structuring interactions with explicit role definitions and scenario boundaries.

Example for a technical meeting:

**Scenario:** A project kickoff meeting between a product manager and a senior engineer.

**Prompt for Gemini (or any LLM):**  
> You are a senior software engineer at a tech company. Your manager just introduced a new micro-service architecture. Discuss the potential challenges, required testing strategies, and deployment pipelines. Keep the conversation professional and concise.

**How to use:**  
Copy the prompt into your LLM console (Gemini, ChatGPT, Claude, etc.) and iterate the dialogue.

Leveraging Specialized Vocabulary Lists

Technical Domain Glossaries

The docs/threads/word-list/ directory contains language-specific glossaries for programming contexts (Python, Rust, Go, etc.). These serve as vocabulary decks for technical role-playing scenarios, allowing learners to reference precise terminology during AI simulations.

Example integration:

**Vocabulary needed for a sales pitch:**  

- **prospect** – a potential customer  
- **value proposition** – the unique benefit you offer  
- **pipeline** – sales process stages  

See the full word list here: [Common Word List](https://github.com/byoungd/English-level-up-tips/blob/master/docs/threads/word-list/Common.md)

Enhancing Practice with Visual Proficiency Benchmarks

The repository includes visual assets in docs/assets/ to support proficiency assessment. The CEFR chart (CEFR@2x.png) helps learners gauge appropriate language complexity for their role-play scenarios, ensuring the AI interactions target the correct difficulty level.

Example reference:

![CEFR Scale](https://github.com/byoungd/English-level-up-tips/blob/master/docs/assets/CEFR@2x.png)

Use this chart to gauge the appropriate language complexity for your role-play (A2-B2 for most workplace scenarios).

Summary

• The repository uses a static Markdown architecture with no executable code, rendered via GitHub Pages or GitBook.
• Core AI role-playing guidance and LLM prompt templates are located in docs/threads/part-1/7-ai.md.
• Domain-specific vocabulary resources are organized under docs/threads/word-list/ for technical and business English contexts.
• Visual aids in docs/assets/ (including the CEFR scale) support proficiency level selection for targeted practice.
• Navigation is controlled via docs/SUMMARY.md for GitBook compatibility, with English entry points at docs/en/README.md.

Frequently Asked Questions

How do I start using the AI role-playing features in this repository?

Copy the prompt templates from docs/threads/part-1/7-ai.md into your preferred LLM interface (Gemini, ChatGPT, Claude, or Perplexity). These templates are designed for direct use without modification, though you can customize the professional context to match your specific industry or job function.

What types of workplace scenarios are covered in the English-Level-Up-Tips guide?

The repository supports diverse professional contexts including technical meetings, sales presentations, and cross-functional collaboration. The docs/threads/word-list/ directory provides specialized terminology for software development domains (Python, Rust, Go), while the general word lists cover universal business English essentials.

Can I use these materials without programming knowledge?

Yes. The repository contains only Markdown documentation with no executable code. Simply navigate to the relevant .md files on GitHub, copy the prompts, and paste them into any LLM web interface or application to begin practicing workplace English immediately.

How do I determine the appropriate difficulty level for my role-play sessions?

Reference the CEFR scale visualization located in docs/assets/CEFR@2x.png. Most workplace English scenarios target B1-B2 levels for professional competence, while technical deep-dives or senior-level negotiations may require C1 vocabulary available in the specialized word lists.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}