Content
86%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-engineered instruction-only skill: the phased workflow is unambiguous and highly actionable, with detail correctly delegated to three real, one-level-deep reference files. Remaining polish is tightening the redundant final checklist and adding explicit per-phase recovery guidance.
Suggestions
Compress the 质量检查清单 to only the checks not already stated as hard rules in Phases 0–3 (e.g., drop items that restate the SVG-saving and KPA-format requirements) to cut duplicated tokens.
Add a short recovery instruction per phase (e.g., '若 checklist 项未通过 → 回到对应 Phase 修正并重新检查') to convert the post-hoc checklist into a validate-fix-retry loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is directive rather than explanatory — it never explains what SVG, Mermaid, TAM/SAM/SOM, or SaaS are, and assumes Claude's competence throughout. However, the 10-item '质量检查清单' substantially restates requirements already stated in the phases (e.g., 'SVG 图表已单独保存并在报告中引用' repeats Phase 2's rule), and the emoji-decorated role roster duplicates the role list that lives in references/role-templates.md. These are minor instances of repetition that could be trimmed, matching the 4 anchor rather than the every-token-earns-its-place 5 anchor. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is copy-paste ready: literal search query templates ('搜索 `[产品名] review site:g2.com OR site:producthunt.com`', '`[产品名] funding crunchbase`'), exact output file names (markdown/01_user.md … 07_partner.md), a concrete required-information checklist, a fully specified directory tree, and fill-in-the-blank formats for KPA entries and 如果…那么… adjustment statements. Per the code_vs_instruction note, absence of code is not penalized when guidance is this actionable; it matches 'concrete, specific guidance covering the common cases'. | 5 / 5 |
Workflow Clarity | Phases 0–4 give a clear, unambiguous sequence with explicit inputs, outputs, and file locations per phase, and the '质量检查清单' plus the '若找不到真实数据,明确标注…禁止伪造' rule act as checkpoints/feedback for the riskiest failure mode (fabricated data). It falls short of the 5 anchor because validation is post-hoc (a final checklist) rather than embedded per-phase with explicit fix-and-retry loops, and there is no instruction for what to do when a phase's output fails a checklist item. Not 3: a validation mechanism clearly exists and the sequence has no gaps. | 4 / 5 |
Progressive Disclosure | The body is an orchestration-level overview; all detail is correctly pushed to one-level-deep bundle files that all exist and are not nested further (references/role-templates.md, references/report-structure.md, references/chart-guide.md — each referenced exactly where needed, e.g., '每个角色文件的标准结构,参见 `references/role-templates.md`', and indexed again in a '参考文件索引' section). The 180-line body retains only process rules (file naming, chart rules, KPA format) that Claude needs while executing, matching the clear-overview/well-signaled-references anchor. | 5 / 5 |
Total | 18 / 20 Passed |