Content
78%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.
A strong diagnostic skill body: copy-paste-ready commands, a well-sequenced triage workflow with smart interpretation guidance, and dense environment-specific facts with no padding. Its main defects are dangling bundle references (failure-patterns.md and diagnose.sh do not exist in the bundle) and small duplications that could be trimmed.
Suggestions
Ship the referenced bundle files — references/failure-patterns.md and scripts/diagnose.sh — or remove/inline those pointers; currently both references dangle and the progressive-disclosure chain breaks.
Deduplicate the resources jsonpath command (appears in Triage and again in Deployment Config Verification) and drop the When to Use list's overlap with the frontmatter description to tighten token usage.
Move the misplaced '# What is /data mounted on?' comment from the end of the redis-cli code block into the bash block it actually describes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: tables for services and queue names, terse copy-paste commands with one-line comments, and it explains only Buttercup-specific facts Claude cannot know (health_check_alive, CORPUS_TMPFS_PATH, consumer group names) without lecturing on Kubernetes or Redis basics. Minor trimming opportunities keep it below score 5: the When to Use section duplicates the frontmatter description, the resources jsonpath command appears in both Triage and Deployment Config Verification, and a stray "# What is /data mounted on?" comment sits at the end of the wrong code block. | 4 / 5 |
Actionability | Fully executable throughout: exact kubectl/redis-cli commands with only pod-name placeholders ("kubectl logs -n crs <pod-name> --previous --tail=200", "redis-cli XPENDING fuzzer_build_queue build_bot_consumers - + 10"), concrete stream keys, consumer-group names, and specific log signatures to grep for ("redis.exceptions.ConnectionError", "WAIT_PATCH_PASS"). Commands cover the common cases (OOM, cascade, AOF, disk pressure) and are copy-paste ready. | 5 / 5 |
Workflow Clarity | A clear sequenced triage flow — "Always start with triage. Run these three commands first", then "Then narrow down" with per-symptom follow-ups, plus interpretation checkpoints like checking --since=300s to distinguish historical from ongoing restarts and the cascade rule ("if they all say redis.exceptions.ConnectionError, debug Redis, not the individual services"). It is a read-only diagnostic skill so the destructive/batch validation cap does not apply, but the flow relies on section ordering and prose cues rather than explicit validation steps and error-recovery loops, which keeps it below the score-5 anchor. | 4 / 5 |
Progressive Disclosure | Section structure is good, but the disclosure chain is broken: the body points to "references/failure-patterns.md" and "{baseDir}/scripts/diagnose.sh", yet the bundle contains no references/, scripts/, or assets/ directories at all — both pointers dangle, so an agent following them fails. This is worse than the score-4 anchor (references mostly clear and usable) and lands at "references present but the organization/chain has real gaps"; it stays above score 2 because the main body is well-sectioned and the inlined quick-reference is appropriately brief. | 3 / 5 |
Total | 16 / 20 Passed |