CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sirv-api

Sirv REST API integration for image and file management. Use when working with Sirv CDN, uploading/downloading files to Sirv, managing image metadata, searching files, creating 360 spins, converting videos, or any Sirv API operations. Covers authentication, file operations, metadata, search queries, async jobs, and account management.

75

Quality

94%

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

92%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 skill: executable examples, a documented-first debugging workflow with explicit validation and verification steps, and clean one-level-deep progressive disclosure. The only improvement area is minor duplication between the inline Quick Reference tables and the reference bundle files.

Suggestions

Trim the inline File Operations and Metadata Operations tables to only the most-used endpoints (or method + path only), leaving full parameter detail to references/files.md and references/metadata.md to remove duplication.

DimensionReasoningScore

Conciseness

The body is lean: quick-reference tables, operational rules, red flags, and verification checks with no explanation of concepts Claude already knows. It falls short of the 5 anchor only because the File/Metadata Operations tables partially duplicate endpoint detail that also lives in references/files.md and references/metadata.md, so a few tokens could be trimmed.

4 / 5

Actionability

Everything is executable: complete curl for token acquisition, JavaScript examples for upload, search (including path escaping), and async ZIP creation with polling; endpoint tables give exact methods, paths, and query params. Covers the common cases copy-paste ready.

5 / 5

Workflow Clarity

The Debugging Workflow is a clear 6-step sequence with explicit checkpoints ('Compare the request shape against the official docs before patching code', 'Separate auth/token failures from Sirv payload/query failures') and a feedback loop ('Add a focused regression test'). Destructive/batch operations are backed by validation: check '/v2/account/limits' before bulk jobs and the Verification checklist (verify with stat/meta/readdir/search, re-run integration tests).

5 / 5

Progressive Disclosure

The 'When to Read Reference Files' section cleanly signals four topic-bundled references (files.md, metadata.md, jobs.md, account.md), all of which exist as real files one level deep, while the body keeps only an overview and quick reference.

5 / 5

Total

19

/

20

Passed

Description

92%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 strong description: third-person, specific, and comprehensive, with an explicit 'Use when...' clause covering the full range of Sirv operations. The only minor gap is the absence of additional synonyms or extensions, which matters little for a named-API skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('uploading/downloading files to Sirv, managing image metadata, searching files, creating 360 spins, converting videos') and enumerates coverage areas ('authentication, file operations, metadata, search queries, async jobs, and account management'), matching the comprehensive multi-action anchor. It is written in third person with no vague filler.

5 / 5

Completeness

It clearly answers both what ('Sirv REST API integration for image and file management') and when ('Use when working with Sirv CDN, uploading/downloading files to Sirv, ... or any Sirv API operations') with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'Sirv CDN', 'uploading/downloading files', 'searching files', and 'converting videos' are present and match what a user would say. It lacks synonyms or file-extension variants of the kind in the 5 anchor, though for a named commercial API the natural vocabulary is largely 'Sirv' itself, keeping it above the 3 anchor.

4 / 5

Distinctiveness Conflict Risk

'Sirv' is a distinct named product niche with dedicated trigger terms (Sirv CDN, 360 spins, Sirv API operations), so the risk of firing for the wrong skill is minimal.

5 / 5

Total

19

/

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

IgorVaryvoda/image-optimization-skill

Path

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