← Back to Skills Marketplace
116
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install shuke-document-formatting
Description
数科公司文印格式自动化工具包。自动按照数科公司文印格式要求(方正小标宋简体、仿宋GB2312、楷体GB2312、黑体等字体,28字/行,22行/页)格式化Word文档并生成PDF。
Usage Guidance
What to consider before installing or running this skill:
- The code appears to do what the description says (format DOCX → PDF and install/verify fonts), but it performs system-level changes: install_shuke_fonts.py requires root and will copy TTF files into /usr/share/fonts/数科文印字体 and run fc-cache. Only proceed if you trust the font files and the author.
- Missing declared dependencies: the SKILL.md lists python-docx but does not list system binaries and Python packages actually used (pandoc, weasyprint, pdffonts/pdfinfo, fc-list/fc-cache, reportlab, PyPDF2). Install those in a controlled environment first (or inspect code) rather than elevating privileges to install them on the system blindly.
- Inspect font files before installing: the installer will scan and copy any matching TTFs from the provided directory. Verify that the TTF files are legitimate and licensed for your use; do not install unknown or untrusted fonts as root.
- Hard-coded paths: some tools default to /root/.openclaw/workspace paths if no arguments are given. Run the scripts with explicit input/output paths to avoid accidental operations on unexpected files.
- Test in an isolated environment: if possible, run the tool in a disposable VM or container first (or in a non-root user account) and avoid running install_shuke_fonts.py as root until you’ve verified the font files and the script behavior.
- Backup system fonts: if you decide to install, backup existing font directories first so you can recover if something goes wrong.
- If you only need formatting/PDF conversion and not system-wide font installation, try running the conversion tools with local font files or use the generate_proper_example/doc_generator utilities to see behavior without modifying /usr/share.
If you want, I can highlight the exact lines that (a) copy files into /usr/share, (b) require root checks, and (c) reference the hard-coded /root workspace paths so you can inspect them directly.
Capability Analysis
Type: OpenClaw Skill
Name: shuke-document-formatting
Version: 1.0.1
The skill bundle provides legitimate document formatting utilities but includes high-risk operations, specifically the requirement for root privileges in 'install_shuke_fonts.py' to modify system-wide directories (/usr/share/fonts/). It frequently uses 'subprocess.run' to execute system binaries (pandoc, fc-cache, pdffonts) and contains hardcoded absolute paths to the '/root/' directory across multiple files (e.g., 'check_pdf_fonts.py', 'install_shuke_fonts.py'). While these actions align with the stated purpose of font management and PDF conversion, the combination of root access requirements and shell execution constitutes a significant attack surface for an automated agent.
Capability Assessment
Purpose & Capability
The scripts and SKILL.md consistently implement document formatting, PDF generation, font installation/verification and batch processing — which aligns with the description. However the package uses several system tools (pandoc, weasyprint, pdffonts, fc-list, reportlab, PyPDF2) that are not listed in the SKILL.md "pre-requirements" nor in the registry metadata. That omission is unexpected and should have been declared.
Instruction Scope
Runtime instructions ask you to run install_shuke_fonts.py and conversion scripts. install_shuke_fonts.py will recursively scan directories for TTF files, copy matched fonts into a system-wide directory, update font cache, and write a CSS template into a root workspace path. check_pdf_fonts.py has a hard-coded fallback path (/root/.openclaw/workspace/...) if no PDF argument is provided. These behaviors modify system state and reference root-home paths beyond simply reading or transforming a single user-supplied document.
Install Mechanism
There is no remote install step or downloaded code; this is an instruction + code bundle (no network installers). That lowers risk compared to fetching arbitrary code. The highest-risk action is local file writes to system font directories done by the included install_shuke_fonts.py script.
Credentials
The skill does not request credentials or environment variables (none declared). However it expects and invokes system utilities (pandoc, weasyprint, pdffonts, fc-list, fc-cache) and Python packages (reportlab, python-docx, PyPDF2) which the SKILL.md does not fully declare — this mismatch may lead users to run unchecked commands as root to satisfy requirements. No secret access is requested.
Persistence & Privilege
The font installer requires root privileges and writes into /usr/share/fonts/数科文印字体 and updates fc-cache, and it also writes files into a root workspace path (/root/.openclaw/...). Those are legitimate operations for installing system fonts but are high-privilege actions; users should not run them without verifying the font files and source. The skill itself is not marked always:true and does not persist as a background service.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install shuke-document-formatting - After installation, invoke the skill by name or use
/shuke-document-formatting - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
v1.1.0: 增强字体安装体验
v1.0.0
shuke-document-formatting 1.0.0
- 首发版本,推出数科公司文印格式自动化工具包
- 支持自动格式化Word文档并生成符合公司规定的PDF(指定字体、页面设置、行距及网格要求)
- 提供批量转换、字体安装与验证、PDF格式检查等多项核心与辅助工具
- 内含详细文档结构分析、常见问题说明和示例生成器
- 支持一键批量处理、智能标题层级分析和自动化格式应用
Metadata
Frequently Asked Questions
What is Shuke Document Formatting?
数科公司文印格式自动化工具包。自动按照数科公司文印格式要求(方正小标宋简体、仿宋GB2312、楷体GB2312、黑体等字体,28字/行,22行/页)格式化Word文档并生成PDF。 It is an AI Agent Skill for Claude Code / OpenClaw, with 116 downloads so far.
How do I install Shuke Document Formatting?
Run "/install shuke-document-formatting" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Shuke Document Formatting free?
Yes, Shuke Document Formatting is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Shuke Document Formatting support?
Shuke Document Formatting is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Shuke Document Formatting?
It is built and maintained by shuchang (@an0027); the current version is v1.0.1.
More Skills