Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is lean, well-structured, and offers a sequenced workflow with a build-validation checkpoint, but it stays monolithic with no progressive file disclosure and would benefit from concrete before/after refactor code examples.
Suggestions
Add a short before/after Swift example under "Extract ... subview types" or "Keep selection and layout stable" to make the refactor guidance executable rather than only descriptive.
Move the detailed file-shape ordering and directory conventions into a references file (e.g. references/file-layout.md) and summarize it in the body, improving progressive disclosure for a skill over 50 lines.
Inline the "Build after each major split" validation step into the Workflow steps themselves so the feedback loop sits directly in the sequence rather than only in the checklist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and bullet-driven, assumes Claude's competence (e.g. "Follow this ordering unless the file already has a stronger local convention"), and avoids explaining SwiftUI/AppKit basics Claude already knows. | 3 / 3 |
Actionability | Guidance is concrete with specific paths ("App/<AppName>App.swift", "Views/ContentView.swift", "Services/*.swift") and an explicit property ordering, but a refactor skill lacks before/after code examples that would make it fully executable. | 2 / 3 |
Workflow Clarity | The seven-step Workflow is clearly sequenced and paired with a Refactor Checklist that includes an explicit validation checkpoint ("Build after each major split so compile errors stay local"), providing a feedback loop for the structurally risky refactor. | 3 / 3 |
Progressive Disclosure | Sections are well-organized (Overview, Core Guidelines, Workflow, Checklist, Smells, Notes), but the skill is a monolithic single file over 50 lines with no bundle references to offload detail; the only cross-links ("swiftui-patterns", "appkit-interop") point to sibling skills, not bundle files. | 2 / 3 |
Total | 10 / 12 Passed |