Content
92%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 triage skill body: symptom-to-action routing tables, concrete escalation criteria with validation gates, and a pre-ticket checklist, all with detail correctly delegated to sibling skills. The only flaw is two redundant intro sentences under the escalation subheadings that restate their headings.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, table-driven routing content with zero explanation of concepts Claude already knows — every section is actionable triage data. Two intro lines ("These issues can be resolved without escalating to the gateway team:" and "These issues require gateway team involvement:") merely restate their headings and could be trimmed, matching anchor 4's 'minor instances that could be trimmed' rather than anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | Fully concrete instruction-only guidance: the symptom table pairs each symptom with a specific first check ("spec.address binding", "Listen address (0.0.0.0 vs localhost)", "PolicyBinding → ApiInstance cross-reference") and an exact skill to invoke; escalation criteria are precise ("crash loop, OOMKill", "reproducible after configuration is confirmed valid"); the checklist names concrete artifacts ("flexctl version output", platform list). Per the scoring notes, absence of code is not penalized when guidance is this actionable, and the common cases are all covered. | 5 / 5 |
Workflow Clarity | The diagnostic workflow is clearly sequenced — triage by symptom table, dispatch by available artifact, then escalation decision, then package checklist — with explicit validation gates: escalation is gated on "configuration is confirmed valid by omni-gateway-config", dump analysis is required "before escalating", and the ticket checklist is an explicit pre-flight list. The "Known-good config still failing → live deployed state" row provides an error-recovery path, matching anchor 5's 'checklists + validation steps + feedback loops'. | 5 / 5 |
Progressive Disclosure | The body is a short, well-sectioned overview that delegates all detail via clearly signaled one-level references to sibling skills (omni-gateway-logs, omni-gateway-config, omni-gateway-dump, omni-gateway-install), each referenced with its purpose restated in 'Related Jobs'. No content that belongs in a separate file is inlined, and navigation is trivial — with no bundle files needed, this matches the simple-skill exception for a top score. | 5 / 5 |
Total | 19 / 20 Passed |