Name: shortpixel
Rating: 53.6 (1 reviews)
Author: membranedev

shortpixel

ShortPixel integration. Manage data, records, and automate workflows. Use when the user wants to interact with ShortPixel data.

Quality

60%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/shortpixel/SKILL.md

Quality

Content

71%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.

The body is highly actionable with executable CLI commands and a well-sequenced connection workflow including validation feedback loops. Its weaknesses are mild verbosity in the intro, a dangling Step 2 reference, and content that could be split into reference files.

Suggestions

Trim the opening explanatory paragraph ("ShortPixel is an image optimization and compression service...") and the vague "When to use which actions" line to what Claude does not already know.

Define the referenced "Step 2" or relabel the sections so the "Skip to Step 2" pointer resolves to an actual step.

Move the proxy flags table and detailed request options into a references file (e.g. REQUESTS.md) and link to it from the body to improve progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient command-based guidance, but it includes explanation Claude does not need ("ShortPixel is an image optimization and compression service... improving website loading speed and SEO") and vague filler ("When to use which actions: Use action names and parameters as needed"), matching the mostly-efficient-but-tightenable score-3 anchor.	3 / 5
Actionability	It provides copy-paste-ready, executable commands throughout — install, login, connection ensure/get, action list/run, and a proxy flag table — covering the common cases, matching the fully-executable score-5 anchor.	5 / 5
Workflow Clarity	The connection flow is clearly sequenced with state-based polling and feedback loops (poll again after a client action), but the "Skip to Step 2" reference points to an undefined Step 2 and the transition into action search is loose, placing it at score 4 rather than the fully-checkpointed score 5.	4 / 5
Progressive Disclosure	No bundle files exist and the single SKILL.md is sectioned, but a ~140-line body inlines an API flag table and proxy reference that read as material belonging in a separate reference file, matching the some-structure-but-inline score-3 anchor rather than the well-split score 4.	3 / 5
	Total	15 / 20 Passed

Description

50%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.

The description correctly identifies the ShortPixel niche and includes a Use-when trigger, but its action vocabulary is generic and its trigger phrasing lacks the natural terms a user would actually say. It is adequate for activation but not exemplary.

Suggestions

Replace generic verbs with concrete ShortPixel actions, e.g. "Compress and optimize images, reduce file sizes, and convert formats via ShortPixel."

Add natural user trigger phrases such as "Use when the user wants to optimize images, compress images, or reduce image file sizes for faster page loads."

Include synonyms/file extensions users mention (e.g. JPG, PNG, WebP) to improve trigger-term coverage.

Dimension	Reasoning	Score
Specificity	It names the domain ("ShortPixel integration") but the actions — "Manage data, records, and automate workflows" — are minimal and generic, matching the score-2 anchor of naming the domain with only generic actions rather than the concrete actions of score 3.	2 / 5
Completeness	Both a "what" ("Manage data, records, and automate workflows") and an explicit "Use when the user wants to interact with ShortPixel data" trigger are present, but the "when" is generic and could be more specific, matching the score-4 anchor rather than the fully concrete score 5.	4 / 5
Trigger Term Quality	Only "ShortPixel" and "interact with ShortPixel data" serve as triggers; these are one or two generic keywords missing the natural phrases users say (e.g. image compression, optimize images), so it sits at score 2 rather than 3.	2 / 5
Distinctiveness Conflict Risk	Naming a specific service ("ShortPixel") gives it a clear niche with low conflict risk, but the generic action verbs leave minor overlap with other data-management skills, placing it at score 4 rather than the sharply-distinct score 5.	4 / 5
	Total	12 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: membranedev/application-skills
Path: skills/shortpixel/SKILL.md
Commit: f484c82

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.