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 lean, highly actionable command skill with well-sequenced per-mode workflows, validation checkpoints, and good safety scoping for destructive faults. Its main defect is that every referenced bundle file (references/chaos.md and the examples/chaos/*.yaml files, including two values files required by the install commands) is missing from the bundle, which breaks both the install commands and the deferred experiment guidance.
Suggestions
Ship the referenced bundle files or remove the pointers: the helm install commands require examples/chaos/litmus-install-values.yaml and chaos-mesh-install-values.yaml to exist, and the debug mode depends on references/chaos.md.
Inline one complete experiment YAML (e.g., a pod-delete ChaosEngine with an HTTP probe) in the experiment mode so it is actionable even without the absent examples/chaos/pod-delete-experiment.yaml.
Add an RBAC verification step to install mode, since 'Stuck Initialized / Missing RBAC' is listed as the most common debug failure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with commands, YAML, wizard prompts, and a symptom/cause/fix table; it assumes Claude's competence and spends no tokens explaining what chaos engineering or Kubernetes is. Every section carries actionable weight, matching the 5 anchor ('lean and efficient; every token earns its place') rather than the 4 anchor's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Mostly executable: copy-paste helm installs with pinned versions, complete ChaosSchedule/Schedule YAML, concrete kubectl diagnostics, and a debug decision table. However, the install commands pass '-f examples/chaos/litmus-install-values.yaml' (and chaos-mesh-install-values.yaml) which do not exist in the bundle, so those commands fail as written, and the experiment mode defers entirely to missing example YAMLs instead of showing one complete experiment. Mostly executable with real gaps fits 4, not 5's copy-paste-ready coverage. | 4 / 5 |
Workflow Clarity | Each mode is a numbered sequence with an interactive wizard entry, explicit checkpoints (verify pods Running after install; require steady-state hypothesis before injecting; observe/verdict criteria in gameday), and safety constraints for the destructive operations (staging-only scheduling, 50% blast radius), so the destructive-operation cap does not apply. Minor gaps keep it at 4 rather than 5: install mode lacks an RBAC pre-flight check even though missing RBAC is listed as the top debug cause, and the experiment mode's end-to-end flow depends on example files that are absent. | 4 / 5 |
Progressive Disclosure | Mode-based sections are well organized and references are clearly signaled at the point of need ('load references/chaos.md', 'See examples/chaos/pod-delete-experiment.yaml'), but none of the referenced bundle files exist in the skill — no references/, scripts/, assets/, or examples/ directories are present, so every external pointer dangles and navigation is impossible. Structure is present but the references are broken, fitting the 3 anchor; it is not 4 because 'references mostly clear' fails when the targets are missing, and not 2 because the inline content is genuinely well sectioned. | 3 / 5 |
Total | 16 / 20 Passed |