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 well-structured router SKILL.md: an accurate Express-vs-Standard overview with verifiable product facts, a concrete broker-type detection step, and an intent-to-reference table where every referenced bundle file exists. Weaknesses are minor: the MCP/local-install guardrail section is verbose, and inline executable examples are sparse because detail is delegated to references.
Suggestions
Tighten the Guardrail section (~20 lines) into a short two-case bullet list; most of the MUST/Do-NOT repetition adds tokens without adding information.
Add one or two copy-paste-ready inline command examples for the most common operations (e.g., a sample msk_sizing.py invocation or a describe-cluster-v2 output snippet) so the top-level file is actionable without a reference hop.
Fix the typo "Serqverless" in the Serverless eligibility routing row and split the routing table so strategic references and external doc links are visually distinct.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean routing content with no explanation of concepts Claude already knows (no Kafka/MSK primer), and the Express-broker facts (3x ingress, 20x faster scaling, 180x faster rebalancing, RF=3/min.insync.replicas=2) are product-specific data that earns its tokens. It falls short of level 5 because the ~20-line MCP-vs-local "Guardrail" section is wordy with repetitive MUST/Do-NOT emphasis, and the Overview partially restates the frontmatter description. | 4 / 5 |
Actionability | Concrete executable guidance is present: `aws kafka describe-cluster-v2 --cluster-arn <arn>` with the exact field to check (`Provisioned.BrokerNodeGroupInfo.InstanceType`), a runnable script with its credential/fallback behavior described, and per-intent routing into detailed references. It stops short of level 5 because the body itself contains few copy-paste-ready command examples — the executable detail largely lives one level down in the reference files — leaving minor gaps in the inline guidance. | 4 / 5 |
Workflow Clarity | The sequence is clear and well-ordered: determine broker type first (with a concrete command), then route via the intent table, with a Common Workflows section repeating the key entry points. This matches level 4 (clear sequence, minor gaps) rather than level 5, since the body has no explicit validation/recovery checkpoints of its own — those are delegated to the reference files — and the routing table mixes strategic routing with doc-link rows. | 4 / 5 |
Progressive Disclosure | The body is a lean overview that routes to 14 one-level-deep reference files and one script, all of which exist in the bundle (verified: every referenced `references/*.md` path and `scripts/msk_sizing.py` is present). Each table row signals intent clearly and points to a named section where relevant, matching the level-5 anchor of a clear overview with well-signaled, one-level-deep, easy-to-navigate references. | 5 / 5 |
Total | 17 / 20 Passed |