Content
77%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is a highly actionable, well-sequenced research workflow with strong validation checkpoints (sufficiency self-checks and a delivery checklist) and copy-paste-ready commands. Its main weaknesses are moderate verbosity (CSS details duplicated from the bundled script) and progressive-disclosure gaps: the provided references/schema.json is never linked from SKILL.md while style-guide content that could live in a reference is inlined.
Suggestions
Reference references/schema.json from the body (e.g., in 第一步/第二步: '分析结构字段见 references/schema.json') so the bundled analysis schema is discoverable instead of orphaned.
Trim the '脚本内置的排版规范' section to a one-line pointer ('排版已内置,无需手动调整;细节见 scripts/md_to_pdf.py') — the CSS color/font/margin details duplicate the script itself.
Move the 写作风格 guide into a references/ file (e.g. references/writing-style.md) and keep a short summary plus the 绝对禁区 list in SKILL.md; this also resolves the dangling 'khazix-writer skill' reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, purpose-built guidance (word-count targets, forbidden-phrase lists, A/B/C competitor branching), but includes unnecessary padding: the "脚本内置的排版规范" section enumerates the script's internal CSS ("H1标题=#1a5276深蓝、H2=#1e8449绿色..."、页眉、页脚) even while stating "无需手动调整", duplicating what already lives in md_to_pdf.py, and per-section 篇幅 guidance is repeated again in the 篇幅总览 table. This matches the score-3 anchor (mostly efficient with some unnecessary explanation that could be tightened) rather than 4, where such redundancy would be only minor. | 3 / 5 |
Actionability | Guidance is copy-paste ready throughout: exact install command ("pip install weasyprint markdown --break-system-packages"), a ready-to-embed sub-agent prompt block including a concrete arxiv API call ("curl -s \"https://export.arxiv.org/api/query?search_query=all:关键词1+AND+all:关键词2&max_results=10\""), a concrete conversion invocation with arguments, explicit per-section word ranges, scene A/B/C branching rules, a report structure template, and file-naming conventions. This matches the score-5 anchor (fully executable commands covering common cases); nothing here is pseudocode or vague. | 5 / 5 |
Workflow Clarity | The five-step sequence (前置准备 → 第一步信息收集 → 第二步纵向 → 第三步横向 → 第四步交汇 → 第五步PDF生成) is clearly ordered, and validation is explicit with feedback loops: the 信息充分性自检 ("信息不够就再补搜。不要凑合。"), source-priority rules, and a 13-item 质检清单 before delivery. This matches the score-5 anchor (clear sequence, explicit validation steps, error-recovery loops, checklist for a complex process). | 5 / 5 |
Progressive Disclosure | The bundle provides references/schema.json and scripts/md_to_pdf.py, and the script is clearly and repeatedly referenced from the body — but references/schema.json is never mentioned anywhere in SKILL.md, leaving a whole detailed analysis-structure file orphaned and unnavigable. Meanwhile, sizable content that belongs in a reference file (the ~45-line 写作风格 guide, the inlined CSS 排版规范) is inlined in SKILL.md, and the body points to an external non-bundled skill ("详细定义请参考 khazix-writer skill") which slightly contradicts its own claim that the style guide is built in. This matches the score-3 anchor (some structure, references not clearly signaled, content that should be separate is inline); it is not 4 because a provided reference file is entirely unreachable from the overview. | 3 / 5 |
Total | 16 / 20 Passed |