Content
86%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 exceptionally lean, command-dense skill with concrete executable guidance, real validation checkpoints, and error-recovery loops. The main structural weakness is that it is a monolithic single file: provider-specific and cross-OS detail would be better split into one-level-deep reference files.
Suggestions
Split provider-specific lanes (Untrusted AWS, Desktop/Cross-OS) into references/ files (e.g. references/untrusted-aws.md, references/desktop-cross-os.md) and signal them from short sections in SKILL.md.
State the top-level order once explicitly (Route → Preflight → Run → Record → Cleanup) so the pipeline is not reconstructed from rule fragments.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Telegraphic rule style ("No speculative warmup. Acquire when first heavy command ready. Reuse id. Stop.") with zero padding and no explanation of concepts Claude already knows; every token carries operational content. Lean throughout a dense 365-line skill. | 5 / 5 |
Actionability | Copy-paste shell with exact flags throughout, including the full untrusted-AWS sequence ("env -u CRABBOX_AWS_INSTANCE_PROFILE ... warmup --provider aws --network public ... --fresh-pr <owner/repo#number> --no-hydrate"). Placeholders like <check-command> are explicitly governed by the Repository Contract section, a justified flexibility rather than pseudocode. | 5 / 5 |
Workflow Clarity | Clear routing rules, preflight verification, explicit validation checkpoints (jq -e guards, post-warmup inspect, status --id --wait) and recovery loops ("retry --full-resync once. Still bad: fresh lease"). Below 5 because the top-level pipeline must be assembled from rule fragments across sections rather than one explicit ordered sequence with numbered checkpoints. | 4 / 5 |
Progressive Disclosure | Section headers are clear, but the whole skill is one inlined file: per-provider detail (Untrusted AWS, Desktop/Cross-OS) that belongs in separate reference files sits inline in a 365-line body, and no bundle files exist to offload it. Anchor 3: structure present, but content that should be separate is inline. | 3 / 5 |
Total | 17 / 20 Passed |