Content
81%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.
A well-structured operational skill: an explicit gated workflow with validation checkpoints and feedback loops, concrete executable commands, and properly bundled reference files. The main issues are machine-specific absolute paths that break portability of the otherwise copy-paste-ready commands, and minor padding (bio footer, Golden Rules duplicating the aesthetic profile).
Suggestions
Replace the hardcoded absolute paths ("/Users/alchain/Documents/写作/.claude/skills/xhs-image/scripts/generate_image.py" and "tools/upload_image.py") with skill-relative paths (e.g., "scripts/generate_image.py" resolved from the skill directory) so the commands are executable on any machine.
Trim the author-bio footer and fold the "Golden Rules" section into the aesthetic-profile section to remove duplication and reduce token load.
Move the inline 花叔科技账号配色 table and prompt-keyword list into references/style-gallery.md, keeping only a one-line pointer, so the main body stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive — tables of parameters, hex palettes, prompt templates, naming rules — with no explanations of concepts Claude already knows. Minor trim candidates: the author-bio footer ("花叔出品 | 公众号「花叔」| 30万+粉丝...") is irrelevant to execution, and the "Golden Rules" section restates points already made in the aesthetic profile. Not 5 because of that padding; not 3 since the padding is minor. | 4 / 5 |
Actionability | Fully concrete commands ("uv run .../generate_image.py --resolution 2K", "npx playwright screenshot ... --viewport-size=1080,1440"), a complete prompt template, and exact file-naming rules. Falls short of 5 because the commands embed machine-specific absolute paths ("/Users/alchain/Documents/写作/...") and rely on the macOS-only `open` command, so they are not copy-paste ready outside the author's machine. Above 3 because the commands are real and complete, not pseudocode. | 4 / 5 |
Workflow Clarity | A clearly sequenced 5-step flow (理解内容 → 设计提案 → 生成 → 预览确认 → 上传) with a mandatory user-selection gate ("这是整个流程最关键的一步。禁止跳过"), an explicit 4-item validation checklist (Chinese text rendering, 3:4 ratio, style match, no watermark), a two-dimension scoring review, and per-failure feedback loops ("文字有误 → 该张改用HTML兜底渲染", "大改方向 → 回到Step 2重新提案"). | 5 / 5 |
Progressive Disclosure | The body serves as a workflow overview with well-signaled one-level-deep references ("references/style-gallery.md — 完整风格库与 prompt 模板", "references/design-guidelines.md — 小红书平台设计规范") — both files exist and contain the promised content — plus a bundled script. Not 5 because the inline "快速参考" section (color palettes, prompt keywords) duplicates content that belongs in the reference files, keeping the split from being fully clean. | 4 / 5 |
Total | 17 / 20 Passed |