Content
93%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, opinionated overview with concrete verdict tables and thresholds, backed by five well-signaled, one-level-deep reference files that verifiably contain the promised detail. The only structural gap is the absence of an explicit ordered design workflow with checkpoints — sequence is implied by section order and the Common Mistakes table rather than enumerated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section delivers opinionated, non-generic guidance in dense tables and short examples — partition-key verdicts, GSI-vs-LSI conditions, TransactWriteItems limits (100 items / 4 MB / 2x WCU), the ~100 KB S3-offload threshold. There is no explanation of concepts Claude already knows and no padding, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | For an instruction/design skill, the guidance is maximally concrete: concrete PK/SK examples with query predicates, decision rules with exact thresholds, per-scenario approach tables, and a Common Mistakes table mapping each mistake to a specific fix. The only thin spot (the adjacency-list section defers examples to the reference file) is a deliberate progressive-disclosure split, not a missing key detail. | 5 / 5 |
Workflow Clarity | The design process is well ordered — 'Identify all access patterns before creating tables' is an explicit sequencing directive, sections follow the natural design order (access patterns → keys/indexes → modeling → concurrency → global tables), and the Common Mistakes table doubles as a corrective checklist. It falls short of a 5 because there is no explicit step-by-step design procedure or checkpoint-style verification list; the sequence is implied by section order rather than enumerated. No destructive/batch-operation cap applies. | 4 / 5 |
Progressive Disclosure | The ~105-line body is a true overview: each topic section is a digestible summary with a clearly signaled 'See references/X.md for...' pointer, and a consolidated Reference Files section lists all five one-level-deep files with accurate descriptions. All five referenced files exist (spot-checked key-and-index-design.md, whose contents match the pointer's summary), and no reference nests deeper than one level. | 5 / 5 |
Total | 19 / 20 Passed |