CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

baoyu-compress-image

Compresses images to WebP (default) or PNG with automatic tool selection. Use when user asks to "compress image", "optimize image", "convert to webp", or reduce image file size.

Quality

84%

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

87%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 an exemplar of lean, executable skill documentation: dense tables, verified copy-paste commands, and a well-organized single-script bundle with real progressive disclosure. The single material weakness is the absence of any validation/verification step for what is a destructive-by-default, batch-capable operation, which caps workflow clarity.

Suggestions

Add a verification checkpoint to the workflow, e.g., 'After compression, confirm the output file exists and is non-empty before the original is removed; on failure keep the original and report the error' — this is required since the default behavior replaces originals and -r enables batch processing.

Document error-recovery guidance for the tool auto-selection order (sips → cwebp → ImageMagick → Sharp): what to do when a tool fails mid-batch, and how to report partial success with --json output.

DimensionReasoningScore

Conciseness

The body is ~50 lines of dense tables and command examples with zero concept explanation — no 'what WebP is', no library introductions, no padded prose. Even the {baseDir}/${BUN_X} resolution is compressed into a single line. Matches anchor 5 ('every token earns its place'); there is no unnecessary explanation to trim, so anchor 4's 'minor instances of over-explanation' does not apply.

5 / 5

Actionability

Quotes: "${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep" — copy-paste-ready commands with concrete examples covering the common cases (single file, keep original, recursive directory), plus an options table and a sample output line. All documented flags (--output, --format, --quality, --keep, --recursive, --json) were verified to exist in scripts/main.ts. Fully executable, matching anchor 5.

5 / 5

Workflow Clarity

Usage and options are sequenced clearly, but this skill replaces the original file by default and supports recursive batch processing over directories, and the body contains no validation or verification step (no check that output is valid/existing before the original is removed, no error-recovery guidance). The rubric's judging guideline explicitly caps batch/destructive skills without validation at 3, overriding the simple-skill exception that would otherwise apply.

3 / 5

Progressive Disclosure

The skill is under 50 lines with a single bundle script (scripts/main.ts, verified to exist) referenced one level deep in a table, and sections are clearly organized (Script Directory, Preferences, Usage, Options, Extension Support). Per the rubric's simple-skill guideline, this earns a 5; the mild redundancy of the 'Extension Support' section pointing back to 'Preferences' is negligible.

5 / 5

Total

18

/

20

Passed

Description

78%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 is well-constructed: it explicitly answers both what the skill does and when to use it, with natural quoted trigger phrases. Main gaps are modest specificity (capabilities like jpeg output, quality control, and batch/directory processing are undocumented in the description) and a few missing synonyms/file extensions in the trigger list.

Suggestions

Add one or two more concrete capabilities to the description, e.g., quality control, batch/directory processing, or JPEG output, to lift specificity toward comprehensive coverage.

Include common trigger synonyms and extensions such as '.webp', 'shrink image size', or 'make images smaller' to round out trigger-term coverage.

DimensionReasoningScore

Specificity

Quotes: "Compresses images to WebP (default) or PNG with automatic tool selection" — names the domain and 1-2 concrete actions (format conversion, tool auto-selection) but omits documented capabilities like jpeg output, quality control, and directory processing. Anchor 3 fits best: anchor 4 requires 'several specific actions' while this is essentially one action plus a mechanism; anchor 2 is too low since the actions are concrete, not generic.

3 / 5

Completeness

Quotes: "Compresses images to WebP (default) or PNG..." (clear what) and "Use when user asks to..." (explicit when with concrete trigger phrases). Matches anchor 5's structure precisely — both what and when are explicit and concrete; anchor 4 requires the 'when' to be less specific than it is here.

5 / 5

Trigger Term Quality

Quotes: "'compress image', 'optimize image', 'convert to webp', or reduce image file size" — four natural phrases a user would actually say, plus format keywords. Between anchor 4 and 5: good coverage but a few natural terms/extensions are missing (e.g., ".webp", "shrink image", "make image smaller"), which is exactly the anchor 4 condition.

4 / 5

Distinctiveness Conflict Risk

Quotes: "Compresses images to WebP (default) or PNG" and "'convert to webp', or reduce image file size" — a clear image-compression niche with distinct triggers. Not a 5 because PNG is mentioned as an output format, giving minor overlap risk with a generic image-format-conversion skill; clearly above anchor 3's 'could still overlap with similar skills'.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

JimLiu/baoyu-skills

Path

skills/baoyu-compress-image/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.