Content
77%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 exceptionally actionable, well-sequenced auditor prompt — every detector is executable, gated, and verified, with strong false-positive discipline and an explicit output contract. Its weaknesses are length (trimmable Invocation/Related/Scope sections, time-sensitive GRDB version pins that will rot) and a monolithic structure that inlines reference-grade detail instead of splitting it across files.
Suggestions
Move per-pattern detail (especially Pattern 11's GRDB version table and Phase 3's completeness questions) into a reference file such as references/patterns.md, keeping SKILL.md as the phase overview plus a compact pattern index.
Trim the Invocation Examples section to 2–3 representative prompts and fold the Related and Scope sections into a brief pointer list — they restate content already covered by the body.
Isolate the time-sensitive GRDB version information (7.11.0/7.11.1 fix status, "latest", unmerged-fix notes) into a versioned, dated reference section so staleness is detectable without rereading the detector.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is high-value operational content (grep patterns, gating, verification steps) rather than explanation of known concepts, but there is noticeable trimmable material: the five Invocation Examples, the Related and Scope sections, and per-pattern repetition of gating rules. Pattern 11 also pins time-sensitive version numbers ("7.11.0 – 7.11.1 (latest)", "still unfixed in 7.11.1") inline rather than in an old-patterns/deprecated section, which the guidelines penalize. Mostly efficient but could be tightened — anchor 3, not the lean anchor 5 nor the padded anchor 2. | 3 / 5 |
Actionability | Every detector gives an exact search regex (e.g. `INSERT\s+OR\s+REPLACE`, `static\s+let\s+databaseSelection`), a concrete Read-verification procedure, and a copy-paste-ready fix (`execute(sql: "WHERE id = ?", arguments: [id])`, `PRAGMA journal_mode = WAL`, `config.observesSuspensionNotifications = true`). Pattern 11 even includes a version-gated decision table with the exact GRDB versions and symptom string. Fully executable guidance covering the common cases — anchor 5. | 5 / 5 |
Workflow Clarity | The five phases (Framework Detection → Pattern Detectors → Completeness Reasoning → Cross-Reference → Health Score) are clearly sequenced, with explicit validation checkpoints throughout: "use Read to verify the surrounding context before reporting — grep patterns have high recall but need contextual verification", "Require evidence from the Phase 1 map — don't speculate", gating to suppress false positives, and an error-recovery path ("report an unresolvable GRDB version as a LOW-confidence finding with the reason, not as a clean pass"). A defined output format with output limits completes the loop — anchor 5. | 5 / 5 |
Progressive Disclosure | There is good internal section structure and the external `axiom-data (skills/grdb-performance.md)` references are clearly signaled with section numbers one level deep, but no bundle files exist and the 26KB body is monolithic — content that would serve better in separate reference files (Pattern 11's version table, Phase 3's twelve-row completeness table, the per-pattern detail) is inlined. Anchor 3: some structure, references present, but content that should be separate is inline. | 3 / 5 |
Total | 16 / 20 Passed |