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-engineered skill body: lean convention-only content, concrete API-level rules, a validated workflow with explicit build/preview feedback loops, and exemplary one-level-deep reference structure over a 30-file bundle. The only improvements are tightening two dense passages and optionally inlining a minimal code skeleton for the highest-frequency path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and restricted to project-specific conventions Claude cannot infer (wrapper choices, sheet patterns, repo search commands), assuming SwiftUI competence throughout. It falls short of the 5-anchor only because of minor trimmable material: the long iOS 16 fallback sentence and step 6's paragraph packing build validation, preview-crash recovery, and common compile errors into one block. | 4 / 5 |
Actionability | Guidance is concrete and API-level — ".sheet(item:) over .sheet(isPresented:)", "rg \"TabView\\(\"", a scenario-to-wrapper decision table, and named AppTab/RouterPath skeletons — clearly above the incomplete 3-anchor. It does not reach the 5-anchor because SKILL.md itself contains no copy-paste code, deferring code to reference files. | 4 / 5 |
Workflow Clarity | The 6-step "Workflow for a new SwiftUI view" is clearly sequenced with an explicit mid-course gate ("Build and verify no compiler errors before proceeding") and a validate→fix→rebuild feedback loop ("If the build fails: read the error message carefully, fix the identified issue, then rebuild"), plus preview-crash isolation recovery — matching the 5-anchor, not the 4-anchor's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | The body is an overview that pushes all detail to a verified one-level-deep bundle: every references/*.md path cited exists, components-index.md serves as a real entry point with per-entry when-to-use lines, and each inline pointer states its topic. This matches the 5-anchor exactly. | 5 / 5 |
Total | 18 / 20 Passed |