Content
70%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.
This is a strong, highly executable audit procedure with an exemplary phased workflow, explicit verification steps, and thoughtful false-positive and output-limit handling. Its weaknesses are length — several sections are trimmable padding for a 300-line single file — and the absence of any progressive disclosure: the full pattern catalog and completeness tables are inlined rather than split into referenced files.
Suggestions
Split the 9-pattern detection catalog into a references/patterns.md file and keep one-line summaries plus the highest-severity 2-3 patterns inline, cutting SKILL.md well under half its size.
Delete or compress the Invocation Examples section (five examples where two suffice) and the Scope section, which restates the frontmatter description.
Add copy-paste code for the fixes that are currently directional, especially Patterns 3 and 4 (willMigrate fetch placement and background ModelContext creation), to match the output format's own 'Fix: Code example' requirement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes domain competence (no 'what is SwiftData' filler), but there is trimmable material: five near-identical Invocation Examples, a Scope section that restates the description, and repeated 'Read matching files; check...' phrasing across patterns. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' — above anchor 2 (no padded concept explanations) but below anchor 4 because whole sections (Invocation Examples, Scope) could be cut with no capability loss. | 3 / 5 |
Actionability | Detection guidance is fully executable — verbatim grep regexes per pattern, quantitative thresholds ("5+ indexes", "batches of 100-500"), and code fixes like "@Relationship var tags: [Tag] = []" — matching 'mostly executable guidance with minor gaps'. Not 5 because several fixes are directional prose only (e.g. Pattern 3 'Move data access into willMigrate', Pattern 4 'Create a dedicated background ModelContext') without the code example the output format itself demands of findings. | 4 / 5 |
Workflow Clarity | Five phases are explicitly sequenced (map → detect → completeness → cross-reference → score) with a validation checkpoint after every detection step ('use Read to verify the surrounding context before reporting — grep patterns have high recall but need contextual verification'), plus a False Positives list and output limits as error-recovery guardrails. This matches the top anchor: clear sequence, explicit validation steps, and checklists for a complex process. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the entire ~300-line content is inlined in SKILL.md. Section structure itself is good (clear headers, tables), but content that clearly belongs in separate files — the 9-pattern detection catalog, the Phase 3 completeness table, and the invocation examples — is all inline, matching 'some structure but could be better organized; content that should be separate is inline'. Not 2 because headers and cross-references make it navigable; not 4 because nothing is split out despite the length (the under-50-lines simple-skill exception does not apply here). | 3 / 5 |
Total | 15 / 20 Passed |