Content
93%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.
The body is an exemplar of a lean CLI skill: goal statement, copy-paste-ready commands for both attach and launch flows, practical workflow notes, verified script references, and gotchas that carry real non-obvious knowledge (ASLR load address, symbol/binary matching). The only notable gap is the absence of explicit validation checkpoints between capture and symbolication, e.g., confirming the trace actually contains samples before ranking hotspots.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: "Goal: record Time Profiler via xctrace, extract samples, symbolicate, and propose hotspots without opening Instruments", five numbered command blocks, and terse notes/gotchas — no explanation of concepts Claude already knows (what xctrace or ASLR tutorials, etc.). Every line earns its place, matching the 'Lean and efficient' anchor; there is no padding to justify a 4. | 5 / 5 |
Actionability | Commands are fully executable and copy-paste ready with appropriate placeholders: "xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>", "vmmap <pid> | rg -m1 \"__TEXT\" -n", and the two script invocations with real flags. The common cases (attach vs launch recording, empty stacks, ASLR load addresses) are each covered, matching the 'Fully executable' anchor. | 5 / 5 |
Workflow Clarity | The five steps (record → extract → get load address → symbolicate/rank) are clearly numbered with rationale, and there are error-recovery hints ("If stacks are empty, capture longer or avoid idle sections", "Always confirm you're profiling the correct binary"). It falls short of the anchor-5 example's explicit validate-then-proceed checkpoints: there is no stated step to verify the trace contains samples or that the load address resolved before running symbolication, so it fits 'Clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a compact overview with well-organized sections (Quick start, Workflow notes, Included scripts, Gotchas), and the heavy logic is correctly pushed into bundle scripts — all three referenced paths (scripts/extract_time_samples.py, scripts/record_time_profiler.sh, scripts/top_hotspots.py) exist in the bundle. References are one level deep, clearly signaled in the 'Included scripts' section, and there is nothing that should have been split out further, matching the 'Clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 19 / 20 Passed |