Content
88%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 strongly actionable audit workflow: sequenced phases with built-in verification loops, copy-paste grep patterns, explicit false-positive guards, output limits, and a validation script. The main weaknesses are mild repetition and the fact that all anti-pattern detail lives inline in SKILL.md with no bundle files to offload it.
Suggestions
Consolidate the per-finding Cross-Auditor notes into the single Phase 4 overlap list to trim repeated tokens (helps conciseness).
Move the 15 anti-pattern entries (Phase 2) into a references/anti-patterns.md file and keep a summary table in SKILL.md, so the main file reads as overview-plus-navigation (helps progressive_disclosure).
Verify the referenced sibling-skill paths (skills/uikit-modernization.md, skills/resizable-rendering.md, skills/spritekit.md, skills/iphone-duo.md) resolve in the containing plugin, since they are not part of this skill's bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and high-signal — exact grep patterns, per-finding Issue/Fix pairs, no explanations of concepts Claude already knows — matching anchor 4's 'minor instances that could be trimmed' (e.g., Cross-Auditor overlap notes repeated across findings 2, 3, and 10, and the tool-use mandate restated in Phase 3). It is not a 5 because some repetition and rationale prose could be tightened without losing guidance. | 4 / 5 |
Actionability | Every phase gives copy-paste-ready commands: literal grep patterns (e.g. `UIScreen\.main\.bounds`, `safeAreaInsets\.(left|right)\s*\*\s*2`), exact API names for fixes (`windowScene.sizeRestrictions?.minimumSize`, `panRecognizer.allowedScrollTypesMask = .all`), and a concrete validation command (`xcui resize sweep --sizes <breakpoints> --assert-id <id>`). Per the rubric's instruction-skill note, the absence of full code blocks is not penalized since the guidance is fully executable. | 5 / 5 |
Workflow Clarity | Phases 1–5 are clearly sequenced with explicit validation checkpoints and feedback loops: "use Read to verify the surrounding context before reporting", "verify the translation against a known-positive string before trusting empty results", "Require evidence from the Phase 1 map — don't speculate", and present-the-map-before-proceeding. This matches anchor 5's explicit validation steps and error-recovery loops. | 5 / 5 |
Progressive Disclosure | Sections are well organized with clearly signaled one-level-deep references to sibling skills ("axiom-uikit (skills/uikit-modernization.md)", "axiom-graphics (skills/resizable-rendering.md)"), but no bundle files exist in this skill and the ~150 lines of anti-pattern detail (Phase 2) could plausibly live in a reference file. This matches anchor 4's 'good structure, minor organization gaps' rather than 5's clean overview-with-references split. | 4 / 5 |
Total | 18 / 20 Passed |