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.
The body is a well-structured, lean routing skill: a clear sequenced workflow with explicit verification, API-specific mistakes and invariants, a comprehensive review checklist, and clean two-file progressive disclosure. The only deductions are minor — some repeated boundary/reference mentions and no inline executable snippets, with concrete recipes living in the reference file.
Suggestions
State the WidgetKit/ActivityKit boundary once (the scope-boundary paragraph) and remove the duplicate DON'T section and checklist item, or compress them to a single checklist line, to save tokens.
Cite references/carplay-patterns.md once (in Route by Task or References) instead of three times, keeping the annotated References entry as the canonical pointer.
Move the "Swift 6.4, iOS 26+" version pin into the core-implementation reference or a dedicated scope note so time-sensitive version numbers don't age the entrypoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative with no explanations of concepts Claude already knows, but there is minor redundancy: the widget/Live Activity boundary is stated three times (scope-boundary paragraph, a DON'T section, and a checklist item), carplay-patterns.md is linked three times, and the version pin "Swift 6.4, iOS 26+" is time-sensitive information not placed in a deprecated/old-patterns section. This matches "efficient; minor instances that could be trimmed" rather than the fully lean top anchor. | 4 / 5 |
Actionability | Guidance is concrete at the API level — exact delegate signatures ("templateApplicationScene(_:didConnect:to:)" vs. the no-window variant), "setRootTemplate(_:animated:completion:)", "CPNowPlayingTemplate.shared", "CPSessionConfiguration.limitedUserInterfaces", and exact Info.plist keys — with concrete recipes delegated to core-implementation.md. Per the scoring notes an instruction-only skill is not penalized for absent code, but nothing in the body itself is copy-paste ready, placing it at "mostly executable guidance" rather than fully executable. | 4 / 5 |
Workflow Clarity | The Workflow section gives a clearly sequenced five-step process with an explicit verification step ("Verify reconnect, day/night appearance, multiple display sizes, driving restrictions"), and the 17-item Review Checklist provides checkpoints for the complex process — matching the anchor requiring explicit validation steps and checklists. No destructive or batch operations are involved, so the feedback-loop cap does not apply. | 5 / 5 |
Progressive Disclosure | The entrypoint is a genuine overview with implementation detail split into two real, one-level-deep reference files, each clearly signaled with its content scope in both "Route by Task" and the annotated References section; the reference files contain no further nested references, and a Contents TOC aids navigation. | 5 / 5 |
Total | 18 / 20 Passed |