Content
63%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 highly actionable with clearly sequenced, validated workflows and a well-organized script bundle. Its weaknesses are structural repetition across the flow and Scripts sections, a missing referenced script, and no progressive disclosure of the heavy conceptual content into reference files.
Suggestions
Remove the duplicate script descriptions: keep executable examples in one place (either the flow or the Scripts section) and cross-reference from the other.
Add the missing query-retro-pending.sh to the scripts bundle, or replace references with an existing script (e.g. query-metrics.sh).
Split the detailed rubric formula, bump-detection algorithm, and retro logic into reference files (e.g. RUBRIC.md, BUMP.md) referenced one level deep from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Operational and mostly free of basic-concept padding, but noticeably repetitive: score-only.sh, commit-prediction.sh, detect-bump-signals.sh, and validate-rubric.sh are each fully described twice (once in the flow sections, again in the Scripts section), and the dispatch strategy is restated multiple times. | 3 / 5 |
Actionability | Provides copy-paste-ready commands with full arguments (score-only.sh, commit-prediction.sh, validate-rubric.sh) covering common cases; docked one point because query-retro-pending.sh is referenced in the Retro flow but is absent from the scripts bundle. | 4 / 5 |
Workflow Clarity | Multi-step flows (1A steps 1-6, Retro 3a→3b, Bump 1-5) are clearly sequenced with explicit validation checkpoints and feedback loops (阈值门 最多2轮, validate-rubric 最多3轮, batch-then-aggregate ordering); minor gaps include the missing query-retro-pending.sh and an overwrite-without-verify step in commit-prediction.sh. | 4 / 5 |
Progressive Disclosure | Well-sectioned with a route table and file-structure diagram, and the scripts bundle is referenced one level deep, but all conceptual content (rubric dims, full flow logic, bump/retro algorithms) lives inline in a ~487-line monolith with no reference .md files to split out heavier material. | 3 / 5 |
Total | 14 / 20 Passed |