Content
96%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.
An excellent review skill: dense with non-obvious project knowledge, executable checks, red flags, and a defined findings format, gated by an explicit completion criterion. Weaknesses are minor — some duplication around the KB connector pattern and a helper catalog that would sit better in a reference file.
Suggestions
Deduplicate the KB connector helper list: "Sim Helpers To Prefer" already names CONNECTOR_MAX_FILE_BYTES, readBodyWithLimit, stubOrSkipBySize, and markSkipped, which the "KB Connector File Size Handling" section re-describes — consolidate the shared details in one place.
Move the helper catalog (Sim Helpers + stream-limits list) into a references/ file and keep only the decision rules in SKILL.md, which would reduce body tokens and improve progressive disclosure.
The KB section's when-to-skip connector enumeration is long; compress it to the litmus test plus a short list of bounded-connector examples to trim repetition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every line carries repo-specific knowledge Claude cannot know (helper names, caps, connector rules), so there is no padding of known concepts. Falls short of 5 because the KB-connector helper set (CONNECTOR_MAX_FILE_BYTES, readBodyWithLimit, stubOrSkipBySize, markSkipped) is described twice — once under "Sim Helpers To Prefer" and again in the "KB Connector File Size Handling" section — and a few bullets restate ideas from other sections. | 4 / 5 |
Actionability | Fully concrete guidance: exact file paths and helper signatures (chunkedBatchDelete, selectRowsByIdChunks, readResponseToBufferWithLimit), concrete SQL shapes ("WHERE id > afterId ORDER BY id LIMIT N"), specific anti-patterns to flag, and a copy-paste findings template with a worked example. Not 4 because there are no gaps — a reviewer can execute every check directly from this text. | 5 / 5 |
Workflow Clarity | The 7-step Review Workflow is clearly sequenced (identify sources → bound cardinality → accumulation analysis → concurrency → SQL shape → byte safety → failure behavior) with an explicit validation checkpoint in step 2 ("If the code does not enforce one, it is unbounded"), checklist-style Red Flags, and a final gate: "Only say 'good to go' when every changed source has explicit row, byte, and concurrency bounds". Not 4 because error/finding handling and the completion criterion are explicit rather than implicit. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the skill is a single well-sectioned SKILL.md with clear headers and clearly labeled external reference URLs. This matches the 4 anchor (good structure, minor gaps): the ~30-line "Sim Helpers To Prefer" catalog and the dedicated KB-connector section are reference-style material that could live in a references/ file, but as inline sections they remain easy to navigate and signal when to use them. | 4 / 5 |
Total | 18 / 20 Passed |