Pinyin Box transforms raw text or text within images into professional Pinyin and Mi Zi Ge Chinese character practice sheets.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pinyin-box
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pinyin-box using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Pinyin Box?
Pinyin Box is a specialized tool within the Openclaw Skills ecosystem designed to facilitate the creation of high-quality Chinese calligraphy and character writing materials. It serves as a bridge between digital content and physical practice, allowing users to input raw strings or upload images containing Chinese characters to generate formatted exercise papers.
By leveraging advanced image analysis and the pinyin-box CLI, this skill automates the tedious process of manual layout and phonetic labeling. Whether you are a student looking to practice new vocabulary or an educator preparing classroom materials, Pinyin Box provides a seamless, AI-driven workflow to produce standard writing grids in PNG or PDF formats.
Pinyin Box Use Cases
- Generating Mi Zi Ge practice sheets from a list of new vocabulary words.
- Extracting text from a screenshot of a digital book and converting it into a Pinyin-guided writing exercise.
- Creating large-format calligraphy practice guides for traditional brush work.
- Producing printable PDF worksheets for language learning curriculum development.
- Automating the removal of UI elements from mobile screenshots to focus solely on Chinese text for study guides.
How Pinyin Box Works
- The Openclaw Skills agent receives input via direct text or an uploaded image file.
- For image inputs, the system utilizes OCR capabilities to accurately identify and extract Chinese characters, filtering out metadata like timestamps or battery levels.
- The extracted text is cleaned and formatted, ensuring optimal line breaks and segmentations for a standard practice sheet layout.
- The skill invokes the pinyin-box CLI tool with specific parameters such as size (small, medium, large) and output format (PNG or PDF).
- The finalized practice sheet is generated and saved to the local workspace.
- The user is notified of the file path, total character count, and number of pages generated.
Pinyin Box Setup
To integrate this capability into your Openclaw Skills workspace, follow these installation steps:
Using pip
cd ~/.openclaw/workspace/skills/pinyin-box
pip install -r requirements.txt
Using uv
cd ~/.openclaw/workspace/skills/pinyin-box
# Create virtual environment
uv venv
# Activate environment
source .venv/bin/activate
# Install dependencies
uv pip install -r requirements.txt
Pinyin Box Data Schema & Taxonomy
The skill maintains a structured output directory for all generated materials within the Openclaw Skills framework:
| Item | Description | Default Path |
|---|---|---|
| Output Directory | Location of all generated PNG/PDF files | ~/.openclaw/workspace/pinyin-box/output/ |
| Image Output | Standardized grid images | filename.png |
| Document Output | Printable multi-page documents | filename.pdf |
Metadata such as character count and page count are provided in the execution summary to the user.
Pinyin Box Advanced Features
- Multi-format support: Seamlessly switch between PNG for digital viewing and PDF for professional printing.
- Automated Image Cleaning: Intelligent filtering of UI elements and non-essential text from screenshots during OCR.
- Customizable Aesthetics: Support for tone coloring and the ability to toggle Pinyin visibility off for advanced character recognition practice.
- Dynamic Scaling: Three distinct size presets (small, medium, large) to accommodate different writing styles and age groups.
- Multi-page Pagination: Automatically handles long texts by segmenting them into consecutive practice sheets.
SKILL.md
Loading
Related Openclaw Skills
WeCom Connect
A streamlined skill for connecting and authorizing Enterprise WeChat (WeCom) bots within the OpenClaw environment.
Agent Team Orchestration
A production-grade framework for managing multi-agent teams with specialized roles, task lifecycles, and structured handoff protocols.
Seedance Multi-Version Video Generator
A professional AI video generation skill supporting multiple Seedance model versions for high-fidelity text-to-video and image-to-video creation.
TrustSkills
TrustSkills is a security-focused verification utility that determines if a skill distribution channel is official, indexed, or untrusted.
CCFDDL Conference Watch
An automated academic conference tracker that fetches and filters submission deadlines from CCFDDL to provide real-time Call for Papers updates.
Error Handling & Resilience Reference
A comprehensive quick-reference for error handling patterns, HTTP status codes, and system resilience strategies.
Featured*
