← Back to Skills Marketplace
pinyin-box
by
yanglinzhen
· GitHub ↗
· v1.0.0
· MIT-0
106
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install pinyin-box
Description
汉字小助手 - 将文字或图片中的文字转换为拼音格或米字格练习纸。 当用户需要：(1) 把文字转换成练字帖或米字格，(2) 提取图片中的文字并生成拼音格， (3) 生成汉字书写练习材料，(4) 把任何内容做成拼音格或米字格格式时，使用此 Skill。 支持文字输入、图片 OCR 识别，输出 PNG 或 PDF 格式。
Usage Guidance
This skill appears to do what it advertises: OCR text and run a local 'pinyin-box' CLI to produce practice sheets. Before installing, note that the install step will pip-install a wheel hosted on a GitHub release (normal for Python packages but it executes code in your environment). If you need higher assurance: (1) inspect the wheel's source repository (owner/URL in requirements.txt points to github.com/yanglinzhen/pinyin-box) before installing, (2) prefer installing into an isolated virtual environment, and (3) verify the package's behavior or run it in a sandboxed agent environment.
Capability Analysis
Type: OpenClaw Skill
Name: pinyin-box
Version: 1.0.0
The skill is classified as suspicious due to a high risk of shell injection in SKILL.md, which instructs the AI agent to pass user-provided text directly into a CLI command (`pinyin-box -t "文本内容"`) without explicit sanitization. Additionally, the requirements.txt file specifies a direct download of a Python wheel from a GitHub repository (github.com/yanglinzhen/pinyin-box) instead of a standard package registry, which introduces a supply chain risk. While the stated purpose of generating Pinyin practice sheets appears legitimate, these implementation flaws could allow for unauthorized command execution.
Capability Assessment
Purpose & Capability
Name/description (generate pinyin/grid practice sheets from text or images) aligns with instructions to OCR images, format text, and invoke a local pinyin-box CLI. The requirements (a Python package providing the CLI) are appropriate.
Instruction Scope
Runtime instructions stay within the stated purpose: they call an image OCR helper, format text, and run the pinyin-box CLI to produce PNG/PDF output. The instructions reference only workspace paths and the image tool; they do not request unrelated files, system-wide configuration, or external endpoints beyond installing the package.
Install Mechanism
No install spec in the registry, but SKILL.md instructs pip install -r requirements.txt which includes a direct GitHub Releases wheel URL. Using a wheel from GitHub Releases is a common pattern, but it does mean arbitrary Python code will be downloaded and installed into the agent environment — a normal but material supply-chain risk to be aware of.
Credentials
The skill declares no required environment variables, credentials, or sensitive config paths. The SKILL.md only references local workspace paths. No disproportionate secret access is requested.
Persistence & Privilege
The skill does not request always:true and is user-invocable only; it does not ask to modify other skills or system-wide settings. Ordinary lifecycle (installing its package into a virtualenv) is expected.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pinyin-box - After installation, invoke the skill by name or use
/pinyin-box - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of pinyin-box skill.
- Converts text or text extracted from images into standard pinyin grid or 米字格 practice sheets.
- Supports both text input and image OCR recognition.
- Outputs in PNG (default) or PDF format.
- Filters out extraneous information (such as UI elements) from images before processing.
- Automatically paginates for longer texts and informs user of character and page count.
- Provides CLI usage instructions and examples for generating practice materials.
Metadata
Frequently Asked Questions
What is pinyin-box?
汉字小助手 - 将文字或图片中的文字转换为拼音格或米字格练习纸。 当用户需要：(1) 把文字转换成练字帖或米字格，(2) 提取图片中的文字并生成拼音格， (3) 生成汉字书写练习材料，(4) 把任何内容做成拼音格或米字格格式时，使用此 Skill。 支持文字输入、图片 OCR 识别，输出 PNG 或 PDF 格式。 It is an AI Agent Skill for Claude Code / OpenClaw, with 106 downloads so far.
How do I install pinyin-box?
Run "/install pinyin-box" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is pinyin-box free?
Yes, pinyin-box is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does pinyin-box support?
pinyin-box is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created pinyin-box?
It is built and maintained by yanglinzhen (@yanglinzhen); the current version is v1.0.0.
More Skills