Content
85%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 skill body is a well-structured, actionable overview for an instruction-only skill: concrete script commands, a validated multi-step workflow with rollback, and clean progressive disclosure to real bundle files. Its only soft spots are a few non-essential narrative clauses and examples living in referenced files rather than inline.
Suggestions
Trim the bensz-collect-bugs collaboration convention and read-only integration notes to one line each, or move them to a references doc, to tighten conciseness toward 5.
Inline one short copy-paste example of the most common command (e.g. 'python scripts/run.py apply-section --project-root ... --title "国内外研究现状" --body-file ...') so the body alone is sufficient for the common case.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with sectioned, non-padded guidance and no explanations of concepts Claude already knows (e.g. it does not explain what LaTeX or NSFC is). It is not a 5 because a few incidental narrative clauses (e.g. the bensz-collect-bugs collaboration convention and read-only integration notes) add tokens that are not strictly needed for the core writing task. | 4 / 5 |
Actionability | Provides concrete executable guidance: exact script commands ('scripts/run.py coach --stage auto', 'scripts/run.py apply-section'), explicit write target ('extraTex/1.1.立项依据.tex'), and hard rules. It is not a 5 because copy-paste-ready code/examples live in scripts/README rather than inline; it is not a 3 because the inline commands are real and runnable, with only minor gaps. | 4 / 5 |
Workflow Clarity | The 8-step recommended workflow is clearly sequenced with explicit validation checkpoints (引用可核验性守护, 与 2.1 研究内容的术语/缩写/指标一致性检查, 安全写入+备份, rollback/diff), and includes feedback loops (AI 不可用必须回退; 引用核验拒绝写入). This matches the 5 anchor for a destructive-write skill with validation. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled one-level-deep references (references/*.md, scripts/README.md, scripts/core/*) that all resolve to real files, and content is appropriately split across references/scripts/assets rather than inlined. It matches the 5 anchor; navigation is easy and no nesting beyond one level is implied. | 5 / 5 |
Total | 18 / 20 Passed |