Content
85%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 with expert-level domain specifics and strong verification loops throughout. Its weaknesses are redundancy (duplicated scope and related-auditor content) and a fully monolithic structure with no progressive disclosure despite being long enough to benefit from splitting into reference files.
Suggestions
Move the detailed anti-pattern catalog, cross-reference tables, and output-format template into one-level-deep reference files (e.g. references/anti-patterns.md, references/output-format.md) and keep SKILL.md as the phased overview.
Consolidate the duplicated Scope (opening paragraph vs trailing '## Scope' section) and merge '## Related' with the Phase 4 cross-auditor notes to remove redundancy.
Trim the four invocation examples to one or two — they all demonstrate the same launch behavior.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, high-value specifics (e.g. the Xcode 27 @State deferred-initial-value behavior, '@Bindable on a struct does not compile', the withAnimation/await compile-error note) and avoids explaining basics. Not 5 because of clear redundancy: Scope is stated twice (opening paragraph and trailing section), the Related section repeats the cross-auditor notes from Phase 4, and four invocation examples say the same thing. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: literal grep patterns per category, an explicit read-to-verify requirement for every match, concrete fix targets with alternatives ('@Binding var item', '@Bindable var model'), a false-positive exclusion list, and a complete output template. Every detection category names its search, issue, and specific fix. | 5 / 5 |
Workflow Clarity | Five phases are explicitly sequenced with checkpoints: 'use Read to verify the surrounding context before reporting' forms a grep→verify feedback loop, 'Present this map in the output before proceeding' gates Phase 2 on Phase 1 output, and Phase 3 requires evidence from the map ('don't speculate without reading the code'). Output limits handle the high-volume case. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned with clear headers, but it is a ~240-line monolith with no bundle files — the anti-pattern catalog detail, the Phase 3/4 cross-reference tables, the health-score template, and the invocation examples are all inlined content that could live in one-level-deep reference files. This matches 'some structure but... content that should be separate is inline'; not 4 because no references exist at all to offload the bulk. | 3 / 5 |
Total | 17 / 20 Passed |