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.
A well-structured skill body: lean, highly specific guidance with explicit validation checkpoints, feedback loops, and a shipping checklist, backed by a clean three-file reference layer that is clearly signaled and correctly scoped. The only minor improvements are trimming the brief concept-restatement and HIG advice, and noting that full code examples live one level deep in the references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, high-value specifics ("com.apple.developer.on-demand-install-capable", "APPCLIP active compilation condition", "_XCAppClipURL") with almost no padding, but the opening purpose line and the HIG-style UX advice in Common Mistakes ("Avoid marketing-only clips, ad-heavy flows, splash screens...") explain concepts Claude largely already knows and could be trimmed. Not a 5 because of those minor over-explanations; not a 3 because the bulk is efficient and irreducible. | 4 / 5 |
Actionability | Concrete, executable guidance dominates: exact entitlement keys, the bundle-ID format "com.example.MyApp.Clip", ".onContinueUserActivity(NSUserActivityTypeBrowsingWeb)", "appclips:example.com", and "app-clip-bundle-id" banner keys. Not a 5 because full copy-paste code is deferred to reference files, leaving minor gaps inline; not a 3 because what is written is specific and executable, not pseudocode or vague hints. | 4 / 5 |
Workflow Clarity | Setup is numbered and sequenced, and each major section ends with an explicit validation checkpoint with a retry loop ("rearchive until both pass", "repeat until the App Clip and installed full app reach the same destination"), capped by a Review Checklist with "fix failures and rerun the same gate". This matches the anchor: explicit validation steps, feedback loops for error recovery, and a checklist for a complex process. | 5 / 5 |
Progressive Disclosure | A clear overview with three real, one-level-deep references, each well-signaled with both scope and a load condition ("Read ... when implementing invocation URL routing...", "Load it whenever any of those topics is in scope"), plus a Contents TOC; referenced files and anchors (size-limits, feasibility-review-template) all exist. Boundary-level content stays in SKILL.md while implementation detail is pushed to references — no nesting beyond one level. | 5 / 5 |
Total | 18 / 20 Passed |