Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a highly actionable, well-sequenced audit workflow with concrete greps, fix APIs, and validation checkpoints throughout. Its main weaknesses are length/verbosity in the per-pattern explanations and the absence of any progressive-disclosure file structure for the detailed anti-pattern catalog.
Suggestions
Move the 12 anti-pattern details (Phase 2) into a references/ file (e.g. ANTI_PATTERNS.md) and keep SKILL.md as an overview that links to it, tightening progressive disclosure.
Trim the 'Issue' lines that restate consequences an iOS expert already infers (e.g. why UIScreen.main is wrong) to cut tokens while keeping the grep and Fix.
Drop primer-style explanations of basic UIKit concepts Claude already knows; keep only the 27-cycle-specific implications that are genuinely novel.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and action-oriented rather than padded with generic filler, but at ~270 lines it restates some consequences an expert would infer (e.g. UIScreen.main 'Returns full-screen values that are wrong in any resized window') and explains UIKit basics Claude already knows, fitting the 'mostly efficient but could be tightened' anchor. | 2 / 3 |
Actionability | It gives fully executable grep regexes (e.g. `UIScreen\.main\.bounds`, `\b(320|375|390|…)\b`), concrete Glob patterns, and copy-paste fix APIs (e.g. `panRecognizer.allowedScrollTypesMask = .all`, `windowScene.effectiveGeometry.coordinateSpace.bounds`), matching the 'fully executable, specific, copy-paste ready' anchor. | 3 / 3 |
Workflow Clarity | A clear five-phase sequence with explicit validation checkpoints ('use Read to verify the surrounding context before reporting', 'verify the translation against a known-positive string'), a False Positives checklist, and output-limit triage rules, meeting the 'clear sequence with explicit validation steps and feedback loops' anchor. | 3 / 3 |
Progressive Disclosure | No bundle files exist (references/scripts/assets absent), and the 12-pattern catalog plus cross-reference tables live inline in a ~270-line monolithic SKILL.md rather than being split into a one-level-deep reference, matching 'some structure but content that should be separate is inline'; it is well-sectioned but does not progressively disclose via files. | 2 / 3 |
Total | 10 / 12 Passed |