Content
72%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.
An efficient, well-structured body with copy-paste dispatch commands and honest limitation notes. The weaknesses are the missing verification/feedback steps in the install-configure-dispatch-retrieve workflow and the absent templates/mac-run.yml bundle file that the body and installer both depend on.
Suggestions
Add a verification/feedback step after dispatch, e.g. `gh run watch` and `gh run download mac-run` to retrieve logs/<step>.log and screenshots/*.png, so the artifact-retrieval half of the skill is actionable.
Include templates/mac-run.yml in the skill bundle — the body links to it and scripts/install.sh copies from it, but the file is not present, breaking both navigation and the installer.
Add a brief pre-dispatch check that XCODE_SCHEME is a shared scheme and XCODE_DESTINATION is a concrete simulator available on macos-latest, to catch the most common configuration failures before a run.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout — e.g. "The workflow disables code signing. It does not archive, export or deploy an app." and the dense env/step tables — with no explanations of concepts Claude already knows. Every sentence carries setup or dispatch information, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Copy-paste-ready commands cover all three dispatch cases ("gh workflow run mac-run.yml -f step=build/test/screenshots") and configuration is concrete ("Replace the `App` placeholder", "Screenshots require a concrete simulator"). Not 5 because the run-monitoring and artifact-retrieval steps have no commands (e.g. `gh run watch` / `gh run download mac-run`), leaving a minor gap in the executable flow. | 4 / 5 |
Workflow Clarity | The section order gives a clear sequence (install → configure env → commit to default branch → dispatch → artifact), but checkpoints are missing or implicit: there is no pre-dispatch validation that XCODE_SCHEME is shared and XCODE_DESTINATION is available, and no step to verify the run succeeded before expecting the artifact. Failure behavior is described ("A failing command fails the run and keeps its log for upload") but there is no validate/fix/retry loop, so it fits the 'sequence present but checkpoints missing or implicit' anchor rather than the 'most checkpoints present' anchor at 4. | 3 / 5 |
Progressive Disclosure | The body is short and well-sectioned with clearly signaled, one-level-deep references ("[templates/mac-run.yml](templates/mac-run.yml)" and "scripts/install.sh"). However, scoring against the actual bundle structure, the primary referenced payload templates/mac-run.yml is absent (only scripts/install.sh exists), so the central link is broken and scripts/install.sh's "cat -- "$SCRIPT_DIR/../templates/mac-run.yml"" would fail — a real navigation failure rather than a minor organization gap, which rules out 4. | 3 / 5 |
Total | 15 / 20 Passed |