Content
88%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 excellent operational skill: executable commands throughout, a numbered workflow mirrored by section order, and genuine validation gates with error-recovery paths. The only tightening opportunities are de-duplicating the two capture blocks and moving the long inline bash blocks into scripts/ to match the existing bundle structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative with essentially no explanation of concepts Claude already knows — it goes straight to env-guarded bash, brew install, and xcodebuild commands. It is not a 5 because of repetition: the launch and runtime capture blocks repeat three identical lines, and the warning about `output.json` vs `output_*.json` appears in both 'Preserve Outputs' prose and again one paragraph later. | 4 / 5 |
Actionability | Nearly everything is copy-paste-ready: guarded RUN_DIR setup, exact brew tap, full xcodebuild archive/create-xcframework invocations with flags, a concrete dSYM collection command with flag semantics, capture commands, and a preserve-outputs loop that writes a summary. The few placeholders (<path-to-built-simulator-App.app>) and the prose-only Xcode target wiring are the only non-executable bits, and the latter is inherently a manual IDE step. | 5 / 5 |
Workflow Clarity | The 7-step Core Workflow is followed by sections in exactly that order, with explicit validation checkpoints and recovery loops: a symbolication gate ('Do not draw conclusions from an unsymbolicated flamegraph'), a capture marker that must exist before preserving, an error exit when no fresh output JSON is found, UUID verification when a report 'looks suspicious', and a retry instruction ('If the analyzer rejects the JSON shape, capture again...'). This matches the top anchor including feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | The two bundle scripts (scripts/collect_ios_dsyms.sh, scripts/analyze_flamegraph_json.py) are real files, referenced one level deep via clear $SKILL_DIR paths, and sections are well-labeled. It is not a 5 because the body inlines two long multi-command blocks — the xcframework build (~25 lines) and the preserve-outputs loop (~20 lines) — that are script-shaped and would fit the existing scripts/ directory, keeping SKILL.md as a purer overview. | 4 / 5 |
Total | 18 / 20 Passed |