CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

roboflow-api-reference

Protocol-level facts for Roboflow REST and Inference APIs — URL patterns, auth, parameters, error codes, and SDK quick-start. For deployment strategy and Workflow execution patterns, see roboflow-inference.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 lean, highly actionable reference overview: dense fact tables, two executable SDK quick-starts, and an unambiguous host-selection routing table, with details correctly deferred to separate pages. The main gaps are minor: the unverifiable external resource references and one buried cross-reference keep progressive disclosure at 4, and a few low-information lines could be trimmed.

Suggestions

Surface the roboflow-inference workflows cross-reference in the 'Related Pages' section instead of burying it inside a Host Selection table row.

Either bundle the referenced pages (inference, rest-api, api-key-management) locally or note explicitly that they require the Roboflow MCP server, so navigation does not depend on an unavailable resource scheme.

Tighten low-information lines like 'Rate limits vary by plan' into concrete limits or remove them.

DimensionReasoningScore

Conciseness

The body is dense tables of Roboflow-specific facts Claude cannot know (hosts, auth methods, SDK matrix), with no padding explaining known concepts — matching 'efficient; minor instances of over-explanation that could be trimmed'. A 5 would require every token to earn its place, but 'Rate limits vary by plan' is low-information and the two leading blockquote notes are meta-guidance that could be tightened; still well above the noticeable padding of a 3.

4 / 5

Actionability

Fully executable guidance: 'pip install inference-sdk' with a copy-paste-ready InferenceHTTPClient quick-start, a complete roboflow SDK quick-start covering upload and predict, exact base URLs, and precise auth formats ('?api_key=YOUR_KEY', 'x-api-key: YOUR_KEY'). The Host Selection Guide maps each common task to a concrete host, matching the anchor for copy-paste-ready code covering common cases; nothing is pseudocode or vague.

5 / 5

Workflow Clarity

This is a single-purpose reference/lookup skill with no multi-step process, so per the simple-skill guidance workflow clarity can score 5 when the single action is unambiguous — and the Host Selection Guide table makes 'pick host → auth → call' unambiguous for every listed task. No destructive or batch operations exist, so the validation cap does not apply; a 4 would understate how decisively the routing table resolves the skill's one decision.

5 / 5

Progressive Disclosure

Good structure overall: an overview body with a clearly signaled 'Related Pages' section pointing to three one-level-deep resources (inference, rest-api, api-key-management) with per-page usage notes — matching anchor 4. It falls short of 5 because the references use the external 'roboflow://' MCP resource scheme rather than bundle files present in this skill (no references/ directory exists to verify them), and one cross-reference to roboflow-inference's workflows page is buried mid-row in the Host Selection table rather than surfaced in Related Pages.

4 / 5

Total

18

/

20

Passed

Description

70%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 distinctive, specific description with a concrete 'what', but no explicit 'when to use' trigger clause, which caps completeness. Adding a 'Use when...' clause with natural user phrasings (e.g., 'Use when making Roboflow API calls, uploading images, or running inference') would raise both completeness and trigger coverage.

Suggestions

Add an explicit trigger clause such as 'Use when making Roboflow REST or inference API calls, uploading images, or authenticating with Roboflow' to answer 'when should Claude use it'.

Include natural user-action terms like 'upload images', 'train a model', 'predict', and 'API key' to broaden trigger keyword coverage.

Mention SDK names users would say ('inference-sdk', 'roboflow Python package') so the description triggers on SDK-related questions too.

DimensionReasoningScore

Specificity

The description lists several concrete coverage areas — 'URL patterns, auth, parameters, error codes, and SDK quick-start' — for a named domain ('Roboflow REST and Inference APIs'), matching the anchor for several specific items with minor gaps. It falls short of a 5 because these are topic areas rather than a comprehensive list of concrete actions (e.g., upload, train, predict), and above a 3 because it goes well beyond 1-2 concrete actions.

4 / 5

Completeness

The 'what' is explicit and concrete ('Protocol-level facts for Roboflow REST and Inference APIs — URL patterns, auth, parameters, error codes, and SDK quick-start'), but there is no 'Use when...' clause or equivalent trigger guidance; the second sentence ('For deployment strategy and Workflow execution patterns, see roboflow-inference') is a redirect to a sibling skill, not a when-to-use trigger. Per the guideline, a missing explicit trigger clause caps completeness at 3; it is not lower because the 'what' is clear and the redirect weakly implies scope boundaries.

3 / 5

Trigger Term Quality

It includes natural, domain-relevant terms users would say — 'Roboflow', 'REST', 'Inference APIs', 'SDK', 'auth', 'error codes' — giving good keyword coverage. A few natural trigger phrases are missing (e.g., 'upload images', 'train a model', 'predict', 'API key'), so it does not reach the comprehensive-synonym coverage of a 5 but clearly exceeds the sparse keyword sets of a 3.

4 / 5

Distinctiveness Conflict Risk

'Roboflow REST and Inference APIs' carves a clear niche with distinct triggers, and explicitly delegating 'deployment strategy and Workflow execution patterns' to the roboflow-inference sibling skill actively reduces overlap risk. This matches the anchor for a clear niche with minimal conflict risk; nothing is generic enough to collide with unrelated skills.

5 / 5

Total

16

/

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

roboflow/computer-vision-skills

Path

skills/roboflow-api-reference/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.