Content
43%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 body is lean and well-sectioned but rests almost entirely on a single run command that is actually broken: the script filename (underscores vs the real hyphenated name) and the cd path (an unrelated absolute path rather than the skill's scripts/ directory) both mismatch the bundle. Two of the three advertised functions — update history and analysis reports — have no described workflow, leaving the skill's execution story incomplete.
Suggestions
Fix the run command to reference the actual bundle file: `python3 scripts/top-lean-ai-monitor.py` relative to the skill directory, replacing the unrelated absolute path and underscore filename.
Add a short workflow for the other two advertised functions: how update history is recorded/read from the state file, and how an analysis report is generated from it.
Remove the duplicated opening line that restates the frontmatter description, and make the '核心功能' bullets add detail (e.g., data source, detection logic) rather than repeat it a third time.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and free of concept explanations Claude already knows, but the opening line '监控 Top Lean AI 榜单的变化,记录更新历史,提供分析报告。' repeats the frontmatter description verbatim, and the '核心功能' bullets then restate the same three functions a third time — clear tightening opportunities. Matches anchor 3 ('mostly efficient but includes some unnecessary explanation') better than 4, where only minor instances could be trimmed. | 3 / 5 |
Actionability | Provides a concrete run command ('cd /root/.openclaw/workspace/CS-Notes/snippets/' + 'python3 top_lean_ai_monitor.py'), but the referenced filename does not match the bundled script (scripts/top-lean-ai-monitor.py, hyphenated) and the cd path points outside the skill bundle, so the command as written fails. Additional key details — script arguments, output location, how to produce the promised analysis report — are missing. Matches anchor 3 (some concrete guidance but incomplete, missing key details); not 4 because a copy-paste command that errors is more than a minor gap. | 3 / 5 |
Workflow Clarity | The skill claims three functions (监控/记录/分析) but the body shows only a single run command; how the analysis report is produced, how state is maintained, or what happens on failure is never sequenced. Matches anchor 2 ('rough sequence present but many gaps; steps poorly defined; validation absent') — there is a high-level hint (run the script) but the specific steps for two of the three claimed functions are absent. Not 3 because anchor 3 expects steps actually listed with only validation gaps. | 2 / 5 |
Progressive Disclosure | The body is well-sectioned with clear headers, and at under 50 lines it needs no external references — but it does bundle a 277-line script whose path it references incorrectly (top_lean_ai_monitor.py vs scripts/top-lean-ai-monitor.py), so the one bundle reference present is broken rather than clearly signaled. Matches anchor 3 ('some structure, references present but not clearly signaled'); not 4 because a correct, well-signaled reference to the bundled script is the main organization gap here. | 3 / 5 |
Total | 11 / 20 Passed |