skills.rest
joshp123joshp123Community·1 Agent Skills Included

xuezh

Mandarin pronunciation feedback, spaced review, and HSK progress tracking

Assesses Mandarin pronunciation from voice notes, generates text-to-speech audio, and runs spaced-repetition review sessions. Tracks HSK vocabulary coverage and learner progress as auditable facts without manual spreadsheets or guesswork. Keeps the engine as a simple data layer while the model handles teaching decisions, lesson planning, and feedback.
43|6
↗
npx skills add joshp123/xuezh --all -g -y
Available:

Instructs the agent on the project's operating rules, including the strict boundary where the engine only stores facts and runs mechanical transforms while the model makes all teaching decisions, plus contract-sync and testing requirements.

All Skills in This Repository (1)

Pure Emerald Level Indicators
📦 In Repo
joshp123joshp123

chinese-learning-orchestrator

Organize Mandarin learning sessions with the xuezh engine and generate bounded reports.

Community
Advanced

Frequently Asked Questions

FAQPage Schema
How to install xuezh?▼

Run `npx skills add joshp123/xuezh --all -g -y` in your terminal to install the skill globally. The engine itself can also be run directly with `nix run github:joshp123/xuezh`.

How to get Mandarin pronunciation feedback from a voice note?▼

Send a voice note and the agent calls `xuezh audio process-voice` with your reference text. Azure Speech returns accuracy, fluency, and word-level error data that the agent turns into targeted drills.

Does xuezh decide what I should learn next?▼

No. The engine deliberately avoids recommendations and only stores facts, runs reviews, and produces reports. Your agent makes all teaching and lesson-planning decisions.

Can xuezh track my HSK progress?▼

Yes. It seeds a pinned HSK dataset and generates coverage reports per level with `xuezh report hsk`, showing exactly which vocabulary you have studied.

Does xuezh work with Telegram bots?▼

Yes. It is designed to run behind a bot runtime like Clawdbot, which routes Telegram voice notes and messages to the xuezh CLI and returns feedback as chat replies.

Related Repositories in Education & Research

View All in Education & Research→
shareAI-labshareAI-lab
75.8k

learn-claude-code

Learn to build AI agent harnesses from scratch

Official📦 4 Skills
microsoftmicrosoft
73.6k

ai-agents-for-beginners

Learn to build, deploy, and secure AI agents step by step

Official📦 8 Skills
leonardomsoleonardomso
66.5k

33-js-concepts

Master 33 essential JavaScript concepts with tested, verified guides

Community📦 6 Skills