CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

omni-inference

The core OpenAI-compatible inference endpoints: chat completions, embeddings, images, audio (TTS/STT), moderations, rerank, and the Responses API. The primary integration surface for AI agents.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/omni-inference/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured API reference skill: every covered modality gets executable curl examples, model-discovery commands, and actionable error recovery, backed by a verified one-level-deep reference file. The main weaknesses are the ~130-line endpoint link list that re-inlines the reference's table of contents and an authentication flow that is referenced but never made executable.

Suggestions

Replace the 128-item flat endpoint list in SKILL.md with a short category summary (chat, embeddings, images, audio, moderation, rerank, management, etc.) pointing to references/endpoints.md, since that file already contains the full linked table of contents.

Add an executable auth example (curl POST /api/auth/login with body and response) and include the Authorization header in the /v1/models discover commands, which currently would fail per the skill's own Authentication section.

Add brief response-validation guidance for streaming requests (e.g. check the first SSE chunk for an error status before consuming the stream) to give the common chat-completions flow an explicit checkpoint.

DimensionReasoningScore

Conciseness

The per-modality curl examples are lean with no concept-teaching padding, but the 128-bullet endpoint list ('POST /api/v1/session-leases' through 'POST /api/v1/web/fetch') duplicates the table of contents already present in references/endpoints.md, adding substantial token cost with little navigational gain. It is mostly efficient with one clearly unnecessary bulk section, matching anchor 3 rather than anchor 2's 'several unnecessary explanations'.

3 / 5

Actionability

Concrete copy-paste curl commands with headers, JSON bodies, sample responses, and per-endpoint error remedies ('429 rate_limited → honor Retry-After') cover the common cases across chat, images, TTS, STT, embeddings, and web search/fetch. Minor gaps keep it below anchor 5: 'POST /api/auth/login' is named but never shown as an executable example, and the discover commands (e.g. 'curl $OMNIROUTE_URL/v1/models | jq') omit the Authorization header the Authentication section says all requests require.

4 / 5

Workflow Clarity

Each modality follows a clear, repeatable sequence (setup env vars → discover models → example → errors), and the Errors subsections provide recovery guidance such as '503 circuit_open → retry later or use combo'. It falls short of anchor 5 because there are no explicit validate-then-retry checkpoints, and the initial auth/setup flow ('Obtain a token via POST /api/auth/login') is left as a pointer rather than spelled-out steps.

4 / 5

Progressive Disclosure

The body links to a single one-level-deep reference (references/endpoints.md) with clearly signaled inline links, and all 128 anchors resolve to real section headers in that file. The gap versus anchor 5 is the redundant flat endpoint index in SKILL.md that duplicates the reference file's own table of contents instead of a concise category-level overview.

4 / 5

Total

15

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, keyword-rich description that clearly states what the skill covers across seven inference modalities with good natural trigger terms. Its main weakness is the missing 'when to use' guidance: the use case ('The primary integration surface for AI agents') is implied but never expressed as an explicit trigger clause, capping completeness.

Suggestions

Append an explicit trigger clause, e.g. 'Use when integrating AI agents with this API for chat, embeddings, image generation, speech, moderation, or rerank requests.'

Spell out common synonyms users would say — 'text-to-speech', 'speech-to-text/transcription', 'generate images' — alongside the TTS/STT abbreviations.

Add a distinguishing qualifier (e.g. the product name 'OmniRoute') to reduce overlap risk with generic OpenAI-API skills.

DimensionReasoningScore

Specificity

The description enumerates seven concrete capability families ('chat completions, embeddings, images, audio (TTS/STT), moderations, rerank, and the Responses API'), matching anchor 4's several specific actions with minor gaps. It is below anchor 5 because it lists API surface names rather than comprehensive concrete actions (e.g. it never says what one does with images or audio beyond naming them).

4 / 5

Completeness

The 'what' is clearly answered (the enumerated inference endpoint families), but there is no 'Use when...' clause or equivalent explicit trigger; 'The primary integration surface for AI agents' only weakly implies when to use it, so completeness is capped at 3 per the judging guidelines. It is not a 4 because the activation context is left entirely implicit.

3 / 5

Trigger Term Quality

It includes natural terms users would say ('chat completions', 'embeddings', 'images', 'TTS/STT', 'rerank', 'Responses API'), giving good keyword coverage per anchor 4. It misses common variations like 'transcription', 'speech-to-text'/'text-to-speech' spelled out, and 'generate images', which anchor 5's comprehensive synonym coverage would require.

4 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — an OpenAI-compatible multi-modal inference gateway — with specific endpoint families that would not trigger for unrelated skills, matching anchor 4's mostly-distinct profile. Minor overlap risk remains with generic 'OpenAI API' or provider-specific integration skills since no project-specific qualifier (e.g. OmniRoute) appears in the description.

4 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

diegosouzapw/OmniRoute

Path

skills/omni-inference/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.