Content
60%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 body delivers strong, executable API guidance with a consistent discover-example-errors structure and well-verified one-level-deep references. Its main weakness is token efficiency: a duplicated endpoint index, repeated auth boilerplate, and two conflicting authentication stories inflate the skill without adding capability.
Suggestions
Replace the ~140-line inline endpoint list with a short pointer to references/endpoints.md (which already contains the same table of contents with anchors), keeping only the handful of core inference endpoints inline.
State the OMNIROUTE_URL/OMNIROUTE_KEY setup once in the Authentication section and drop the seven repeated "Requires... See entry-point SKILL" lines, resolving the conflict with the Bearer-token/login instructions.
Add the Authorization header to the "Discover" curl examples so they are executable given the stated requirement that all requests carry a valid Bearer token.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~140-item endpoint list duplicates the table of contents already present in references/endpoints.md, the Overview repeats the frontmatter description verbatim, and the line "Requires `OMNIROUTE_URL` and `OMNIROUTE_KEY`. See entry-point SKILL..." is repeated seven times across sections. The core capability sections are lean, so this is noticeably verbose rather than severely padded. | 2 / 5 |
Actionability | Concrete, copy-paste-ready curl examples with headers, JSON bodies, response shapes, and error codes with remediation cover chat, images, TTS, STT, embeddings, web search, and web fetch. Minor gap: every "Discover" curl (e.g. `curl $OMNIROUTE_URL/v1/models | jq '.data[].id'`) omits the Authorization header that the Authentication section says all requests require, so those commands would fail as written. | 4 / 5 |
Workflow Clarity | Each capability follows a clear, consistent sequence (setup requirement, endpoints, discover, example, errors) with error-recovery guidance such as "honor `Retry-After`" and "check `/v1/models`". Auth setup is deferred to an external GitHub URL rather than stated as an explicit first step, which leaves minor sequencing gaps. | 4 / 5 |
Progressive Disclosure | All endpoint links resolve to real anchors in the bundled references/endpoints.md (verified: one level deep, clearly signaled, with per-endpoint detail properly offloaded). The inline 140-link list duplicates the reference file's own table of contents, and the external pointers (GitHub auth skill, OpenAPI spec) are not part of the bundle — minor organization gaps. | 4 / 5 |
Total | 14 / 20 Passed |