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, highly operational skill body: every workflow step is backed by an exact command, exit codes are mapped to concrete next actions, and error/timeout paths have retry ladders and fallbacks. The only real costs are minor repetition of the exit 2/3 disambiguation and a monolithic inline structure where a references/ file could hold the pattern table and output template.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and earns its tokens — exit-code and pattern tables, exact commands, no explanation of what a crash file is, assuming Claude's competence throughout. It falls short of anchor 5 due to repetition: the exit 2 vs exit 3 distinction is stated three times (table rows, "Do NOT confuse exit 2 with exit 3", and "Checking images.missing vs images.mismatched ... disambiguates"), and the five invocation examples could be trimmed to two. Well above anchor 3, which requires unnecessary conceptual explanation that is absent here. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: `xcsym crash <file> --format=standard`, `command -v xcsym`, `xcsym verify <file>`, `xcsym find-dsym <uuid>`, `--arch`, `--no-spotlight`, `--no-symbolicate`, and `XCSYM_DSYM_PATHS=... xcsym crash <file>`, plus a per-exit-code next-step table and worked examples covering the common cases (happy path, exit 3, exit 2, exit 6 retry ladder). Matches anchor 5 exactly. | 5 / 5 |
Workflow Clarity | Clear sequence (check for xcsym → run crash → interpret exit code → pattern_tag → fix guidance) with an explicit validation checkpoint in the exit-code table, a full fallback chain (binary → `<plugin-root>/tools/xcsym` → `axiom_xcsym_crash` MCP tool → legacy manual parsing), error-recovery loops (exit 6: retry `--no-spotlight`, then `--no-symbolicate`), and a defined escalation section. This is the anchor-5 feedback-loop structure; anchor 4 would leave validation gaps, and there are none. | 5 / 5 |
Progressive Disclosure | Well-organized sections with clear headers and a Related section pointing one level deep to external skills (`axiom-tools (skills/xcsym-ref.md)`, `axiom-performance (skills/hang-diagnostics.md)`, etc.). Not a 5 because this skill ships no bundle files of its own while inlining ~200 lines of reference-grade material (the 20-row pattern→fix table, the full output template, five invocation examples) that could partly live in a references/ file; not a 3 because what is inline is clearly sectioned and the external pointers are explicit. | 4 / 5 |
Total | 18 / 20 Passed |