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.
The body is an exemplary operational skill: exact commands, a complete record/analyze/report sequence with explicit validation and consent gates, honest status reporting, and a concrete error-recovery table. The only real slack is minor redundancy around the consent rules and the boilerplate invocation-example block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — preset mapping tables, exact commands, gates, error tables — with almost no explanation of concepts Claude already knows. Minor instances could be trimmed: the five near-identical Invocation Examples, the repeated consent-gate rules ('not to clear a refused recording, not as an error-recovery retry, not to save a round-trip'), and the Scope section restating the description. This matches 'Efficient; minor instances of over-explanation that could be trimmed' rather than level 5, where every token earns its place. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: 'command -v xcprof && xcprof doctor', 'export XCPROF_TRACE_ROOT="$(mktemp -d)"', simctl discovery with jq, a user-intent-to-invocation table with exact flags and time limits, and a symptom/cause/fix error table. Parameter placeholders ('<app>', "<trace>") are appropriately explicit. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | A clear four-step sequence (pick target → record → analyze → report) with explicit validation checkpoints: 'doctor' readiness verification, '--dry-run' preview, reading the ok/notes fields, and the support-status honesty gate before calling anything clean. Feedback loops are present in the Error handling table (symptom → cause → fix) and the hang-window re-scope loop. Destructive operations are explicitly guarded (no 'rm -rf' of trace dirs; consent required before gated flags). This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery'. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and the body's pointers — 'axiom-tools (skills/xcprof-ref.md)', 'axiom-performance (skills/trace-comparison.md)', etc. — are clearly signaled one-level-deep cross-skill references collected in a Related section. Structure is good with well-labeled sections. It is not level 5 because some inlined content (the full Comparison/CI-gating section, the Invocation Examples block, detailed flag semantics) could be split out or trimmed, leaving minor organization gaps; it is well above level 3 since nothing is buried and navigation is easy. | 4 / 5 |
Total | 18 / 20 Passed |