Content
75%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 high-quality, repo-specific checklist: nearly every line encodes non-obvious project knowledge (impact areas, traps, config coupling) with concrete commands and explicit baseline-validation in the refactoring workflow. Remaining improvements are marginal - trimming the extension-point prose and naming the specific parallel tests to run.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with repo-specific facts (import-time registration side effects, DEFAULT_DATA_COLLATE_INFO coupling, strict SP ordering) with no basic-concept padding, but the ~30-line extension-point documentation section and the long 'AI self-inflicted defense loop' parenthetical could be tightened or moved to a reference file. | 4 / 5 |
Actionability | Concrete commands are given ('pytest tests/', 'make -C docs html SPHINXOPTS=-W'), along with exact file paths, concrete conventions, and a reference example page, matching 'mostly executable guidance'. Minor gaps remain, e.g., 'run the cross-cutting parallel tests' without naming which tests or the command to run them. | 4 / 5 |
Workflow Clarity | The refactoring workflow has an explicit validation loop (record baseline, one change per commit, verify tests match baseline, re-check baseline at the end) and the docs section requires a -W build before committing, but there are no error-recovery feedback loops (what to do when baseline comparison fails), matching anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The single-file skill has well-organized sections with clear pointers to other skills (/veomni-review, /veomni-debug) and knowledge files (.agents/knowledge/testing.md, a reference doc page), and no bundle files exist to structure. The detailed extension-point contract subsection is the one piece of content that arguably belongs in a separate reference file, keeping this at anchor 4. | 4 / 5 |
Total | 16 / 20 Passed |