huashu-md-to-pdf

将 Markdown 文档转换为专业的 PDF 白皮书，采用苹果设计风格。支持完整的 Markdown 语法（代码块、表格、引用、列表等）。自动生成封面、目录、页眉页脚。使用场景：技术文档、白皮书、教程、报告等需要专业排版的 Markdown 文档。

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./huashu-md-to-pdf/SKILL.md

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is well-structured and actionable with executable examples and genuinely useful non-obvious guidance (the macOS Preview garbled-text investigation). It loses points mainly on conciseness due to promotional and descriptive padding.

Suggestions

Remove the self-promotional footer ('花叔出品 | 公众号 | 30万+粉丝...') and the changelog — neither helps Claude execute the skill and both consume context.

Trim the descriptive '设计特点' section (cover/TOC/typography prose) to the actionable essentials, or move it to a reference file.

Cut the '技术实现' section explaining that markdown2 parses Markdown and weasyprint does HTML-to-PDF; Claude already knows what these libraries do.

Dimension	Reasoning	Score
Conciseness	The body is mostly useful specifics, but the self-promotional footer ('花叔出品 \| 30万+粉丝...'), the descriptive '设计特点' section, the changelog, and the '技术实现' section explaining that markdown2 parses markdown add padding Claude does not need.	3 / 5
Actionability	Provides concrete executable commands ('python scripts/convert.py input.md -o ... --title ... --author ...'), install steps, CSS config variables, and Markdown structure rules, with only minor gaps.	4 / 5
Workflow Clarity	The single conversion action is unambiguous with install → run → troubleshoot guidance and a detailed known-issue section, but the doc is organized as a reference rather than an explicit sequenced workflow.	4 / 5
Progressive Disclosure	Well-organized into clear sections with an accurate pointer to the real bundle file scripts/convert.py; styles.css and cover.html are explicitly noted as embedded. Minor gaps: the detailed config and FAQ could live in separate reference files.	4 / 5
	Total	15 / 20 Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, actionable, and includes explicit use-case trigger guidance, covering both what the skill does and when to use it. It is held back from top marks by the absence of file-extension triggers and a slightly indirect 'when' framing.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — '转换为专业的 PDF 白皮书', '自动生成封面、目录、页眉页脚', and full Markdown syntax support (code blocks, tables, quotes, lists) — with only minor coverage gaps.	4 / 5
Completeness	Clearly states what it does and provides an explicit '使用场景' trigger clause naming concrete scenarios; the 'when' is present but framed as use cases rather than a direct 'Use when...' phrase, so it stops short of 5.	4 / 5
Trigger Term Quality	Includes natural terms users would say ('Markdown', 'PDF', '白皮书', '技术文档', '教程', '报告') with good coverage, but omits file extensions (.md, .pdf) and common synonyms.	4 / 5
Distinctiveness Conflict Risk	The '苹果设计风格 PDF 白皮书 from Markdown' niche is mostly distinct with clear triggers, though it could overlap with generic markdown-to-PDF or document-formatting skills.	4 / 5
	Total	16 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 2 missing	Warning
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	14 / 16 Passed

Repository: alchaincyf/huashu-skills
Path: huashu-md-to-pdf/SKILL.md
Commit: 49a55ba

Reviewed: 9 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.