Content
96%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 exemplary behavior-focused skill body: lean, non-obvious facts, executable CLI/IaC patterns, and a validated provisioning workflow with checkpoints and recovery paths. The only weakness is structural — slightly long for a single SKILL.md and one unresolvable cross-skill reference.
Suggestions
Give the 'deployment' capability skill reference a concrete resolvable path or drop the row, so the pointer navigates as well as the docs.hetzner.com and provider links do.
Consider moving the IaC (Pulumi/Terraform) subsection into a references/ file linked from a two-line summary in SKILL.md, trimming the main body toward a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense operator-grade facts with zero explanation of concepts Claude already knows — no cloud-server tutorials, no library intros — and every line carries non-obvious behavior ("MTU is 1450", "rebuild wipes the disk but keeps all IPs", "Grow-only, online"). Matches the lean 'every token earns its place' anchor; not 4 because no padded or over-explained passage stands out. | 5 / 5 |
Actionability | Copy-paste-ready commands cover the common cases: orphan sweeps ("hcloud volume list -o json | jq -r '.[] | select(.server==null) | .name'"), an in-place resize chain with --keep-disk, fstab options ("discard,nofail"), and IaC fixes ("ignoreChanges: [\"userData\"]", "firewall.id.apply(Number)"). Matches the fully-executable 5 anchor; not 4 because concrete commands exist for every subsection. | 5 / 5 |
Workflow Clarity | The provisioning workflow is a numbered 5-step sequence with explicit per-step "Checkpoint" validation (e.g. "firewall rules list SSH restricted to admin IPs, never 0.0.0.0/0"), a pre-data "Gate" on protection, and a recovery loop for broken cloud-init (fix template, rebuild). Matches the explicit-validation-with-error-recovery 5 anchor; the destructive-ops cap does not apply since validation is present. | 5 / 5 |
Progressive Disclosure | Sections are well organized with a clear one-level References table of external links, but the single-file body (~90 lines) is denser than a lean overview and the "**deployment** capability skill" reference has no resolvable path. Fits the 4 anchor (good structure, minor organization gaps); not 5 because navigation to sibling material is vague. | 4 / 5 |
Total | 19 / 20 Passed |