Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a clear, validated workflow and concrete tool calls, but it is monolithic and somewhat verbose in its templates. Splitting long reference material into bundle files and trimming redundant sections would lift the two level-2 dimensions.
Suggestions
Move the full test-summary template and the human-verification flow table into a reference file (e.g. references/TEMPLATES.md) and link to it from the body, improving progressive disclosure.
Trim the "Quick Usage Examples" section, which restates invocations already implied by the argument-hint and workflow, to improve conciseness.
Consider shortening or collapsing the prerequisites list into a single sentence, since most items (Xcode installed, simulator available) are implied by the workflow steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence (it lists MCP tool names without explaining what they are), but sections like the long test-summary template, the prerequisites list, and the redundant "Quick Usage Examples" could be tightened. This fits level 2 ("Mostly efficient but includes some unnecessary explanation or could be tightened") rather than the lean level-3 anchor. | 2 / 3 |
Actionability | It gives fully concrete, executable guidance throughout — named MCP tool calls (list_simulators, boot_simulator, build_ios_sim_app, install_app_on_simulator, etc.), copy-paste install commands (brew tap, npx), and a fallback command (xcrun simctl openurl). This matches the level-3 anchor "Fully executable code/commands; specific examples; copy-paste ready." | 3 / 3 |
Workflow Clarity | The nine numbered steps (0–9) are clearly sequenced with explicit validation checkpoints ("Do NOT proceed until XcodeBuildMCP is confirmed working", "Wait for the simulator to be ready") and feedback loops (build failure reporting, "Fix now"/"Skip" with rebuild-and-retest). This matches the level-3 anchor "Clear sequence with explicit validation steps; feedback loops for error recovery." | 3 / 3 |
Progressive Disclosure | The ~200-line skill is well organized into sections but is monolithic — no references/scripts/assets bundle exists, and inline material such as the test-summary template and human-verification table could plausibly live in separate reference files. Per the scoring note this exceeds the <50-line simple-skill case, so it sits at level 2 ("Some structure but could be better organized; content that should be separate is inline"). | 2 / 3 |
Total | 10 / 12 Passed |