md

Integrate Azure TTS for Cantonese speech and bilingual voice commands.

Updated Nov 18, 2025
One-click install
npx skills add https://github.com/taki-hor/massage_chatbot --skill md-taki-hor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md
Source: https://github.com/taki-hor/massage_chatbot/tree/main/md
Command: npx skills add https://github.com/taki-hor/massage_chatbot --skill md-taki-hor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires azure-cognitiveservices-speech, python-dotenv, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the critical need for a Cantonese-speaking chatbot for Hong Kong primary school students. It resolves issues with blocked Edge TTS and provides seamless bilingual command support, improving user experience and accessibility.

Core Features & Use Cases

  • Cantonese TTS: Integrates Azure Cognitive Services for high-quality, reliable Cantonese Text-to-Speech, ensuring the chatbot speaks the correct language.
  • Bilingual Commands: Supports both English and Cantonese for all control commands (stop, pause, resume, intensity, speed), making interaction natural for Hong Kong users.
  • Improved Voice Recognition: Enhances voice command accuracy and responsiveness, reducing user frustration.
  • Use Case: A child using the chatbot can naturally say "stop" or "停止" to pause the massage, and the chatbot will understand and respond correctly in Cantonese.

Quick Start

Follow the steps in AZURE_TTS_SETUP.md to integrate Azure TTS for Cantonese voice output.

Frequently Asked Questions about md

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

FAQPage Schema
How do I add Cantonese text-to-speech to a chatbot using Azure Cognitive Services?

To add Cantonese text-to-speech, integrate Azure Cognitive Services Speech SDK for reliable synthesis. This replaces blocked Edge TTS services, ensuring your chatbot outputs high-quality Cantonese audio for end users.

Can a chatbot understand both English and Cantonese voice commands?

Yes, a chatbot can understand bilingual English and Cantonese voice commands by enhancing speech recognition and command parsing. This allows users to naturally say control words like "stop" or "停止" interchangeably.

Why does Edge TTS stop working for Cantonese voice synthesis?

Edge TTS often stops working due to service blocks or regional restrictions. Switching to Azure Cognitive Services for Cantonese TTS provides a stable, reliable speech synthesis pipeline that avoids these blocking issues.

How do I set up Azure TTS for a bilingual Cantonese chatbot?

Set up Azure TTS by following the AZURE_TTS_SETUP.md guide to configure Azure Cognitive Services credentials via python-dotenv. This connects your chatbot to the Azure Speech SDK for Cantonese voice output.

What are the limitations of using Azure Cognitive Services for Cantonese speech recognition?

Azure Cognitive Services for Cantonese speech recognition requires an active Azure subscription and proper environment configuration. Users must manage API credentials securely using python-dotenv to maintain access.

Does Azure Cognitive Services support bilingual command parsing for chatbots?

Yes, Azure Cognitive Services supports bilingual command parsing by improving voice command accuracy. The chatbot processes mixed English and Cantonese inputs, correctly mapping commands like "pause" and "暫停" to actions.