Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable and well-sequenced with concrete commands and validation checkpoints, but it is verbose with repeated policy statements and monolithic with no progressive disclosure into reference files.
Suggestions
Consolidate the repeated provider-selection policy into one stated contract and reference it instead of restating 'preserve the resolved provider' across many sections.
Split the long Observability Flags reference and provider-specific command catalogs into reference files under references/ and link to them from SKILL.md.
Move the macOS/Windows, AWS, and Blacksmith provider sections into separate reference files so SKILL.md stays a concise overview with one-level-deep links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is operational and avoids explaining concepts Claude already knows, but it is ~860 lines with significant repetition of the provider-selection policy ('preserve the resolved provider', 'do not switch providers unless the user explicitly requests') that could be tightened. | 2 / 3 |
Actionability | It provides extensive copy-paste-ready commands with exact flags, env vars, and JSON summary fields (e.g. the AWS changed-gate `crabbox run --idle-timeout 90m ...` block and the live-provider debug template). | 3 / 3 |
Workflow Clarity | Multi-step flows are explicitly sequenced with validation checkpoints, e.g. the numbered E2E verification flow (reproduce -> patch -> one Crabbox E2E command -> record proof) and 'If Crabbox Fails' triage with verify-cleanup steps. | 3 / 3 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the skill is a single monolithic ~860-line file; sections are well-organized with headers, but reference-style content (Observability Flags, provider-specific sections) that could be split out is all inline. | 2 / 3 |
Total | 10 / 12 Passed |