Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with concrete commands and good error-handling coverage, but it suffers from heavy repetition of the frontmatter requirement and is a monolithic single file with broken bundle references and no validation checkpoint in the publish workflow.
Suggestions
Deduplicate the frontmatter 'title/cover 必填' guidance — state it once authoritatively and reference it elsewhere instead of repeating the full '关键发现' three times.
Add a validation/verification checkpoint to the publish workflow (e.g. confirm draft appears in 草稿箱 and check for error output before declaring success).
Move themes, custom-theme, and troubleshooting sections into separate reference files under references/ and link to them, so SKILL.md stays a lean overview; ensure referenced paths like ./scripts/publish.sh actually ship in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly concrete and task-specific, but padded with repetition — the 'title 和 cover 必填' requirement and '关键发现(实测)' note are explained three separate times (Quick start, Markdown 格式要求, and 故障排查). | 2 / 3 |
Actionability | Provides copy-paste-ready, fully executable commands such as 'npm install -g @wenyan-md/cli', 'wenyan publish -f article.md -t lapis -h solarized-light', export env-var snippets, and specific error-message-to-solution troubleshooting. | 3 / 3 |
Workflow Clarity | Steps are sequenced (install → configure → prepare MD → publish) and a 工作流程 section exists, but publishing is a batch/external operation with no validation checkpoint or validate→fix→retry feedback loop, which caps the score at 2. | 2 / 3 |
Progressive Disclosure | All content lives in one monolithic 322-line SKILL.md with clear section headers, but topics (themes, troubleshooting, frontmatter details) that could be split out are inline, and referenced bundle paths like './scripts/publish.sh' do not exist in the bundle. | 2 / 3 |
Total | 9 / 12 Passed |