← Back to Skills Marketplace
an0027

Shuke Document Formatting

by shuchang · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
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
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install shuke-document-formatting
  3. After installation, invoke the skill by name or use /shuke-document-formatting
  4. 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
Slug shuke-document-formatting
Version 1.0.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 2
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.

💬 Comments