Content
68%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 dense, actionable skill body: executable install, experiment, orchestration, and CI examples with a well-sequenced step structure and useful anti-patterns/limitations sections. Its main weaknesses are the missing pre-apply blast-radius validation for destructive experiments, a couple of incomplete or dangling references in the Workflow and CI examples, and minor marketing-quote padding.
Suggestions
Add a pre-apply validation checkpoint before destructive experiments: confirm the blast radius with 'kubectl get pods -n <ns> -l <selector>' and require the pod count to match expectation before 'kubectl apply'.
Fill in the 'selector: { ... }' placeholders in the Workflow example (Steps 5) so it is copy-paste executable, and replace the CI verdict step's './scripts/datadog-verdict.sh' with a concrete inline check (e.g. a datadog/prometheus query) since no script exists in the bundle.
Trim the website marketing quotes and the repeated 'Per [chaos-mesh-home][cm]' framings; keep only the factual details (RBAC default-on, Chaosd experimental, supported CRDs) each citation supports.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean: dense CRD tables, tight YAML, minimal prose. Minor padding — the marketing blockquote ('brings various types of fault simulation... enormous capability') and six repeated 'Per [chaos-mesh-home][cm]' citation framings add tokens without adding guidance. Not 3: the excess is occasional and short, not whole padded sections; not 5: the website quotes could be trimmed entirely. | 4 / 5 |
Actionability | Copy-paste-ready helm install with pinned version, full NetworkChaos/PodChaos/PhysicalMachineChaos YAML, kubectl watch/describe commands, and a CI snippet cover the common cases. Not 5: the Workflow example uses incomplete 'selector: { ... }' placeholders and the CI verdict step calls './scripts/datadog-verdict.sh', a script that does not exist in the bundle. | 4 / 5 |
Workflow Clarity | Steps 1-9 are clearly sequenced (install → fault types → author → orchestrate → dashboard → run/verdict → physical machines → CI) and the anti-patterns table reinforces safe defaults. However, for destructive/batch chaos operations there is no pre-apply validation checkpoint — nothing like verifying the selector's blast radius (e.g. 'kubectl get pods -l app=checkout') before 'kubectl apply' — and the steady-state verdict leans on an undefined script, so the validation cap applies. Not 4: the missing pre-apply safety check is a substantive checkpoint gap for operations that kill pods. | 3 / 5 |
Progressive Disclosure | Well-organized sections with clear headers, a References section signaling one-level-deep external links, and no nested references; cross-skill pointers are explicitly qualified ('references/litmus.md in chaos-experiment-author'). Not 5: everything is inline in a ~260-line SKILL.md with no bundle files — content like the full Workflow/Chaosd YAML or the fault catalog could be externalized; not 3: the structure and signaling are genuinely good. | 4 / 5 |
Total | 15 / 20 Passed |