Content
65%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 a lean, well-sectioned overview with copy-paste commands and a critically important safety principle about never pushing company docs. Its main gaps are missing operational detail (no usage examples for todo-manager.py itself) and the absence of any pre-push validation step despite the skill's own top rule being about preventing an irreversible git leak.
Suggestions
Show how to invoke each advertised function, e.g. one example command or subcommand for creating and updating a todo (arguments to todo-manager.py), not just bare invocation.
Add an explicit pre-push validation step, e.g. run a whitelist/blacklist check or `git status` review on staged files before ./todo-push.sh, turning the 第一原则 into an enforced checkpoint.
Drop the intro sentence that duplicates the frontmatter description verbatim, and fold the duplicated 核心功能 list into a single capability statement to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — bare commands, no concept explanations — but the intro line restates the frontmatter description verbatim and the 核心功能 list repeats it, matching the 'minor instances of over-explanation that could be trimmed' anchor. | 4 / 5 |
Actionability | The three command blocks are concrete and executable, but how to actually perform the advertised functions is never shown — no subcommands, arguments, or examples for creating or updating a todo — fitting the 'concrete guidance but incomplete; missing key details' anchor. | 3 / 5 |
Workflow Clarity | Usage steps are listed, but the push workflow is explicitly destructive (leaking 公司项目 to a public repo is the stated 第一原则) and lacks any validation checkpoint such as verifying the whitelist/blacklist before pushing, so workflow clarity is capped at 3. | 3 / 5 |
Progressive Disclosure | This is a simple skill under 50 lines with no need for external references; the sections (核心功能, 使用方法, 重要原则) are clear and well-organized, which earns 5 under the simple-skill exception. | 5 / 5 |
Total | 15 / 20 Passed |