Content
82%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.
The content is highly actionable — an executable curl template with complete auth/URL resolution, per-mode JSON examples, field defaults, and explicit error-code handling. Its only weaknesses are minor: a thrice-repeated provider-alias sentence, an inflated port list, and no post-call output verification.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and purposeful — resolution precedence, field defaults, and error codes with no filler or explanations of concepts Claude already knows. It falls short of anchor 5 because the sentence "If `provider`, `provider_name`, or `custom_provider` is present, the server calls the requested provider's base URL instead" is repeated verbatim in all three mode sections and could be consolidated, plus the four-entry "Common local ports" list could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready: a complete curl template with working shell logic for token and base-URL resolution, concrete JSON payloads for all three modes, a full request-field table with defaults, a sample success response, and named error codes with the exact user-facing remediation ("tell the user to configure `fun-codex`..."). Specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | The prerequisite chain is unambiguous: explicitly ordered numbered lists for base-URL resolution (HERMES_WEB_UI_URL, then PORT, then 8648), token resolution (four-step fallback), and profile selection, plus a hard checkpoint — "If the Hermes Web UI endpoint returns 401, 403, connection failure, or any other error, stop and report". It is below anchor 5 only because there is no post-call validation (e.g. verifying the output file exists or handling unlisted error payloads), which keeps it at anchor 4's "most checkpoints present". | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the body references no external files, so references are trivially one level deep with no nesting risk. Sections (Modes, Request Fields, Curl Template) are well-organized and easy to navigate; at ~215 lines with the port table and two provider config examples inlined it is not anchor 5's ideal split, but most content is appropriately placed in SKILL.md, matching anchor 4. | 4 / 5 |
Total | 17 / 20 Passed |