Content
93%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 exemplary skill body: lean, assumes competence, and highly actionable through a property-wrapper decision table and concrete rules. The only meaningful gap is that the workflow's validation checkpoints lack an explicit fix-and-retry feedback loop. Progressive disclosure is a model case, with the overview holding only decision-level guidance and all detail in well-signaled, flat reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~125-line body is dense with project-specific guidance (ownership table, extraction signals, iOS 27 preflight) and never explains concepts Claude already knows, e.g. no 'SwiftUI is Apple's framework' padding. Version-sensitive details ('Xcode 27', 'iOS 27') are correctly confined to a preflight section that delegates to references/ios27-updates.md rather than inlined. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is copy-paste-level concrete: a decision table mapping each wrapper ('@State', '@Bindable', '@Binding', '@Environment(Type.self)', '@Query') to exact use-when conditions, five explicit extraction signals, and a precise '.task or .task(id:)' vs stored 'Task' rule. Per the rubric's code-vs-instruction note, the absence of code is not penalized because every rule tells Claude exactly what to do. | 5 / 5 |
Workflow Clarity | The 5-step Workflow has an explicit validation checkpoint ('Build after a meaningful extraction or risky change, then render useful previews and exercise affected interactions') plus an 11-item Review Checklist. It falls short of the top anchor only because there is no explicit error-recovery feedback loop (what to do when the build fails or behavior differs); step 5's 'restore any changed behavior' gestures at it but the loop is not spelled out. | 4 / 5 |
Progressive Disclosure | The body is a concise overview with all detail pushed to 10 real, verified, one-level-deep reference files, surfaced both inline with context signals ('Read [Isolated Preview Construction]... when a preview needs fixtures') and in an annotated References section. Verified against the actual bundle: all referenced paths exist (69-701 lines each) and no reference nests another reference (the sole cross-link in ios27-updates.md routes to sibling skills, which is boundary routing, not nesting). | 5 / 5 |
Total | 19 / 20 Passed |